安排运行 HTTP Cloud Run 函数

本教程介绍了如何通过在 Cloud Scheduler 中指定 HTTP 端点来安排 HTTP Cloud Run 函数的运行时间。如果您需要函数具有网址端点并响应 HTTP 请求（例如针对 webhook），可使用 HTTP 函数。

或者，如果您创建的是 CloudEvents 函数，请使用 Eventarc 事件触发器来安排函数响应项目中的事件。Eventarc 可以触发 Pub/Sub 主题上的消息、Cloud Storage 存储桶中的更改等。如需了解详情，请参阅 Cloud Run 函数的类型。

Cloud Scheduler 的常见用例之一是安排 Cloud Run 函数的执行。在此教程中，您将学习以下操作：

1. 创建简单的 HTTP Cloud Run 函数。
2. 创建 Cloud Scheduler 作业。
3. 运行 Cloud Scheduler 作业。
4. 验证 Cloud Scheduler 作业是否会触发 Cloud Run 函数。

费用

在本文档中，您将使用 Google Cloud的以下收费组件：

• Cloud Run
• Cloud Scheduler

您可使用价格计算器根据您的预计使用情况来估算费用。

准备工作

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

Enable the APIs

Create a service account:

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

   Go to Create service account
2. Select your project.

3. 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.

4. Click Create and continue.

5. 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 Add another role and add each additional role.

6. Click Continue.

7. Click Done to finish creating the service account.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

Enable the APIs

Create a service account:

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

   Go to Create service account
2. Select your project.

3. 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.

4. Click Create and continue.

5. 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 Add another role and add each additional role.

6. Click Continue.

7. Click Done to finish creating the service account.

请注意，您必须授予 Cloud Run Invoker 角色，因为在 Cloud Run 函数中，您可以通过管理底层 Cloud Run 服务来获取调用权限。

所需的角色

如需获得完成本教程所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

• Cloud Run Source Developer (roles/run.sourceDeveloper)
• Cloud Scheduler Admin (roles/cloudscheduler.admin)
• Logs View Accessor (roles/logging.viewAccessor)
• Project IAM Admin (roles/resourcemanager.projectIamAdmin)
• Service Account Admin (roles/iam.serviceAccountAdmin)
• Service Account User (roles/iam.serviceAccountUser)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

授予角色

控制台

1. 在 Google Cloud 控制台中，前往 IAM 页面。

   前往 IAM
2. 选择相应项目。
3. 点击 person_add 授予访问权限。

4. 在新的主账号字段中，输入您的用户标识符。 这通常是用于部署 Cloud Run 服务的 Google 账号邮箱。

5. 在选择角色列表中，选择一个角色。
6. 如需授予其他角色，请点击 add 添加其他角色，然后依次添加所需角色。
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 服务的 Google 账号邮箱。
• 将 ROLE 替换为要添加到部署者账号的角色。

清理

为避免因本教程中使用的资源导致您的 Google Cloud 账号产生费用，请删除包含这些资源的项目，或者保留项目但删除各个资源。

删除项目

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

删除教程资源

1. 在 Google Cloud 控制台中，前往 Cloud Scheduler 页面。

   前往 Cloud Scheduler

2. 选择作业旁边的复选框。

3. 点击 delete 删除并确认您要删除此存储分区。

4. 在 Google Cloud 控制台中，前往 Cloud Run 页面。

   转到 Cloud Run

5. 选中相应服务旁边的复选框。

6. 点击 delete 删除并确认您要删除此存储分区。

7. 在 Google Cloud 控制台中，前往服务账号页面。

   转到“服务账号”

8. 选中您创建的服务账号旁边的复选框。

9. 点击 delete 删除并确认您要删除此存储分区。

后续步骤

• 使用 Cloud Scheduler 按计划触发 Cloud Run
• 编写 CloudEvents 函数，以安排函数响应项目中的事件。