排定建構作業

本頁說明如何使用Google Cloud 控制台,依預先定義的排程執行建構作業。如要排定建構作業,請建立手動觸發條件,然後使用 Cloud Scheduler 叫用該觸發條件。

事前準備

  • Enable the Cloud Build API.

    Enable the API

  • 準備好原始碼。
  • 如果尚未建立手動觸發條件,請先完成這項作業。 只有在觸發條件為手動觸發條件時,才能排定建構作業。

排定建構作業

建立手動觸發條件後,即可排定建構作業。

如要安排建構時間,請按照下列步驟操作:

  1. 開啟「觸發條件」頁面:

    開啟「Triggers」(觸發條件) 頁面

  2. 找出包含要依排定時間執行的手動觸發條件名稱的資料列。

  3. 按一下含有觸發條件的資料列最右側的選單 (垂直刪節號)。

  4. 按一下「Run on schedule」(依排程執行),即可排定建構時間。

    右側會顯示「Run trigger on schedule」(依時間表執行觸發程序) 面板。

  5. 啟用 Cloud Scheduler API。

    只有在首次排定建構作業時,系統才會提示您啟用 Cloud Scheduler API。

  6. 選取 Cloud Scheduler 叫用觸發條件時要使用的服務帳戶。

    建議選取預設排程服務帳戶,格式如下 (其中 PROJECT_ID 是專案的專案 ID):

     cloud-build-trigger-scheduler@PROJECT_ID.iam.gserviceaccount.com
    

    選取預設排程服務帳戶後,系統會自動為您建立帳戶,並授予 Cloud Build 編輯者 IAM 角色。建議您不要刪除這個服務帳戶,因為 Cloud Scheduler 會使用這個帳戶排定建構作業。如果不慎刪除這個服務帳戶,或撤銷任何 IAM 權限,可以前往 IAM 頁面手動新增服務帳戶,並授予「Cloud Build 編輯者」角色。重新建立服務帳戶後,現有的 Cloud Scheduler 工作最多可能需要一小時才會恢復。

  7. 按一下「繼續」

    如果尚未選取區域,系統可能會提示您為 Cloud Scheduler 工作選取區域,然後才能繼續下一個步驟。選取地區後,系統會在專案中自動建立 App Engine 應用程式。專案的地區無法變更。詳情請參閱「支援的區域」一文。

  8. 輸入下列 Cloud Scheduler 工作設定:

    • 名稱:Cloud Scheduler 工作的名稱。
    • 說明 (選用):Cloud Scheduler 工作的說明。
    • 頻率:選取觸發條件的執行頻率。您可以從下拉式選單中選擇頻率,也可以使用 Cron 語法輸入自訂值。舉例來說,如要讓手動觸發程序每天早上 6 點執行,可以採用 cron 語法指定頻率,例如 0 6 * * *。如要進一步瞭解 Cron 語法,請參閱「設定 Cron 工作時間表」。
    • 時區:選取您的時區。
  9. 按一下「建立」,即可建立 Cloud Scheduler 工作。

    每個手動觸發條件可以建立多項排程器工作。

  10. 如要查看 Cloud Scheduler 工作,請按一下「View」(查看)。否則,請按一下「完成」關閉面板。

更新 Cloud Scheduler 工作

如果您更新手動觸發程序中的「修訂版本」欄位,就必須手動更新與觸發程序相關聯的 Cloud Scheduler 工作。舉例來說,如果您更新手動觸發程序的分支名稱,就必須手動更新作業中的分支名稱。

如要更新 Cloud Scheduler 工作,請按照下列步驟操作:

  1. 開啟「Cloud Scheduler」頁面:

    開啟 Cloud Scheduler 頁面

    畫面上會顯示 Cloud Scheduler 工作清單。

  2. [選用] 找出與觸發程序相關聯的 Cloud Scheduler 工作:

    1. 執行下列指令來取得觸發條件 ID,其中 TRIGGER_NAME 是觸發條件的名稱:

      gcloud builds triggers describe TRIGGER_NAME
      
    2. 記下觸發 ID。

    3. 在表格頂端的篩選列中輸入觸發條件 ID。

    畫面上會顯示與觸發程序相關聯的 Cloud Scheduler 工作清單。

  3. 按一下要更新的工作名稱所在資料列。

  4. 按一下頁面頂端的「Edit」(編輯)

    系統會顯示表單,供您更新 Cloud Scheduler 工作。

  5. 在「內文」欄位中更新修訂內容。

  6. 按一下「更新」

您已更新與 Cloud Scheduler 工作觸發條件相關聯的修訂版本。

移除 Cloud Scheduler 工作

刪除停用觸發條件時,系統「不會」自動刪除或停用您排定觸發條件時自動建立的所有 Cloud Scheduler 工作。工作會繼續存在,建構作業也可能繼續叫用。

如要確保觸發條件不會在指定時間執行,請刪除 Cloud Scheduler 工作

後續步驟