排定 HTTP Cloud Run 函式

本教學課程說明如何指定 Cloud Scheduler 中的 HTTP 端點，排定 HTTP Cloud Run 函式的執行時間。如果函式需要網址端點並回應 HTTP 要求 (例如 Webhook)，請使用 HTTP 函式。

或者，如果您根據 CloudEvents 建立事件導向函式，請使用 Eventarc 觸發條件，排定函式回應專案中的事件。Eventarc 可觸發 Pub/Sub 主題訊息、Cloud Storage bucket 變更等。詳情請參閱「編寫 Cloud Run 函式」。

安排 Cloud Run 函式的執行作業是 Cloud Scheduler 的常見用途。在這個教學課程中，您將執行下列操作：

1. 建立 HTTP Cloud Run 函式。
2. 建立 Cloud Scheduler 工作。
3. 執行 Cloud Scheduler 工作。
4. 在 Cloud Run functions 驗證結果。

費用

在本文件中，您會使用下列 Google Cloud計費元件：

• Cloud Run
• Cloud Scheduler

您可以使用 Pricing Calculator，根據預測用量估算費用。

初次使用 Google Cloud 的使用者可能符合免費試用期資格。

事前準備

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

3. Verify that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build, Cloud Run Admin, Cloud Scheduler APIs, if any are not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the APIs

5. Create a service account:

   1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

   2. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   3. Select your project.

   4. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   5. Click Create and continue.

   6. Grant the following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   7. Click Continue.

   8. Click Done to finish creating the service account.

請注意，您必須授予 Cloud Run 叫用者角色，因為在 Cloud Run functions 中，叫用權限是透過管理基礎 Cloud Run 服務來提供。

必要的角色

如要取得完成教學課程所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

• Cloud Run 來源開發人員 (roles/run.sourceDeveloper)
• Cloud Scheduler 管理員 (roles/cloudscheduler.admin)
• 記錄檔檢視存取者 (roles/logging.viewAccessor)
• 專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin)
• 服務帳戶管理員 (roles/iam.serviceAccountAdmin)
• 服務帳戶使用者 (roles/iam.serviceAccountUser)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

注意：IAM 基本角色可能也包含完成教學課程所需的權限。請勿在正式環境中授予基本角色，但可以在開發或測試環境中授予。

授予角色

控制台

1. 前往 Google Cloud 控制台的「IAM」頁面。

   前往「IAM」頁面
2. 選取專案。
3. 按一下「Grant access」(授予存取權)。

4. 在「New principals」(新增主體) 欄位中，輸入您的使用者 ID。通常是部署 Cloud Run 服務時使用的電子郵件地址。

5. 在「Select a role」(選取角色) 清單中，選取角色。
6. 如要授予其他角色，請按一下「Add another role」(新增其他角色)，然後新增其他角色。
7. 按一下 [儲存]。

gcloud

如要將必要的 IAM 角色授予專案中的帳戶，請按照下列步驟操作：

     gcloud projects add-iam-policy-binding PROJECT_ID \
         --member=PRINCIPAL \
         --role=ROLE
     

更改項目：

• PROJECT_NUMBER 替換為您的 Google Cloud 專案編號。
• 將 PROJECT_ID 替換為 Google Cloud 專案 ID。
• PRINCIPAL 替換為您要新增繫結的帳戶。通常是部署 Cloud Run 服務時使用的電子郵件地址。
• ROLE：要新增至部署者帳戶的角色。

建立 HTTP Cloud Run 函式

建立由 Cloud Scheduler 觸發的 HTTP 函式。

1. 在 Google Cloud 控制台，依序前往「Cloud Run」>「Services」(服務) 頁面。

   前往「Service」分頁

2. 點選「編寫函式」。

3. 在「Configure」(設定) 部分，執行下列操作：

   1. 在「Service name」(服務名稱) 欄位中，輸入函式名稱。
   2. 在「Region」(區域) 清單中選取區域。
   3. 請勿修改預設執行階段語言。

   4. 在「驗證」部分，選取「需要驗證」。

      如果您的專案受到網域限制組織政策約束，無法叫用未經驗證的服務，則須按照「測試私人服務」一節所述的方式，存取已部署的服務。

      詳情請參閱「驗證總覽」。

4. 其餘設定均採用預設值，然後點選「建立」。

5. 複製函式的 HTTP 網址。

如要瞭解如何使用 Terraform 部署 Cloud Run 函式等資訊，請參閱「部署 Cloud Run 函式」。

建立 Cloud Scheduler 工作

建立 Cloud Scheduler 工作，使用 HTTP 觸發動作。

