本頁說明如何使用Google Cloud 控制台,依預先定義的排程執行建構作業。如要排定建構作業,您必須建立手動觸發條件,然後使用 Cloud Scheduler 叫用觸發條件。
事前準備
啟用 Cloud Build API。
啟用 API 時所需的角色
如要啟用 API,您需要具備服務使用情形管理員 IAM 角色 (
roles/serviceusage.serviceUsageAdmin),其中包含serviceusage.services.enable權限。瞭解如何授予角色。- 準備好原始碼。
- 如果您尚未建立手動觸發條件,請先完成這項作業。只有在觸發條件為手動觸發條件時,您才能排定建構作業。
- 如要為建構觸發條件使用使用者指定的服務帳戶,請準備好該服務帳戶的電子郵件地址。您需要授予排程服務帳戶使用該帳戶的權限。
排定建構作業
建立手動觸發條件後,即可排定建構作業。
如要安排建構時間,請按照下列步驟操作:
開啟「觸發條件」頁面:
找出包含要排定時間執行的手動觸發程序名稱的資料列。
按一下觸發條件所在資料列最右側的「動作」選單 。
按一下「Run on schedule」(依排程執行),即可安排建構作業。
右側會顯示「Run trigger on schedule」(依時間表執行觸發程序) 面板。
啟用 Cloud Scheduler API。
只有在首次排定建構作業時,系統才會提示您啟用 Cloud Scheduler API。
選取 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 就無法執行觸發程序。按一下「繼續」。
如果尚未選取區域,系統可能會提示您為 Cloud Scheduler 工作選取區域,再繼續下一個步驟。選取地區後,系統會在專案中自動建立 App Engine 應用程式。專案的地區無法變更。詳情請參閱「支援的區域」。
輸入下列 Cloud Scheduler 工作設定:
- 名稱:Cloud Scheduler 工作的名稱。
- 說明 (選用):Cloud Scheduler 工作的說明。
- 頻率:選取觸發條件的執行頻率。您可以從下拉式選單中選擇頻率,或使用 Cron 語法輸入自訂值。舉例來說,如要讓手動觸發條件每天早上 6 點執行,可以 Cron 語法指定頻率為
0 6 * * *。如要進一步瞭解 Cron 語法,請參閱「設定 Cron 工作時間表」。 - 時區:選取您的時區。
按一下「建立」,即可建立 Cloud Scheduler 工作。
每個手動觸發條件可以建立多項排程器工作。
如要查看 Cloud Scheduler 工作,請點選「View」(查看)。如要關閉面板,請點選「Done」(完成)。
更新 Cloud Scheduler 工作
如果您更新手動觸發程序中的「修訂版本」欄位,則必須手動更新與觸發程序相關聯的 Cloud Scheduler 工作。舉例來說,如果您更新手動觸發程序的分支名稱,則必須手動更新工作中的分支名稱。
如要更新 Cloud Scheduler 工作,請按照下列步驟操作:
開啟「Cloud Scheduler」頁面:
畫面上會顯示 Cloud Scheduler 工作清單。
[選用] 找出與觸發程序相關聯的 Cloud Scheduler 工作:
執行下列指令來取得觸發條件 ID,其中的 TRIGGER_NAME 是觸發條件的名稱:
gcloud builds triggers describe TRIGGER_NAME記下觸發條件 ID。
在表格頂端的篩選列中輸入觸發條件 ID。
畫面上會顯示與觸發程序相關聯的 Cloud Scheduler 工作清單。
按一下要更新的工作名稱所在資料列。
按一下頁面頂端的「Edit」(編輯)。
系統會顯示表單,供您更新 Cloud Scheduler 工作。
在「內文」欄位中,更新修訂內容。
按一下「Update」。
您已更新與 Cloud Scheduler 工作觸發條件相關聯的修訂版本。
移除 Cloud Scheduler 工作
刪除或停用觸發條件時,系統不會自動刪除或停用您排定觸發條件時自動建立的所有 Cloud Scheduler 工作。這些工作會繼續存在,且建構作業可能會繼續叫用。
如要確保觸發條件不會在指定時間執行,請刪除 Cloud Scheduler 工作。