執行持續整合套件

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

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

從提取要求自動觸發

如果您已啟用 CI 套件,並選取「從 Looker 發出提取要求時觸發」,當 Looker 開發人員將提取要求提交至 LookML 存放區時,CI 會自動觸發驗證執行作業。(您可以選擇指定只有送往存放區中特定分支的提取要求,才會觸發自動 CI 執行作業)。

如果是自動執行提取要求驗證,CI 會驗證最新的提取要求提交,並傳回該版本存放區中的所有錯誤。

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

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

具備 see_ci 權限的 Looker 使用者可以從 Looker IDE 手動觸發 CI 執行。

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

  1. Looker IDE 中,按一下 IDE 導覽列中的「持續整合」圖示。
  2. 按一下「套裝組合」開啟「套裝組合」頁面。
  3. 按一下要執行的 CI 套件組合的「執行套件組合」按鈕 (如果專案沒有任何 CI 套件組合,可以建立 CI 套件組合)。
  4. 在「Trigger a run manually」對話方塊中,使用「Workspace」選項選取要驗證的分支 (詳情請參閱「Workspace」一節):

    • 如要驗證 LookML 專案的正式版,請按一下「正式版」
    • 如要驗證 LookML 專案的開發分支,請按一下「開發模式」。使用「分支版本」下拉式選單,選取要驗證的開發分支版本。
  5. 如要觸發執行 CI 套件組合,請按一下「Start run」(開始執行)

視專案大小、CI 套件中包含的驗證器,以及 CI 套件的設定而定,CI 套件可能需要幾分鐘才能完成執行。

觸發執行後,Looker IDE 會顯示您觸發的套件「執行」頁面。驗證測試完成後,「Run」頁面會顯示每個驗證器的結果。驗證測試執行期間,您可以離開「執行」頁面,稍後再返回「執行」頁面查看結果。

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

工作區

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

如果是「正式版」選項,如要找出正式版使用的分支或提交內容,請前往「專案設定」的「分支管理」頁面,在「Git 摘要」部分的「預設正式版分支」欄位中查看 Looker IDE:

  • 如果是以進階部署模式設定的專案,正式版就是 Looker 開發人員在部署管理員中選取的提交或標記,且該開發人員必須具備 deploy 權限
  • 如果專案沒有進階部署模式,則生產環境版本是專案設定頁面中「專案設定」頁面的「Git 生產環境分支名稱」欄位中設定的分支。

如要使用「開發模式」選項驗證專案中的開發分支,請注意下列事項:

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

手動重新執行先前的 CI 執行作業

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

  • 如果重新執行 PR 觸發的執行作業,系統會針對與原始執行作業相同的提交內容執行持續整合。
  • 如果重新執行手動觸發的執行作業,持續整合會在重新執行時,針對生產環境狀態或分支 HEAD 執行作業,包括初始 CI 執行作業後進行的任何後續提交。

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

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

  1. Looker IDE 中,按一下 IDE 導覽列中的「持續整合」圖示。
  2. 按一下「執行」開啟「執行」頁面。
  3. 在「Runs」(執行) 頁面中,按一下要取消的 CI 執行作業的「View Run」(查看執行) 按鈕。
  4. 在所選執行的執行結果頁面中,按一下頁面頂端的「重新執行」按鈕。

按一下「重新執行」後,內容驗證器會啟動執行作業,並將您帶回新執行作業的「執行」頁面。

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

取消 CI 執行

如要取消正在執行的 CI 執行作業,請按照下列步驟操作,從「Run」頁面取消:

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

按一下「取消」後,持續整合會取消執行作業,並在「執行」頁面上顯示「已取消」狀態。