1. 在 Google Cloud 控制台，依序前往「Cloud Scheduler」>「Jobs」(工作) 頁面。

   前往「Jobs」(工作) 頁面

2. 按一下「Create job」(建立工作)。

3. 輸入工作名稱。

4. 在「Region」(區域) 清單中選取區域。

5. 使用 unix-cron 格式指定工作頻率：

   30 16 * * 7
   

   詳情請參閱「Cron 工作格式和時區」。

6. 在「Timezone」(時區) 清單中選取時區。

7. 按一下「繼續」。

8. 在「Target type」(目標類型) 清單中，選取「HTTP」。

9. 在「URL」欄位中，輸入先前複製的函式 HTTP 網址。

10. 在「Auth header」(驗證標頭) 清單中，選取「Add OIDC token」(新增 OIDC 權杖)。

11. 在「Service account」(服務帳戶) 清單中，選取您先前建立的服務帳戶。

12. 在「Audience」(目標對象) 欄位中，輸入先前複製的函式 HTTP 網址。

13. 點選「建立」。

您已建立 Cron 工作，會在週日下午 4:30 執行 Cloud Run 函式。如要讓 HTTP 函式具備冪等性，並在 Cloud Scheduler 重試工作時防止重複處理，請參閱「簡化工作要求」。

執行 Cloud Scheduler 工作

現在可以執行建立的工作。

1. 在 Google Cloud 控制台，依序前往「Cloud Scheduler」>「Jobs」(工作) 頁面。

   前往「Jobs」(工作) 頁面

2. 勾選您建立的工作。

3. 按一下 「Force run」(強制執行)。

   首次叫用時，在專案中建立的第一項工作可能需要幾分鐘的時間才能設定及執行。

   工作執行後，「Status of last execution」(上次執行狀態) 應顯示 Success。

在 Cloud Run functions 中驗證結果

您可以確認 Cloud Run 函式是否成功由 Cron 工作觸發並執行。

1. 在 Google Cloud 控制台中，依序前往「Cloud Run」>「Services」(服務) 頁面。

   前往「Service」分頁

2. 如要篩選函式服務清單，請依序選取「filter_list」filter_list「篩選器」>「部署類型」>「函式」。

3. 按一下函式名稱。

   「Service details」(服務詳細資料) 頁面隨即開啟，並顯示服務指標。

4. 點選「記錄」分頁標籤。

   您應該會看到類似以下的記錄項目： POST 200 146 B 5 ms Google-Cloud-Scheduler https://FUNCTION_NAME

清除所用資源

為避免因為本教學課程所用資源，導致系統向 Google Cloud 帳戶收取費用，請刪除含有相關資源的專案，或者保留專案但刪除個別資源。

刪除專案

注意：刪除專案會造成以下影響：

• 專案中的所有內容都會遭到刪除。如果使用現有專案來進行本文中的任務，刪除專案將一併移除當中已完成的其他任務'。
• 自訂專案 ID 會消失。當您之前建立這個專案時，可能建立了想要在日後使用的自訂專案 ID。如要保留使用該專案 ID 的網址 (例如 appspot.com 網址)，請刪除在該專案中選取的資源，而不是刪除整個專案。

如果打算探索多種架構、教學課程或快速入門導覽課程，重複使用專案可避免超出專案配額限制。

1. 前往 Google Cloud 控制台的「Manage resources」(管理資源) 頁面。

   前往「Manage resources」(管理資源)

2. 在專案清單中選取要刪除的專案，然後點選「Delete」(刪除)。
3. 在對話方塊中輸入專案 ID，然後按一下 [Shut down] (關閉) 以刪除專案。

刪除教學課程資源

1. 在 Google Cloud 控制台，依序前往「Cloud Scheduler」>「Jobs」(工作) 頁面。

   前往「Jobs」(工作) 頁面

2. 勾選工作旁的核取方塊。

3. 按一下「 刪除」並確認刪除。

4. 在 Google Cloud 控制台中，依序前往「Cloud Run」>「Services」(服務) 頁面。

   前往「Service」分頁

5. 勾選服務旁的核取方塊。

6. 按一下「 刪除」並確認刪除。

7. 前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。

   前往「Service Accounts」(服務帳戶)

8. 找出您建立的服務帳戶，然後勾選旁邊的核取方塊。

9. 按一下「 刪除」並確認刪除。

後續步驟

• 簡化工作要求
• 使用 Cloud Scheduler 依排程觸發 Cloud Run
• 編寫 CloudEvents 函式，排定函式回應專案中的事件。