継続的インテグレーション(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 のナビゲーション バーにある [継続的インテグレーション] アイコンをクリックします。
- [スイート] タブをクリックして [スイート] ページを開きます。
- [スイート] ページで、新しいスイートを作成するか、既存のスイートを編集します。
- 新しいスイートを作成するには、[スイートを作成] ボタンをクリックします。
- 既存のスイートを編集するには、スイートの [スイートを編集] ボタンをクリックします。
- [スイート名] に名前を入力します。既存のスイートを編集する場合は、必要に応じて鉛筆アイコンをクリックしてスイート名を編集できます。
(省略可)Looker デベロッパーがリポジトリに pull リクエストを送信するたびに自動検証テストを設定するには、[Looker からの pull リクエストでトリガーする] をオンにします。詳しくは、このページのトリガー セクションをご覧ください。
CI スイートのプルリクエストのトリガーを有効にする場合は、必要に応じて [Only for target branch] フィールドを使用して、リポジトリ内の特定のブランチに対するプルリクエストのみが 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 実行の自動���ル リクエスト トリガーをリポジトリ内の特定のブランチに制限するには、[Only for target branch] フィールドにブランチのリストをカンマ区切りで入力します。
たとえば、リポジトリに main
、release_1
、dev
という 3 つのブランチがある場合は、[対象ブランチのみ] フィールドに main, release_1
と入力します。つまり、Looker デベロッパーが main
ブランチまたは release_1
ブランチに pull リクエストを送信すると、CI 実行がトリガーされます。Looker デベロッパーが dev
ブランチに pull リクエストを送信しても、CI スイートの自動実行はトリガーされません。
スイートの削除
CI スイートを削除する手順は次のとおりです。
- Looker IDE で、IDE のナビゲーション バーにある [継続的インテグレーション] アイコンをクリックします。
- [スイート] タブをクリックして [スイート] ページを開きます。
- [スイート] ページで、スイートの [スイートを編集] ボタンをクリックします。
- スイートのページで、[スイートを削除] ボタンをクリックします。
- 確認ダイアログで [スイートを削除] ボタンをクリックします。