継続的インテグレーション（CI）スイートは、LookML プロジェクトに関連付けられた検証手順のセットです。manage_ci 権限を持つ Looker ユーザーは、CI スイートで次のことを構成できます。
- CI 検証実行のトリガー方法（Looker IDE から手動でトリガーするか、pull リクエストがリポジトリに送信されたときに自動的にトリガーするか）。
- 実行する CI バリデータ。
- 検証テストごとの追加オプション。詳細については、各バリデータのドキュメント ページをご覧ください。
始める前に
CI スイートを作成するには、次のものが必要です。
CI スイートを作成する
Looker IDE の [スイート] ページでバリデータを構成して実行できます。
CI スイートを作成する手順は次のとおりです。
- [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [スイート] タブをクリックして [スイート] ページを開きます。
- [スイート] ページで、新しいスイートを作成するか、既存のスイートを編集できます。
- 新しいスイートを作成するには、[スイートを作成] ボタンをクリックします。
- 既存のスイートを編集するには、スイートの [スイートを編集] ボタンをクリックします。
- [スイート名] に名前を入力します。既存のスイートを編集する場合は、鉛筆アイコンをクリックしてスイート名を編集することもできます。
- （省略可）定期的なスケジュールで自動検証テストを設定する場合は、[スケジュールに基づいてトリガーする] 切り替えを有効にします。詳細については、このページのスケジュールに基づいてトリガーするをご覧ください。
（省略可）Looker デベロッパーがリポジトリに pull リクエストを送信するたびに自動検証テストを設定する場合は、[Looker からの pull リクエストでトリガーする] 切り替えを有効にします。詳細については、このページの Looker からの pull リクエストでトリガーするをご覧ください。
CI スイートの pull リクエスト トリガーを有効にした場合は、[ターゲット ブランチのみ] フィールドを使用して、リポジトリ内の特定のブランチへの pull リクエストのみが CI スイートの実行をトリガーするように指定できます。詳細については、このページの Looker からの pull リクエストでトリガーするをご覧ください。
必要に応じて、バリデータの切り替えを有効にしてバリデータを有効にし、そのオプションを構成します。詳細については、各バリデータのドキュメント ページをご覧ください。
変更を保存します。
- 新しいスイートを作成する場合は、[スイートを作成] ボタンをクリックします。
- 既存のスイートを編集する場合は、[スイートを更新] ボタンをクリックします。
トリガー
CI の実行は、次のようないくつかの方法でトリガーできます。
- 定期的なスケジュールで自動的に実行する。
- Looker デベロッパーが LookML プロジェクトのリポジトリに pull リクエストを送信したときに自動的に実行する。
- Looker IDE の [**スイート**] ページで [**スイートを実行**] ボタンを使用して手動で実行する。
- Looker IDE の [実行] ページから、以前の CI 実行を再実行して手動で実行する。
スケジュールに基づいてトリガーする
[スケジュールに基づいてトリガーする] 切り替えを有効にすると、スケジュールに基づいて自動的にトリガーするように CI スイートを構成できます。
この切り替えが有効になっている場合は、CI スイートを自動的に実行する頻度と詳細を選択できます。
- 毎月 : 特定の日時
- 毎週 : 特定の日時
- 毎日 : 特定の時刻
- 1 時間ごと 、または 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 スイートを削除する手順は次のとおりです。
- [Looker IDE] で、IDE ナビゲーション バーの [継続的インテグレーション] アイコンをクリックします。
- [スイート] タブをクリックして [スイート] ページを開きます。
- [スイート] ページで、スイートの [スイートを編集] ボタンをクリックします。
- スイートのページで、[スイートを削除] ボタンをクリックします。
- 確認ダイアログで、[スイートを削除] ボタンをクリックします。