継続的インテグレーション スイートの実行

継続的インテグレーション（CI）の実行は、次の方法でトリガーできます。

検証テストが完了したら、継続的インテグレーションの実行結果を表示するのドキュメント ページの説明に沿って結果を確認できます。

pull リクエストからの自動トリガー

CI スイートで [Looker からの pull リクエストでトリガーする] を有効にすると、Looker デベロッパーが LookML リポジトリに pull リクエストを送信したときに、CI が検証実行を自動的にトリガーします（必要に応じて、リポジトリ内の特定のブランチへの pull リクエストのみが自動 CI 実行をトリガーするように指定できます）。

pull リクエストの自動検証実行の場合、CI は最新の pull リクエスト commit を検証し、そのバージョンのリポジトリ内のすべてのエラーを返します。

結果の表示方法については、継続的インテグレーションの実行結果を表示するのドキュメント ページをご覧ください。

dbt Cloud からの自動トリガー

CI スイートで [**dbt Cloud からの pull リクエストでトリガーする**] を有効にすると、指定した dbt Cloud CI ジョブが完了したときに、CI が検証実行を自動的にトリガーします。

dbt Cloud CI ジョブによってトリガーされる CI 実行は、dbt で行われたスキーマ変更が LookML コンテンツを破損させるかどうかを確認するように設計されています。実行中、Looker は次のアクションを実行します。

  1. ジョブの完了時に dbt Cloud から通知を受け取ります。
  2. その特定の実行のために dbt Cloud によって作成された一時スキーマの詳細を抽出します。
  3. 構成されたユーザー属性（接続のスキーマ属性など）をこの一時スキーマの名前にオーバーライドします。
  4. この一時スキーマに対して CI バリデータを実行します。

これにより、dbt の変更が本番環境にマージされる前に、破壊的な変更（削除された列や名前が変更されたテーブルなど）を検出できます。実行が完了すると、ユーザー属性値は CI ユーザーの標準値に戻ります。

スケジュールに基づく自動トリガー

CI スイートで [**スケジュールでトリガーする**] を有効にすると、指定したスケジュールで CI が検証実行を自動的にトリガーします。

スケジュールに基づく自動検証実行の場合、CI はリポジトリの本番環境バージョンを検証し、そのバージョンのすべてのエラーを返します。

結果の表示方法については、継続的インテグレーションの実行結果を表示するのドキュメント ページをご覧ください。

CI スイートの新しい実行を手動でトリガーする

see_ci 権限を持つ Looker ユーザーは、Looker IDE から CI 実行を手動でトリガーできます。

CI スイートの新しい実行を手動でトリガーする手順は次のとおりです。

  1. [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
  2. [スイート] をクリックして [スイート] ページを開きます。
  3. 実行する CI スイートの [スイートを実行] ボタンをクリックします（プロジェクトに CI スイートがない場合は、CI スイートを作成できます）。

  4. [実行を手動でトリガー] ダイアログで、[ワークスペース] オプションを使用して、検証するブランチを選択します（詳細については、ワークスペースのセクションをご覧ください）。

    • LookML プロジェクトの本番環境バージョンを検証するには、[本番環境] をクリックします。
    • LookML プロジェクトの開発ブランチを検証する場合は、[Dev Mode] をクリックします。[ブランチ] プルダウン メニューを使用して、検証する開発ブランチを選択します。

  5. CI スイートの実行をトリガーするには、[実行を開始] をクリックします。

CI スイートの実行が完了するまでに数分かかることがあります。これは、プロジェクトのサイズ、CI スイートに含まれるバリデータ、CI スイートの構成によって異なります。

実行をトリガーすると、Looker IDE に、トリガーしたスイートの [実行] ページが表示されます。検証テストが完了すると、[実行] ページに各バリデータの結果が表示されます。検証テストの実行中に [実行] ページから移動し、後で [実行] ページに戻って結果を確認できます。

結果の表示方法については、継続的インテグレーションの実行結果を表示するのドキュメント ページをご覧ください。

ワークスペース

CI 実行を手動でトリガーする場合は、[ワークスペース] オプションを使用して、リポジトリの本番環境バージョンまたはリポジトリの開発ブランチを検証できます。

[本番環境] オプションの場合、本番環境バージョンに使用するブランチまたは commit を特定するには、Looker IDE の [プロジェクト設定] の [ブランチ管理] ページの [Git の概要] セクションにある [デフォルトの本番環境ブランチ] フィールドを確認します。

  • 高度なデプロイモードで構成されたプロジェクトの場合、本番環境バージョンは、deploy 権限を持つ Looker デベロッパーが Deployment Manager で選択した commit またはタグです。
  • 高度なデプロイモードを使用しないプロジェクトの場合、本番環境バージョンは、[プロジェクト設定] の [プロジェクト構成] ページの [Git 本番環境のブランチ名] フィールドで構成されたブランチです。

[Dev Mode] オプションの場合、プロジェクトの開発ブランチを検証する際は、次の点に注意してください。

  • LookML プロジェクトのブランチを表示し、本番環境ブランチとデベロッパーの個人ブランチを特定するには、Looker IDE でプロジェクトの [プロジェクト設定] の [ブランチ管理] ページを参照してください。
  • 開発ブランチを検証するには、開発ブランチを LookML リポジトリに push する必要があります。Looker IDE では、デベロッパーが [**変更を commit して push**] ボタンをクリックするか、IDE の [Git アクション] パネルから [**Commit**] オプションを選択する必要があります。

以前の CI 実行を手動で再実行する

完了した実行（実行が成功、失敗、エラー、キャンセルされた場合）の場合、see_ci 権限を持つ Looker ユーザーは、Looker IDE から CI 実行の再実行を手動でトリガーできます。

  • PR トリガーの実行を再実行すると、継続的インテグレーションは元の実行と同じ commit に対して実行されます。
  • 手動でトリガーされた実行を再実行すると、継続的インテグレーションは、再実行時の本番環境の状態またはブランチ HEADに対して実行されます。これには、最初の CI 実行以降に行われた後続の commit が含まれます。

また、最初の実行以降に CI スイートを編集した場合、再実行には最初の実行以降に CI スイートに加えた変更が含まれます。

CI 実行を再実行する手順は次のとおりです。

  1. [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
  2. [実行] をクリックして [実行] ページを開きます。
  3. [実行] ページで、キャンセルする CI 実行の [実行を表示] ボタンをクリックします。
  4. 選択した実行の実行結果ページで、ページ上部の [再実行] ボタンをクリックします。

[**再実行**] をクリックすると、Content Validator が実行を開始し、新しい実行の [**実行**] ページに戻ります。

結果の表示方法については、継続的インテグレーションの実行結果を表示するのドキュメント ページをご覧ください。

CI 実行をキャンセルする

実行中の CI 実行をキャンセルする場合は、次の手順で [実行] ページからキャンセルできます。

  1. [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
  2. [実行] をクリックして [実行] ページを開きます。
  3. [実行] ページで、キャンセルする CI 実行の [実行を表示] ボタンをクリックします。
  4. 選択した実行の [実行] ページで、ページ上部の [キャンセル] ボタンをクリックします。

[キャンセル] をクリックすると、継続的インテグレーションが実行をキャンセルし、[実行] ページに [キャンセル済み] ステータスが表示されます。