継続的インテグレーション(CI)の実行は、次の方法でトリガーできます。
- Looker デベロッパーが LookML プロジェクトのリポジトリに pull リクエストを送信したときに自動的に実行されます(設定方法については、継続的インテグレーション スイートを作成するをご覧ください)。
- Looker IDE から CI スイートの新しい実行を手動でトリガーします。
- Looker IDE から以前の CI 実行を手動で再実行します。
検証テストが完了したら、継続的インテグレーションの実行結果を表示するのドキュメント ページの説明に沿って結果を確認できます。
pull リクエストからの自動トリガー
Looker からの pull リクエストでトリガーする で CI スイートを有効にしている場合、Looker デベロッパーが LookML リポジトリに pull リクエストを送信すると、CI は検証実行を自動的にトリガーします(必要に応じて、リポジトリ内の特定のブランチへの pull リクエストのみが自動 CI 実行をトリガーするように指定できます)。
pull リクエストの自動検証実行の場合、CI は最新の pull リクエスト commit を検証し、そのバージョンのリポジトリ内のすべてのエラーを返します。
結果の表示方法については、継続的インテグレーションの実行結果を表示するのドキュメント ページをご覧ください。
CI スイートの新しい実行を手動でトリガーする
see_ci 権限を持つ Looker ユーザーは、Looker IDE から CI 実行を手動でトリガーできます。
CI スイートの新しい実行を手動でトリガーする手順は次のとおりです。
- [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [スイート] をクリックして [スイート] ページを開きます。
- 実行する CI スイートの [スイートを実行] ボタンをクリックします(プロジェクトに CI スイートがない場合は、CI スイートを作成できます)。
[**実行を手動でトリガー**] ダイアログで、[**ワークスペース**] オプションを使用して、検証するブランチを選択します(詳細については、ワークスペースをご覧ください)。
- LookML プロジェクトの本番環境バージョンを検証するには、[本番環境] をクリックします。
- LookML プロジェクトの開発ブランチを検証する場合は、[開発モード] をクリックします。[ブランチ] プルダウン メニューを使用して、検証する開発ブランチを選択します。
CI スイートの実行をトリガーするには、[実行を開始] をクリックします。
CI スイートの実行が完了するまでに数分かかることがあります。これは、プロジェクトのサイズ、CI スイートに含まれる検証ツール、CI スイートの構成によって異なります。
実行をトリガーすると、Looker IDE に、トリガーしたスイートの [実行] ページが表示されます。検証テストが完了すると、[実行] ページに各検証ツールの結果が表示されます。検証テストの実行中に [実行] ページから移動し、後で [実行] ページに戻って結果を確認できます。
結果の表示方法については、継続的インテグレーションの実行結果を表示するのドキュメント ページをご覧ください。
ワークスペース
CI 実行を手動でトリガーする場合は、[ワークスペース] オプションを使用して、リポジトリの本番環境バージョンまたはリポジトリの開発ブランチを検証できます。
[本番環境] オプションの場合、本番環境バージョンに使用するブランチまたは commit を特定するには、Looker IDE の [プロジェクト設定] の [ブランチ管理] ページの [Git の概要] セクションで [デフォルトの本番環境ブランチ] フィールドを確認します。
- 高度なデプロイモードで構成されたプロジェクトの場合、本番環境バージョンは、
deploy権限を持つ Looker デベロッパーが Deployment Manager で選択した commit またはタグです。 - 高度なデプロイモードを使用しないプロジェクトの場合、本番環境バージョンは、[プロジェクト設定] の [プロジェクト構成] ページの [Git 本番環境のブランチ名] フィールドで構成されたブランチです。
[開発モード] オプションの場合、プロジェクトの開発ブランチを検証する際は次の点に注意してください。
- 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 実行を再実行する手順は次のとおりです。
- [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [実行] をクリックして [実行] ページを開きます。
- [実行] ページで、キャンセルする CI 実行の [実行を表示] ボタンをクリックします。
- 選択した実行の実行結果ページで、ページ上部の [再実行] ボタンをクリックします。
[**再実行**] をクリックすると、Content Validator が実行を開始し、新しい実行の [**実行**] ページに戻ります。
結果の表示方法については、継続的インテグレーションの実行結果を表示するのドキュメント ページをご覧ください。
CI 実行をキャンセルする
実行中の CI 実行をキャンセルする場合は、次の手順で [実行] ページからキャンセルできます。
- [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [実行] をクリックして [実行] ページを開きます。
- [実行] ページで、キャンセルする CI 実行の [実行を表示] ボタンをクリックします。
- 選択した実行の [実行] ページで、ページ上部の [キャンセル] ボタンをクリックします。
[キャンセル] をクリックすると、継続的インテグレーションは実行をキャンセルし、[実行] ページに [キャンセル済み] ステータスが表示されます。