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

Cloud Tasks 可让您将异步任务分派给 HTTP 目标，同时控制执行速率和重试行为。在此快速入门中，您将使用 Cloud Tasks API 创建队列，并向该队列添加 HTTP 目标任务。

准备工作

  1. 安装 Google Cloud CLI。

  2. 配置 gcloud CLI 以使用您的联合身份。

    如需了解详情，请参阅使用联合身份登录 gcloud CLI。

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

    gcloud init

  4. 创建或选择 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 项目名称。

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

  6. 启用 Cloud Tasks API：

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 获得了此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。 

    gcloud services enable cloudtasks.googleapis.com

  7. 为您的用户账号创建本地身份验证凭证： 

    gcloud auth application-default login

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

  8. 向您的用户账号授予角色。对以下每个 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：您的用户 账号。如需查看示例，请参阅 在 IAM 政策中表示员工池用户。
    • ROLE：您向用户账号授予的 IAM 角色。

创建 Cloud Tasks 队列

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

  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。

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

    gcloud logging read 'resource.type="cloud_tasks_queue" resource.labels.queue_id="QUEUE_NAME" severity>=DEFAULT' --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 项目。

删除 Google Cloud 项目：

gcloud projects delete PROJECT_ID

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

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

后续步骤