排定建構作業

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

事前準備

  • 如果尚未啟用，請啟用 Cloud Build API。

    啟用 API 時所需的角色

    如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

  • 準備好原始碼。
  • 如果尚未建立手動觸發條件，請先完成這項作業。只有在觸發條件為手動觸發時，才能排定建構作業。
  • 如果您打算為建構觸發條件使用使用者指定的服務帳戶，請務必準備好該服務帳戶的電子郵件地址。您必須授予排程服務帳戶使用權限。

排定建構作業

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

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

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

    開啟「觸發條件」頁面

  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 工作最多可能需要一小時才會恢復運作。

    如果手動觸發程序使用使用者指定的服務帳戶，您也必須在使用者指定的服務帳戶中，將「服務帳戶使用者」 (roles/iam.serviceAccountUser) 角色授予預設排程服務帳戶。如果沒有這個角色，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 工作。舉例來說，如果您更新手動觸發程序的 branch 名稱，就必須手動更新作業中的 branch 名稱。

如要更新 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. 按一下「Update」。

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

移除 Cloud Scheduler 工作

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

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

後續步驟