執行持續整合套件

您可以透過多種方式觸發持續整合 (CI) 執行作業：

驗證測試完成後，您可以查看結果，詳情請參閱「查看持續整合執行結果」說明文件頁面。

透過提取要求自動觸發

如果您已啟用持續整合套件，並使用在 Looker 發出提取要求時觸發，當 Looker 開發人員向 LookML 存放區提交提取要求時，持續整合會自動觸發驗證作業。(您可以選擇指定只有存放區中特定分支的提取要求才會觸發自動 CI 執行作業)。

自動執行提取要求驗證作業時，持續整合會驗證最新的提取要求提交內容，並傳回該版本存放區中的所有錯誤。

如要瞭解如何查看結果，請參閱「查看持續整合執行結果」說明文件頁面。

手動觸發 CI 套件的新執行作業

具備 see_ci 權限的 Looker 使用者，可以手動透過 Looker IDE 觸發 CI 執行作業。

如要手動觸發 CI 套件的新執行作業，請按照下列步驟操作：

  1. 在 Looker IDE 中，按一下 IDE 導覽列中的「持續整合」圖示。
  2. 按一下「套裝方案」，開啟「套裝方案」頁面。
  3. 按一下要執行的 CI 套件組合旁的「Run suite」按鈕 (如果專案沒有任何 CI 套件組合，您可以建立 CI 套件組合)。

  4. 在「手動觸發執行作業」對話方塊中，使用「工作區」選項選取要驗證的分支 (詳情請參閱「工作區」一節)：

    • 如要驗證 LookML 專案的正式版，請按一下「正式版」。
    • 如要驗證 LookML 專案的開發分支，請按一下「開發人員模式」。使用「Branch」下拉式選單，選取要驗證的開發分支版本。

  5. 如要觸發 CI 套件的執行作業，請按一下「Start run」。

視專案大小、CI 套件中的驗證工具，以及 CI 套件的設定而定，CI 套件可能需要數分鐘才能完成執行。

觸發執行作業後，Looker IDE 會針對您觸發的套件顯示「Run」頁面。驗證測試完成後，「Run」頁面會顯示每個驗證工具的結果。您可以在驗證測試執行期間離開「Run」頁面，然後稍後返回「Run」頁面查看結果。

如要瞭解如何查看結果，請參閱「查看持續整合執行結果」說明文件頁面。

工作區

手動觸發 CI 執行作業時，您可以使用「工作區」選項驗證存放區的正式版或開發分支。

針對「正式版」選項，如果您想找出正式版使用的分支或提交內容，可以在 Looker IDE 的「Project Settings」頁面中，前往「Branch Management」頁面，然後在「Git Summary」部分的「Default Production Branch」欄位中查看：

  • 如果專案已設定為使用進階部署模式，正式版本就是由具備 deploy 權限的 Looker 開發人員在部署管理工具中選取的提交或版本標記。
  • 如果專案沒有進階部署模式，則正式版是指在 專案設定的「專案設定」頁面中，在「Git 正式版分支名稱」欄位中設定的分支版本。

針對「開發人員模式」選項，請注意下列事項，以便驗證專案中的開發分支：

  • 如要查看 LookML 專案中的分支，並找出開發人員的正式版分支和個人分支，請在 Looker IDE 中參閱專案的「專案設定」頁面中的「分支管理」頁面。
  • 如要驗證開發分支，開發分支必須推送至 LookML 存放區。在 Looker IDE 中，開發人員必須按一下「Commit Changes & Push」 按鈕，或在 IDE 的「Git Actions」面板中選取「Commit」選項。

手動重新執行先前的持續整合作業

如果是已完成的執行作業 (執行作業通過、失敗、發生錯誤或已取消)，擁有 see_ci 權限的 Looker 使用者可以手動觸發 Looker IDE 中的 CI 執行作業重跑：

  • 如果重新執行 PR 觸發的執行作業，持續整合會針對與原始執行作業相同的提交執行。
  • 如果您重新執行手動觸發的執行作業，持續整合作業會在重新執行時針對實際工作環境狀態或分支 HEAD 執行，這會包含自初始 CI 執行作業以來所做的任何後續提交。

此外，如果您在初次執行後編輯了 CI 套件，重複執行時就會納入您在初次執行後對 CI 套件所做的任何變更。

如要重新執行 CI 執行作業，請按照下列步驟操作：

  1. 在 Looker IDE 中，按一下 IDE 導覽列中的「持續整合」圖示。
  2. 按一下「Runs」，開啟「Runs」頁面。
  3. 在「Runs」頁面中，找出要取消的 CI 執行作業，然後按一下「View Run」按鈕。
  4. 在所選執行作業的結果頁面中，按一下頁面頂端的「Rerun」按鈕。

點選「Rerun」後，內容驗證工具就會啟動執行作業，並將您帶往「Run」頁面，以便執行新作業。

如要瞭解如何查看結果，請參閱「查看持續整合執行結果」說明文件頁面。

取消 CI 執行作業

如要取消正在執行的 CI 執行作業，請按照下列步驟操作，前往該執行作業的「Run」頁面：

  1. 在 Looker IDE 中，按一下 IDE 導覽列中的「持續整合」圖示。
  2. 按一下「Runs」，開啟「Runs」頁面。
  3. 在「Runs」頁面中，找出要取消的 CI 執行作業，然後按一下「View Run」按鈕。
  4. 在所選執行作業的「Run」頁面，按一下頁面頂端的「Cancel」按鈕。

點選「取消」後，持續整合會取消執行作業，並在「執行」頁面上顯示「已取消」狀態。