安排 HTTP Cloud Functions 函数

---

本教程介绍如何使用 以及通过定位 HTTP 端点来使用 Cloud Scheduler。在以下情况下使用 HTTP 函数： 您需要让函数具有网址端点并响应 HTTP 请求， Webhook

请注意，您也可以 安排一个事件驱动型函数 函数被直接触发，以响应您的 例如 Pub/Sub 主题中的消息或 Cloud Storage 存储桶。如需了解详情，请参阅 Cloud Functions 的类型。

安排 Cloud Function 执行是一种常见的做法， Cloud Scheduler 的使用场景。在此教程中，您将学习以下操作：

1. 创建一个简单的 HTTP Cloud Functions 函数。
2. 创建 Cloud Scheduler 作业。
3. 运行 Cloud Scheduler 作业。
4. 验证 Cloud Function 是否由 Cloud Scheduler 作业。

费用

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

• Cloud Functions
• Cloud Scheduler

您可使用价格计算器根据您的预计使用情况来估算费用。 Google Cloud 新用户可能有资格申请免费试用。

准备工作

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

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

   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

3. 确保您的 Google Cloud 项目已启用结算功能。

4. 启用 Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler API。

   启用 API

5. 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 Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      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. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

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

   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

7. 确保您的 Google Cloud 项目已启用结算功能。

8. 启用 Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler API。

   启用 API

9. 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 Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      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. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

请注意，您必须授予 Cloud Run Invoker 角色，因为 在 Cloud Functions (第 2 代) 中， 可通过管理底层 API 来获得调用权限 Cloud Run 服务。

10. 默认情况下，Cloud Functions 函数会使用自动创建的 默认的 Compute Engine 服务账号 。您可以使用此服务账号来试用 本教程。不过，根据您的组织政策配置， 系统可能不会自动向默认服务账号授予 自己的项目如果是这种情况， 向服务账号授予 以下角色： <ph type="x-smartling-placeholder">
    </ph>
    1. Artifact Registry Writer (roles/artifactregistry.writer)
    2. 日志写入者 (roles/logging.logWriter)
    3. Storage Object Viewer (roles/storage.objectViewer)

创建 HTTP Cloud Functions 函数

创建一个由 Cloud Scheduler 触发的 HTTP 函数。

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

   转到 Cloud Functions

2. 点击 创建函数。

3. 在基本信息部分中，执行以下操作：

   1. 在环境列表中，选择第 2 代。
   2. 输入函数的名称。
   3. 在区域列表中，选择一个区域。

4. 在触发器部分中，执行以下操作：

   1. 在触发器类型列表中，选择 HTTPS。

   2. 对于身份验证，请选择需要身份验证。

      如需了解详情，请参阅 进行身份验证以进行调用（第 2 代）。

5. 接受其他默认设置，然后点击下一步。

6. 请勿修改默认运行时语言和示例代码。代码的作用 不使用任何云服务，也不需要启用其他权限。 点击部署。

7. 函数部署成功后，点击触发器标签页。

8. 复制函数的 HTTP 网址。

创建 Cloud Scheduler 作业

创建一个使用 HTTP 触发操作的 Cloud Scheduler 作业。

1. 在 Google Cloud 控制台中，转到 Cloud Scheduler 页面。

   转到 Cloud Scheduler

2. 点击 创建作业。

3. 输入作业的名称。

4. 在区域列表中，选择一个区域。

5. 使用 unix-cron 格式指定作业的频率：

   30 16 * * 7
   

   如需了解详情，请参阅 Cron 作业格式和时区。

6. 在时区列表中，选择一个时区。

7. 点击继续。

8. 在目标类型列表中，选择 HTTP。

9. 在网址字段中，输入您之前使用的函数的 HTTP 网址 已复制。

10. 在 Auth header 列表中，选择 Add OIDC token。

11. 在服务账号列表中，选择您之前使用的服务账号 创建。

12. 在受众群体字段中，输入您之前使用的函数的 HTTP 网址 已复制。

13. 点击创建。

您创建了一个 Cron 作业，该作业会在 16:30 运行您的 Cloud Function 每周日。

运行 Cloud Scheduler 作业

您现在可以运行自己创建的作业了。

1. 在 Google Cloud Console 中，前往 Cloud Scheduler 页面。

   转到 Cloud Scheduler

2. 选中您创建的作业对应的复选框，然后点击强制运行。

   初次调用时，项目中创建的第一个作业可能需要 只需几分钟即可配置和运行。

3. 作业运行后，Status of last execution（上次执行状态）应指示 Success.

验证 Cloud Functions 中的结果

您可以验证 Cloud Function 是否已成功触发 由 Cron 作业执行

1. 在 Google Cloud 控制台中，转到 Cloud Functions 页面。

   转到 Cloud Functions

2. 点击函数名称。

   函数详情页面打开，并显示了每秒调用次数图表 显示对该函数的第一次调用。

3. 点击日志标签页。

   您应该会看到类似如下的日志条目： POST 200 146 B 5 ms Google-Cloud-Scheduler https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

清理

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

删除项目

警告：删除项目会产生以下影响

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

1. 在 Google Cloud 控制台中，进入管理资源页面。

   转到“管理资源”

2. 在项目列表中，选择要删除的项目，然后点击删除。
3. 在对话框中输入项目 ID，然后点击关闭以删除项目。

删除教程资源

1. 在 Google Cloud 控制台中，转到 Cloud Scheduler 页面。

   转到 Cloud Scheduler

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

3. 点击 删除，然后确认您的 删除。

4. 在 Google Cloud 控制台中，转到 Cloud Functions 页面。

   转到 Cloud Functions

5. 选中您的函数旁边的复选框。

6. 点击 删除，然后确认您的 删除。

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

   转到“服务账号”

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

9. 点击 删除，然后确认您的 删除。

后续步骤

• 使用 Cloud Scheduler 按计划触发 Cloud Run