継続的インテグレーション（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 リクエストでトリガーする] 切り替えを有効にします。詳細については、このページの Looker からの pull リクエストでトリガーするをご覧ください。
CI スイートの pull リクエスト トリガーを有効にすると、必要に応じて [Only for target branch] フィールドを使用して、リポジトリ内の特定のブランチに対する pull リクエスト のみが CI スイートの実行をトリガーするように指定できます。詳細については、このページの Looker からの pull リクエストでトリガーするをご覧ください。
（省略可）CI 実行のステータスに基づいてメール アラートを受信する場合は、[メール アラートを有効にする] 切り替えをオンにします。詳細については、このページのアラートを設定するをご覧ください。
必要に応じて、バリデータ切り替えを有効にしてバリデータをオンにし、そのオプションを構成します。詳しくは、各バリデーターのドキュメント ページをご覧ください。
変更を保存します。
- 新しいスイートを作成する場合は、[スイートを作成] ボタンをクリックします。
- 既存のスイートを編集する場合は、[スイートを更新] ボタンをクリックします。
トリガー
CI 実行は、次の方法でトリガーできます。
- 定期的なスケジュールで自動的に実行されます。
- Looker デベロッパーが LookML プロジェクトのリポジトリに pull リクエストを送信したときに自動的に実行されます。
- Looker IDE の [Suites] ページで [Run suite] ボタンを使用して手動で実行します。
- Looker IDE の [実行] ページから、以前の CI 実行を再実行して手動で実行します。
スケジュールに基づいてトリガーする
[Trigger on a schedule] 切り替えを有効にすると、スケジュールに従って自動的にトリガーされるように CI スイートを構成できます。
この切り替えを有効にすると、CI スイートを自動的に実行する頻度と詳細を選択できます。
- 毎月、特定の日時
- 毎週、特定の曜日と時刻
- 毎日、特定の時刻
- 時間単位、または 2、3、4、6、8、12 時間ごと（1 日の特定の時間に開始および終了）
- 分単位: 5、10、15、20、30 分ごとに、1 日の特定の時刻に開始および終了
- 特定の月の特定の日時
- 特定の曜日の特定の時間帯
Looker からの pull リクエストでトリガーする
pull リクエストで自動的にトリガーされるように CI スイートを構成するには、[Looker からの pull リクエストでトリガー] 切り替えを有効にします。pull リクエスト トリガーを使用するには、Looker の [継続的インテグレーション] 管理ページで Looker 管理者が Git リポジトリを構成する必要があります。
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 実行のステータスに基づいてメールアラートを受け取るには、CI スイートのアラートを設定します。これにより、Looker IDE の [実行] ページを参照しなくても、継続的インテグレーションの実行をモニタリングできます。
CI スイートのメール通知アラートを構成するには、CI スイートの作成または編集時に次の手順を行います。
- [メール通知アラートを有効化] 切り替えボタンをオンにします。
- [メールアドレス] フィールドに、アラートを受信するメールアドレスのリストをカンマ区切りで入力します。
- チェックボックスを使用して、アラートをトリガーするジョブのステータスを選択します。
- 失敗: CI 実行が検証テストに失敗したときにメールをトリガーします。
- エラー: CI 実行でシステム エラーまたは構成エラーが発生したときにメールをトリガーします。
- 合格: CI 実行が正常に完了したときにメールをトリガーします。
- Cancelled: CI 実行がキャンセルされたときにメールをトリガーします。
スイートを削除する
CI スイートを削除する手順は次のとおりです。
- Looker IDE で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [Suites] タブをクリックして、[Suites] ページを開きます。
- [Suites] ページで、スイートの [Edit suite] ボタンをクリックします。
- スイートのページで、[スイートを削除] ボタンをクリックします。
- 確認ダイアログで [スイートを削除] ボタンをクリックします。