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

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

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

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

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

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

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

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

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

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

  1. Looker IDE で、IDE のナビゲーション バーにある [継続的インテグレーション] アイコンをクリックします。
  2. [スイート] をクリックして [スイート] ページを開きます。
  3. 実行する CI スイートの [Run suite] ボタンをクリックします（プロジェクトに 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 Changes & Push] ボタンをクリックするか、IDE の [Git Actions パネル] から [Commit] オプションを選択する必要があります。

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

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

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

また、初回実行後に CI スイートを編集した場合、再実行では初回実行後に CI スイートに加えた変更が反映されます。

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

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

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

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

CI 実行のキャンセル

実行中の CI 実行をキャンセルするには、[実行] ページで次の手順を行います。

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

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