執行持續整合套件

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

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

從提取要求自動觸發

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

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

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

依排程自動觸發

如果您已啟用 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 開發人員在部署管理工具中選取的提交或標記，且該開發人員必須具備 deploy 權限。
  • 如果專案沒有進階部署模式，則生產環境版本是專案設定「專案設定」頁面中「Git 生產環境分支名稱」欄位設定的分支。

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

  • 如要查看 LookML 專案中的分支，並找出正式版分支和開發人員的個人分支，請前往 Looker IDE 中專案的「專案設定」頁面，然後參閱「分支管理」部分。
  • 如要驗證開發分支，必須將開發分支推送至 LookML 存放區。在 Looker IDE 中，開發人員必須按一下「Commit Changes & Push」按鈕，或從 IDE 的「Git Actions」面板選取「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. 在所選執行的執行結果頁面中，按一下頁面頂端的「重新執行」按鈕。

按一下「重新執行」Rerun後，Content Validator 就會啟動執行作業，並將您帶回新執行作業的「執行」Run頁面。

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

取消 CI 執行作業

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

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

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