執行持續整合套件

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

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

從提取要求自動觸發

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

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

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

匯入專案的提取要求自動觸發

如果您在下游 (分支) 專案中啟用 CI 套件,並勾選「Trigger on pull requests from imported projects」(觸發匯入專案的提取要求),當開發人員在訂閱的上游 (中樞) 專案存放區中開啟或更新提取要求時,CI 會自動在分支專案中觸發驗證執行作業。

匯入專案提取要求觸發 CI 執行作業時,Looker 會執行下列動作:

  1. 驗證輪輻專案的正式版,同時將匯入的中樞專案暫時固定至提取要求修訂版本。
  2. 將輪輻專案的 CI 執行結果寫回中樞專案存放區中的提取要求。

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

從 dbt Cloud 自動觸發

如果您已啟用 CI 套件,並勾選「從 dbt Cloud 發出提取要求時觸發」,CI 就會在指定的 dbt Cloud CI 工作完成時,自動觸發驗證執行作業。

dbt Cloud CI 工作觸發的 CI 執行作業,旨在檢查 dbt 中的結構定義變更是否會破壞 LookML 內容。執行期間,Looker 會執行下列動作:

  1. 在工作完成時接收 dbt Cloud 的通知。
  2. 擷取 dbt Cloud 為特定執行作業建立的臨時結構定義詳細資料。
  3. 使用這個臨時結構定義的名稱,覆寫已設定的使用者屬性 (例如連線的結構定義屬性)。
  4. 對這個暫時結構定義執行 CI 驗證工具。

這樣一來,您就能在 dbt 變更合併至正式環境前,找出破壞性變更 (例如捨棄的資料欄或重新命名的資料表)。執行完畢後,CI 使用者的使用者屬性值會還原為標準值。

按照排程自動觸發

如果您已啟用 CI 套件並設定「Trigger on a schedule」(依排程觸發),CI 就會按照您指定的排程自動觸發驗證執行作業。

如果是自動排定的驗證執行作業,CI 會驗證存放區的正式版本,並傳回該版本中的所有錯誤。

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

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

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

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

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

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

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

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

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

工作區

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

如要找出正式版使用的分支版本或修訂版本,請在 Looker IDE 中,前往「專案設定」的「分支版本管理」頁面,查看「Git 摘要」部分的「預設正式版分支版本」欄位:

  • 如果專案已設定進階部署模式,正式版就是由具備 deploy 權限的 Looker 開發人員,在部署管理工具中選取的修訂版本或標記。
  • 如果專案未啟用進階部署模式,正式版就是專案設定的「專案設定」頁面中,「Git 正式版分支名稱」欄位設定的分支版本。

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

  • 如要查看 LookML 專案中的分支版本,並找出正式環境分支版本和開發人員的個人分支版本,請前往 Looker IDE 中專案的「Project Settings」(專案設定) 頁面,然後參閱「Branch Management」(分支版本管理) 部分。
  • 如要驗證開發分支版本,必須將開發分支版本推送至 LookML 存放區。在 Looker IDE 中,這表示開發人員必須點選「Commit Changes & Push」按鈕,或在 IDE 的「Git Actions」面板中選取「Commit」選項。

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

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

  • 如果重新執行提取要求觸發的執行作業 (由專案存放區或匯入專案中的提取要求觸發),持續整合會針對與原始執行作業相同的修訂版本執行。
  • 如果重新執行手動觸發的執行作業,持續整合會針對重新執行時的正式環境狀態或分支版本 HEAD 執行,其中會包含自初始 CI 執行以來的所有後續修訂版本。

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

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

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

點選「重新執行」後,Content Validator 就會開始執行,並返回新執行的「執行」頁面。

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

取消 CI 執行作業

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

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

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