継続的インテグレーション（CI）の実行は、いくつかの方法でトリガーできます。
- Looker デベロッパーが LookML プロジェクトのリポジトリに pull リクエストを送信すると、自動的に実行されます（設定方法については、継続的インテグレーション スイートの作成ページをご覧ください）。
- インポートされた LookML プロジェクトに pull リクエストが送信されると、自動的に実行されます（設定方法については、継続的インテグレーション スイートの作成ページをご覧ください）。
- dbt Cloud CI ジョブが完了したときに自動的に（設定方法については、継続的インテグレーション スイートの作成ページをご覧ください）。
- 自動: 繰り返しスケジュールに基づいて自動的に実行されます（設定方法については、継続的インテグレーション スイートの作成ページをご覧ください）。
- Looker IDE から CI スイートの新しい実行を手動でトリガーする。
- Looker IDE から以前の CI 実行を手動で再実行する。
検証テストが完了したら、継続的インテグレーションの実行結果の表示ドキュメント ページの説明に沿って結果を確認できます。
pull リクエストからの自動トリガー
Looker からの pull リクエストでトリガーするを使用して CI スイートを有効にしている場合、Looker デベロッパーが LookML リポジトリに pull リクエストを送信すると、CI は検証実行を自動的にトリガーします。（必要に応じて、リポジトリ内の特定のブランチへの pull リクエストのみが自動 CI 実行をトリガーするように指定できます）。
自動 pull リクエスト検証の実行では、CI は最新の pull リクエスト commit を検証し、そのバージョンのリポジトリ内のすべてのエラーを返します。
結果の表示については、継続的インテグレーションの実行結果の表示のドキュメント ページをご覧ください。
インポートされたプロジェクトの pull リクエストからの自動トリガー
インポートされたプロジェクトからの pull リクエストをトリガーするを使用して、ダウンストリーム（スポーク）プロジェクトで CI スイートを有効にしている場合、デベロッパーがサブスクライブされたアップストリーム（ハブ）プロジェクトのリポジトリで pull リクエストを開くか更新すると、CI はスポーク プロジェクトで検証実行を自動的にトリガーします。
インポートされたプロジェクトの pull リクエストによってトリガーされた CI の実行中に、Looker は次のアクションを実行します。
- インポートされたハブ プロジェクトを pull リクエストの commit に一時的に固定しながら、スポーク プロジェクトの製品版を検証します。
- スポーク プロジェクトの CI 実行の結果を、ハブ プロジェクトのリポジトリの pull リクエストに書き戻します。
結果の表示については、継続的インテグレーションの実行結果の表示のドキュメント ページをご覧ください。
dbt Cloud からの自動トリガー
dbt Cloud からの pull リクエストでトリガーするを使用して CI スイートを有効にしている場合、指定された dbt Cloud CI ジョブが完了すると、CI は検証実行を自動的にトリガーします。
dbt Cloud CI ジョブによってトリガーされる CI 実行は、dbt で行われたスキーマ変更によって LookML コンテンツが破損するかどうかを確認するように設計されています。実行中、Looker は次のアクションを実行します。
- ジョブの完了時に dbt Cloud から通知を受け取ります。
- dbt Cloud によって作成された一時スキーマの詳細を、その特定の実行用に抽出します。
- 構成済みのユーザー属性（接続のスキーマ属性など）を、この一時スキーマの名前にオーバーライドします。
- この一時スキーマに対して CI バリデータを実行します。
これにより、dbt の変更が本番環境にマージされる前に、互換性を破る変更（列の削除やテーブルの名前変更など）を検出できます。実行が完了すると、ユーザー属性値は CI ユーザーの標準値に戻ります。
スケジュールに基づく自動トリガー
CI スイートで [スケジュールに従ってトリガー] を有効にしている場合、CI は指定したスケジュールに従って検証実行を自動的にトリガーします。
自動スケジュール検証の実行では、CI はリポジトリの製品版を検証し、そのバージョン内のすべてのエラーを返します。
結果の表示については、継続的インテグレーションの実行結果の表示のドキュメント ページをご覧ください。
CI スイートの新しい実行を手動でトリガーする
see_ci 権限を持つ Looker ユーザーは、Looker IDE から CI 実行を手動でトリガーできます。
CI スイートの新しい実行を手動でトリガーする手順は次のとおりです。
- Looker IDE で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [Suites] をクリックして [Suites] ページを開きます。
- 実行する CI スイートの [Run suite] ボタンをクリックします（プロジェクトに CI スイートがない場合は、CI スイートを作成できます）。
[Trigger a run manually] ダイアログで、[Workspace] オプションを使用して、検証するブランチを選択します（詳細については、Workspace セクションをご覧ください）。
- LookML プロジェクトの製品版を検証するには、[Production] をクリックします。
- LookML プロジェクトの開発ブランチを検証する場合は、[開発モード] をクリックします。[ブランチ] プルダウン メニューを使用して、検証する開発ブランチを選択します。
CI スイートの実行をトリガーするには、[実行を開始] をクリックします。
CI スイートの実行が完了するまでに数分かかることがあります。これは、プロジェクトのサイズ、CI スイートに含まれるバリデータ、CI スイートの構成によって異なります。
実行をトリガーすると、Looker IDE に、トリガーしたスイートの [実行] ページが表示されます。検証テストが完了すると、[実行] ページに各バリデータの検証結果が表示されます。検証テストの実行中に [実行] ページから移動し、後で [実行] ページに戻って結果を確認できます。
結果の表示については、継続的インテグレーションの実行結果の表示のドキュメント ページをご覧ください。
ワークスペース
CI 実行を手動でトリガーする場合は、[Workspace] オプションを使用して、リポジトリの製品版またはリポジトリの開発ブランチを検証できます。
[本番環境] オプションで、製品版に使用されているブランチまたは commit を特定する場合は、Looker IDE の [プロジェクト設定] の [ブランチ管理] ページの [Git の概要] セクションにある [デフォルトの本番環境ブランチ] フィールドを確認します。
- 高度なデプロイモードで構成されたプロジェクトの場合、製品版は、
deploy権限を持つ Looker デベロッパーが Deployment Manager で選択した commit またはタグです。 - 高度なデプロイモードを使用しないプロジェクトの場合、製品版は、[プロジェクト設定] の [プロジェクト構成] ページの [Git 本番環境のブランチ名] フィールドで構成されたブランチです。
[開発モード] オプションでは、プロジェクトの開発ブランチを検証する際に次の点に注意してください。
- LookML プロジェクトのブランチを確認し、本番環境ブランチとデベロッパーの個人ブランチを特定するには、Looker IDE のプロジェクトの [プロジェクト設定] の [ブランチ管理] ページをご覧ください。
- 開発ブランチを検証するには、開発ブランチを LookML リポジトリに push する必要があります。Looker IDE では、デベロッパーは [Commit Changes & Push] ボタンをクリックするか、IDE の Git Actions パネルから [Commit] オプションを選択する必要があります。
以前の CI 実行を手動で再実行する
完了した実行（実行が成功、失敗、エラー、キャンセルされた場合）については、see_ci 権限を持つ Looker ユーザーが Looker IDE から CI 実行の再実行を手動でトリガーできます。
- PR トリガーによる実行（プロジェクトのリポジトリまたはインポートされたプロジェクトの pull リクエストによってトリガーされる）を再実行すると、継続的インテグレーションは元の実行と同じ commit に対して実行されます。
- 手動でトリガーされた実行を再実行すると、継続的インテグレーションは再実行時の本番環境の状態またはブランチ HEAD に対して実行されます。これには、最初の CI 実行以降に行われた後続の commit が含まれます。
また、最初の実行以降に CI スイートを編集した場合は、再実行に最初の実行以降に CI スイートに加えた変更が含まれます。
CI 実行を再実行する手順は次のとおりです。
- Looker IDE で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [実行] をクリックして [実行] ページを開きます。
- [Runs] ページで、キャンセルする CI 実行の [View Run] ボタンをクリックします。
- 選択した実行の実行結果ページで、ページ上部の [再実行] ボタンをクリックします。
[再実行] をクリックすると、Content Validator が実行を開始し、新しい実行の [実行] ページに戻ります。
結果の表示については、継続的インテグレーションの実行結果の表示のドキュメント ページをご覧ください。
CI 実行のキャンセル
実行中の CI 実行をキャンセルする場合は、次の手順に沿って [実行] ページからキャンセルできます。
- Looker IDE で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [実行] をクリックして [実行] ページを開きます。
- [Runs] ページで、キャンセルする CI 実行の [View Run] ボタンをクリックします。
- 選択した実行の [実行] ページで、ページ上部の [キャンセル] ボタンをクリックします。
[キャンセル] をクリックすると、継続的インテグレーションによって実行がキャンセルされ、[実行] ページに [キャンセル済み] ステータスが表示されます。