排定建構作業

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

事前準備

  • 啟用 Cloud Build API (如果尚未啟用)。

    啟用 API 所需的角色

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

    啟用 API

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

排定建構作業

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

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

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

    開啟「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.

    選取預設排程服務帳戶後，系統會自動為您建立該帳戶，並授予 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 工作

如果您更新手動觸發條件中的「Revision」(修訂版本) 欄位，則必須手動更新與觸發條件相關聯的 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. 在「Body」(內文) 欄位中更新修訂版本。

  6. 按一下「Update」。

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

移除 Cloud Scheduler 工作

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

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

後續步驟