本頁面說明如何使用 Cloud Scheduler 依排程執行 Cloud Run 工作。
必要的角色
如要取得執行本頁所述作業所需的權限,請要求管理員授予您 Cloud Run 工作的 IAM 角色:
- Cloud Scheduler 管理員 (
roles/cloudscheduler.admin),或具備cloudscheduler.jobs.create權限的自訂角色。 - Cloud Run 叫用者 (
roles/run.invoker),以便使用 Google Cloud CLI 執行工作;或 Cloud Run 開發人員 (roles/run.developer),以便使用 Google Cloud 控制台執行工作。
如要查看與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 工作與Google Cloud API (例如 Cloud 用戶端程式庫) 互動,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱「部署權限」和「管理存取權」。
事前準備
- 如果您尚未建立 Cloud Run 工作,請建立工作。
為專案啟用 Cloud Scheduler API:
gcloud services enable cloudscheduler.googleapis.com
設定 Cloud Run 工作,依排程執行
您可以使用Google Cloud 控制台、gcloud CLI 或 Terraform,設定 Cloud Run 工作依排程執行:
控制台
前往 Google Cloud 控制台的 Cloud Run 工作頁面:
按一下要依排程執行的工作。
按一下「觸發條件」分頁標籤。
按一下「Add Scheduler Trigger」(新增排程器觸發條件)。
在 Cloud Scheduler 工作表單中,按照下列步驟操作:
在「Name」(名稱) 部分,輸入 Cloud Scheduler 工作的名稱。
在「Region」(區域) 部分,選取 Cloud Scheduler 工作的區域。不一定要與 Cloud Run 工作使用的區域相同。
使用 unix-cron 格式指定工作執行頻率,例如
0 12 * * *選取時區。
按一下「繼續」。
在「Configure the execution」(設定執行作業) 區段中,選取有權叫用目前 Cloud Run 工作的服務帳戶。
按一下「Create」(建立),建立 Cloud Scheduler 工作,以指定頻率執行 Cloud Run 工作。
gcloud
執行下列指令:
gcloud scheduler jobs create http SCHEDULER_JOB_NAME \
--location SCHEDULER_REGION \
--schedule="SCHEDULE" \
--uri="https://run.googleapis.com/v2/projects/PROJECT_ID/locations/CLOUD_RUN_REGION/jobs/JOB:run" \
--http-method POST \
--oauth-service-account-email PROJECT_NUMBER-compute@developer.gserviceaccount.com
更改下列內容:
SCHEDULER_JOB_NAME:要為排程器工作指定的名稱。SCHEDULER_REGION:Cloud Scheduler 支援的區域,例如europe-west2。SCHEDULE:必要頻率,例如0 12 * * *。PROJECT_ID:您的專案 ID。CLOUD_RUN_REGION:Cloud Run 工作的區域。例如:europe-west1。JOB:Cloud Run 工作名稱。PROJECT_NUMBER:您的專案編號。
Terraform
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。
在 Terraform 設定中,將下列內容新增至google_cloud_run_v2_job 資源:Cloud Scheduler 會按照指定頻率執行 Cloud Run 工作。如要避免 Cloud Scheduler 重試要求時重複執行工作,請參閱「避免向 Google Cloud API 目標重複傳送要求」。
在 VPC Service Controls 範圍內排定工作
如果您的 Google Cloud 專案位於虛擬私有雲網路的 VPC Service Controls perimeter 內,Cloud Scheduler 與 VPC Service Controls 的整合功能支援使用下列 URI 格式,將 Cloud Run 工作設為目標:
https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB:run
更改下列內容:
PROJECT_ID: Google Cloud 專案 ID。REGION:工作的 Google Cloud 區域。JOB:Cloud Run 工作名稱。
如要進一步瞭解如何為 Cloud Run 設定 VPC Service Controls,請參閱「使用 VPC Service Controls (VPC SC)」。如要進一步瞭解如何搭配使用 Cloud Scheduler 與 VPC Service Controls,請參閱「使用 VPC Service Controls 保護 Cron 工作」。
後續步驟
使用這項功能後,您可以執行下列操作: