排定建構作業

本頁面說明如何使用Google Cloud 主控台,依預先定義的時間表執行建構作業。如要排定建構作業,您必須建立手動觸發條件,然後使用 Cloud Scheduler 叫用觸發條件。

事前準備

  • Enable the Cloud Build API.

    Enable the API

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

排定建構作業

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

如要排定建構作業,請按照下列步驟操作:

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

    開啟「觸發條件」頁面

  2. 找出要依排程執行的手動觸發條件名稱所在的資料列。

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

  4. 按一下「依排程執行」,即可排定建構作業。

    您會在右側看到「按時執行觸發事件」面板。

  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 工作,請按一下「查看」。否則請按一下「完成」關閉面板。

更新 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 工作

後續步驟