向 Cloud Tasks 队列添加 HTTP 目标任务

向 Cloud Tasks 队列添加 HTTP 目标任务

本快速入门介绍了如何使用 Cloud Tasks API 向 Cloud Tasks 队列添加 HTTP 目标任务。

准备工作

登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请 创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。
安装 Google Cloud CLI。
如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。
如需初始化 gcloud CLI，请运行以下命令：
gcloud init
创建或选择 Google Cloud 项目。
选择或创建项目所需的角色
• 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
• 创建项目：如需创建项目，您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。
注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。
• 创建 Google Cloud 项目：

  gcloud projects create PROJECT_ID

  将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

• 选择您创建的 Google Cloud 项目：

  gcloud config set project PROJECT_ID

  将 PROJECT_ID 替换为您的 Google Cloud 项目名称。
验证是否已为您的 Google Cloud 项目启用结算功能。
启用 Cloud Tasks API：
启用 API 所需的角色
如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。
gcloud services enable cloudtasks.googleapis.com
如果您使用的是本地 shell，请为您的用户账号创建本地身份验证凭证：
gcloud auth application-default login
如果您使用的是 Cloud Shell，则无需执行此操作。
如果系统返回身份验证错误，并且您使用的是外部身份提供方 (IdP)，请确认您已 使用联合身份登录 gcloud CLI。
向您的用户账号授予角色。对以下每个 IAM 角色运行以下命令一次： roles/cloudtasks.admin, roles/logging.viewer
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
替换以下内容：
• PROJECT_ID：您的项目 ID。
• USER_IDENTIFIER：您的用户 账号的标识符。例如，[e-mail]。
• ROLE：您授予用户账号的 IAM 角色。

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

创建或选择 Google Cloud 项目。

选择或创建项目所需的角色

• 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
• 创建项目：如需创建项目，您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。

注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

• 创建 Google Cloud 项目：

  gcloud projects create PROJECT_ID

  将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

• 选择您创建的 Google Cloud 项目：

  gcloud config set project PROJECT_ID

  将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

验证是否已为您的 Google Cloud 项目启用结算功能。

启用 Cloud Tasks API：

启用 API 所需的角色

如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

gcloud services enable cloudtasks.googleapis.com

如果您使用的是本地 shell，请为您的用户账号创建本地身份验证凭证：

gcloud auth application-default login

如果您使用的是 Cloud Shell，则无需执行此操作。

如果系统返回身份验证错误，并且您使用的是外部身份提供方 (IdP)，请确认您已 使用联合身份登录 gcloud CLI。

向您的用户账号授予角色。对以下每个 IAM 角色运行以下命令一次： roles/cloudtasks.admin, roles/logging.viewer

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

替换以下内容：

• PROJECT_ID：您的项目 ID。
• USER_IDENTIFIER：您的用户 账号的标识符。例如，[e-mail]。
• ROLE：您授予用户账号的 IAM 角色。

创建 Cloud Tasks 队列

使用 gcloud tasks queues create 命令创建队列。

注意： 将 Cloud Tasks gcloud 队列管理方法与基于上传 queue.yaml/queue.xml 的方法一起使用时会存在一些风险。如需了解详情，请参阅使用队列管理或 queue.yaml。

1. 在终端中，创建一个记录所有操作的队列。

   gcloud tasks queues create QUEUE_NAME \
       --log-sampling-ratio=1.0 \
       --location=REGION
   

   替换以下内容：

   • QUEUE_NAME：Cloud Tasks 队列的名称
   • REGION：您在其中部署服务或应用的受支持的区域

2. 等待队列初始化，然后验证队列是否已成功创建。

   gcloud tasks queues describe QUEUE_NAME \
       --location=REGION
   

   输出应类似如下所示：

    name: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_NAME
    rateLimits:
      maxBurstSize: 100
      maxConcurrentDispatches: 1000
      maxDispatchesPerSecond: 500.0
    retryConfig:
      maxAttempts: 100
      maxBackoff: 3600s
      maxDoublings: 16
      minBackoff: 0.100s
    state: RUNNING
   

向 Cloud Tasks 队列添加任务

使用 gcloud tasks create-http-task 命令创建以 HTTP 端点为目标的任务，并将该任务添加到队列中。

1. 创建任务，将其添加到您创建的队列，然后将该任务交付给 HTTP 端点。

   gcloud tasks create-http-task \
       --queue=QUEUE_NAME \
       --url=URL_PATH \
       --method=GET \
       --location=REGION \
       --project=PROJECT_ID
   

   将 URL_PATH 替换为请求将发送到的完整网址路径。路径必须以 http:// 或 https:// 开头，例如：https://www.example.com。

   注意： 如需定位 Cloud Run 服务或函数，请使用其默认 run.app 网址。

2. 通过读取日志验证任务是否已成功执行。

   gcloud logging read --limit=3
   

   日志应类似于以下内容：

   jsonPayload:
   '@type': type.googleapis.com/google.cloud.tasks.logging.v1.TaskActivityLog
   task: projects/PROJECT_ID/locations/REGION/queues/QUEUE_NAME/tasks/TASK_ID
   taskCreationLog:
      scheduleTime: '2024-07-04T19:00:27.801837Z'
      status: OK
      targetAddress: GET https://www.example.com/
      targetType: HTTP
   

清理

为避免因本页面中使用的资源导致您的 Google Cloud 账号产生费用，请删除包含这些资源的 Google Cloud 项目。

注意：删除项目会产生以下影响：

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

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

删除 Google Cloud 项目：

gcloud projects delete PROJECT_ID

或者，您也可以删除 Cloud Tasks 队列：

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

后续步骤

• 管理队列和任务
• 创建 Cloud Tasks 队列
• RPC API 参考文档
• REST API 参考文档