継続的インテグレーション（CI）スイートは、LookML プロジェクトに関連付けられた検証手順のセットです。manage_ci 権限を持つ Looker ユーザーは、CI スイートで次の項目を構成できます。
- CI 検証実行のトリガー方法（Looker IDE から手動で、またはリポジトリに pull リクエストが送信されたときに自動で）。
- 実行する CI バリデータ。
- 各検証テストの追加オプション。各バリデーターの詳細については、ドキュメント ページをご覧ください。
始める前に
CI スイートを作成するには、次のものが必要です。
- CI の要件を満たし、CI が有効になっている Looker インスタンス。
manage_ci権限を持つ Looker ユーザー アカウント（この権限は管理者権限セットに含まれています）。
CI スイートの作成
Looker IDE の [スイート] ページで、検証ツールを構成して実行できます。
CI スイートを作成する手順は次のとおりです。
- Looker IDE で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [Suites] タブをクリックして、[Suites] ページを開きます。
- [スイート] ページでは、新しいスイートを作成したり、既存のスイートを編集したりできます。
- 新しいスイートを作成するには、[スイートを作成] ボタンをクリックします。
- 既存のスイートを編集するには、スイートの [スイートを編集] ボタンをクリックします。
- [スイート名] に名前を入力します。既存のスイートを編集する場合は、必要に応じて鉛筆アイコンをクリックしてスイート名を編集できます。
（省略可）Looker デベロッパーがリポジトリに pull リクエストを送信するたびに自動検証テストを設定する場合は、[Looker からの pull リクエストでトリガーする] 切り替えを有効にします。詳しくは、このページのトリガーをご覧ください。
CI スイートの pull リクエスト トリガーを有効にすると、必要に応じて [Only for target branch] フィールドを使用して、リポジトリ内の特定のブランチに対する pull リクエストのみが CI スイートの実行をトリガーするように指定できます。詳しくは、このページのトリガーをご覧ください。
必要に応じて、検証ツールを有効にして検証ツールをオンにし、そのオプションを構成します。詳しくは、各バリデーターのドキュメント ページをご覧ください。
変更を保存します。
- 新しいスイートを作成する場合は、[スイートを作成] ボタンをクリックします。
- 既存のスイートを編集する場合は、[スイートを更新] ボタンをクリックします。
トリガー
CI 実行は、次のようないくつかの方法でトリガーできます。
- Looker デベロッパーが LookML プロジェクトのリポジトリに pull リクエストを送信したときに自動的に実行されます。
- Looker IDE の [Suites] ページで [Run suite] ボタンを使用して手動で実行する。
- Looker IDE の [実行] ページから、以前の CI 実行を再実行して手動で行う。
pull リクエストで自動的にトリガーされるように CI スイートを構成するには、[Looker からの pull リクエストでトリガー] 切り替えを有効にします。pull リクエスト トリガーを使用するには、Looker の [継続的インテグレーション] 管理ページで Looker 管理者が Git リポジトリを構成する必要があります。
CI スイートの pull リクエスト トリガーを有効にすると、リポジトリ内の特定のブランチに対する pull リクエストのみが CI スイートの実行をトリガーするように指定できます。CI 実行の自動プルリクエスト トリガーをリポジトリ内の特定のブランチに制限するには、[ターゲット ブランチのみ] フィールドにブランチのカンマ区切りリストを入力します。
たとえば、リポジトリに main、release_1、dev という名前の 3 つのブランチがある場合は、[ターゲット ブランチのみ] フィールドに main, release_1 と入力します。つまり、Looker デベロッパーが main ブランチまたは release_1 ブランチに pull リクエストを送信すると、CI 実行がトリガーされます。Looker デベロッパーが dev ブランチに pull リクエストを送信しても、CI スイートの自動実行はトリガーされません。
スイートを削除する
CI スイートを削除するには、次の手順を行います。
- Looker IDE で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [Suites] タブをクリックして、[Suites] ページを開きます。
- [Suites] ページで、スイートの [Edit suite] ボタンをクリックします。
- スイートのページで、[スイートを削除] ボタンをクリックします。
- 確認ダイアログで、[スイートを削除] ボタンをクリックします。