継続的インテグレーション スイートの作成

継続的インテグレーション（CI）スイートは、LookML プロジェクトに関連付けられた検証手順のセットです。manage_ci 権限を持つ Looker ユーザーは、CI スイートで次の項目を構成できます。

• CI 検証の実行をトリガーする方法（Looker IDE から手動でトリガーするか、pull リクエストがリポジトリに送信されたときに自動的にトリガーするか）。
• 実行する CI バリデータ。
• 検証テストごとの追加オプション。詳細については、各バリデータのドキュメント ページをご覧ください。
  • SQL バリデータ
  • Assert Validator
  • コンテンツ バリデータ
  • LookML Validator

始める前に

CI スイートを作成するには、次のものが必要です。

• CI の要件を満たし、CI が有効になっている Looker インスタンス。
• manage_ci 権限を持つ Looker ユーザー アカウント（この権限は管理者 権限セット に含まれています）。

CI スイートを作成する

Looker IDE の [スイート] ページでバリデータを構成して実行できます。

CI スイートを作成する手順は次のとおりです。

1. [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
2. [スイート] タブをクリックして、[スイート] ページを開きます。
3. [スイート] ページで、新しいスイートを作成するか、既存のスイートを編集できます。
   • 新しいスイートを作成するには、[スイートを作成] ボタンをクリックします。
   • 既存のスイートを編集するには、スイートの [スイートを編集] ボタンをクリックします。
4. [スイート名] に名前を入力します。既存のスイートを編集する場合は、必要に応じて鉛筆アイコンをクリックしてスイート名を編集できます。

5. （省略可）Looker デベロッパーがリポジトリに pull リクエストを送信するたびに自動検証テストを設定する場合は、[Looker からの pull リクエストでトリガー] 切り替えを有効にします。詳細については、このページのトリガーのセクションをご覧ください。

   CI スイートの pull リクエスト トリガーを有効にした場合は、必要に応じて [ターゲット ブランチのみ] フィールドを使用して、リポジトリ内の特定のブランチへの pull リクエストのみが CI スイートの実行をトリガーするように指定できます。詳細については、このページのトリガーのセクションをご覧ください。

6. 必要に応じて、バリデータの切り替えを有効にしてバリデータを有効にし、そのオプションを構成します。詳細については、各バリデータのドキュメント ページをご覧ください。

   • SQL バリデータ
   • Assert Validator
   • コンテンツ バリデータ
   • LookML Validator

7. 変更を保存します。

   • 新しいスイートを作成する場合は、[スイートを作成] ボタンをクリックします。
   • 既存のスイートを編集する場合は、[スイートを更新] ボタンをクリックします。

トリガー

CI の実行は、次のようないくつかの方法でトリガーできます。

• Looker デベロッパーが LookML プロジェクトのリポジトリに pull リクエストを送信したときに自動的にトリガーされます。
• Looker IDE の [**スイート**] ページで [**スイートを実行**] ボタンを使用して手動でトリガーします。
• Looker IDE の [実行] ページから、以前の CI 実行を再実行して手動でトリガーします。

pull リクエストで自動的にトリガーするように CI スイートを構成するには、[Looker からの pull リクエストでトリガー] 切り替えを有効にします。pull リクエスト トリガーを使用するには、Looker の [継続的インテグレーション] 管理ページで Looker 管理者が Git リポジトリを構成する必要があります。

ヒント:pull リクエストで自動的に実行するように CI スイートを構成した場合でも、Looker IDE から手動で実行を開始したり、以前の CI スイートの実行を手動で再実行したりできます。

CI スイートの pull リクエスト トリガーを有効にした場合は、必要に応じて、リポジトリ内の特定のブランチへの pull リクエストのみが CI スイートの実行をトリガーするように指定できます。CI 実行の自動 pull リクエスト トリガーをリポジトリ内の特定のブランチに制限するには、[ターゲット ブランチのみ] フィールドにブランチのカンマ区切りのリストを入力します。

たとえば、リポジトリに main、release_1、dev という名前の 3 つのブランチがある場合は、main, release_1 を [**ターゲット ブランチのみ**] フィールドに入力します。つまり、Looker デベロッパーが main ブランチまたは release_1 ブランチに pull リクエストを送信すると、CI 実行がトリガーされます。Looker デベロッパーが dev ブランチに pull リクエストを送信しても、CI スイートの自動実行はトリガーされません。

スイートを削除する

CI スイートを削除する手順は次のとおりです。

1. [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
2. [スイート] タブをクリックして、[スイート] ページを開きます。
3. [スイート] ページで、スイートの [スイートを編集] ボタンをクリックします。
4. スイートのページで、[スイートを削除] ボタンをクリックします。
5. 確認ダイアログで、[スイートを削除] ボタンをクリックします。