建立持續整合套件

持續整合 (CI) 套件是一組與 LookML 專案相關聯的驗證指示。具備 manage_ci 權限的 Looker 使用者可以在 CI 套件中設定下列項目：

• 觸發 CI 驗證作業的方式 (手動從 Looker IDE 執行或在提交至存放區的提取要求時自動執行)。
• 要執行哪些 CI 驗證工具。
• 每項驗證測試的其他選項。詳情請參閱各個驗證工具的說明文件：
  • SQL Validator
  • Assert Validator
  • Content Validator
  • LookML Validator

事前準備

您必須具備下列條件，才能建立 CI 套件：

• 符合持續整合要求的 Looker 執行個體，且已啟用持續整合功能。
• 具備 manage_ci 權限的 Looker 使用者帳戶 (此權限包含在管理員權限組合中)。

建立持續整合套件

您可以在 Looker IDE 的「套件」頁面中設定及執行驗證器：

如要建立 CI 套件，請按照下列步驟操作：

1. 在 Looker IDE 中，按一下 IDE 導覽列中的「持續整合」圖示。
2. 按一下「套裝方案」分頁標籤，開啟「套裝方案」頁面。
3. 在「套裝組合」頁面中，您可以建立新的套裝組合或編輯現有套裝組合：
   • 如要建立新套裝組合，請按一下「建立套裝組合」按鈕。
   • 如要編輯現有的套裝組合，請按一下套裝組合的「編輯套裝組合」按鈕。
4. 輸入「套件名稱」。如要編輯現有套裝行程，可以選擇按一下鉛筆圖示來編輯套裝行程名稱。

5. (選用) 如果您想在 Looker 開發人員將提取要求提交至存放區時設定自動驗證測試，請啟用「在 Looker 發出提取要求時觸發」切換鈕。詳情請參閱本頁的「觸發條件」一節。

   如果您為 CI 套件啟用提取要求觸發功能，可以選擇使用「僅限目標分支」欄位，指定只有針對存放區中特定分支的提取要求，才會觸發 CI 套件的執行作業。詳情請參閱本頁的「觸發條件」一節。

6. 您可以選擇啟用驗證器切換鈕，開啟驗證器並設定其選項。詳情請參閱各驗證工具的說明文件：

   • SQL Validator
   • Assert Validator
   • Content Validator
   • LookML Validator

7. 儲存變更：

   • 如要建立新套裝組合，請按一下「建立套裝組合」按鈕。
   • 如果要編輯現有的套裝方案，請按一下「更新套裝方案」按鈕。

觸發條件

您可以透過多種方式觸發 CI 執行作業：

• 自動執行，當 Looker 開發人員將提取要求提交至 LookML 專案的存放區時。
• 手動：在 Looker IDE 的「套件組合」頁面上，使用「執行套件組合」按鈕。
• 手動方式：在 Looker IDE 的「Runs」頁面中重新執行先前的 CI 執行作業。

如要設定 CI 套件，以便在提取要求時自動觸發，請啟用「在 Looker 發出提取要求時觸發」切換鈕。如要使用提取要求觸發功能，Looker 管理員必須在 Looker 的「持續整合」頁面中設定 Git 存放區。

如果您為 CI 套件啟用提取要求觸發條件，可以選擇指定只有存放區中特定分支的提取要求，才能觸發 CI 套件的執行作業。如要將自動提取要求觸發條件限制為 CI 在儲存庫中執行的特定分支，請在「僅限目標分支」欄位中，輸入以半形逗號分隔的分支清單。

舉例來說，如果存放區有三個分支，分別命名為 main、release_1 和 dev，您可以在「僅限目標分支」欄位中輸入 main, release_1。也就是說，當 Looker 開發人員將提取要求提交至 main 或 release_1 分支時，系統就會觸發 CI 執行作業。如果 Looker 開發人員將提取要求提交至 dev 分支，系統不會觸發 CI 套件的自動執行作業。

刪除套房

如要刪除 CI 套件，請執行下列步驟：

1. 在 Looker IDE 中，按一下 IDE 導覽列中的「持續整合」圖示。
2. 按一下「套裝方案」分頁標籤，開啟「套裝方案」頁面。
3. 在「套件組合」頁面中，按一下套件的「編輯套件」按鈕。
4. 在套裝軟體頁面上，按一下「刪除套裝軟體」按鈕。
5. 在確認對話方塊中，按一下「刪除套裝方案」按鈕。