创建 Cloud Tasks 队列

本页面介绍如何使用 gcloud CLI 的 gcloud 命令创建 Cloud Tasks 队列。

准备工作

队列名称由三个部分组成：项目 ID、位置和队列 ID。 所有目标类型都必须具有 Google Cloud 项目，用于提供项目 ID。

如果您使用的是 App Engine 目标任务，则还必须具有 App Engine 应用。该应用位于特定的区域，且此区域被用作队列名称的位置部分，因此请在添加应用时记下它。此位置是队列和处理程序运行的位置。

注意：App Engine 命令中名为 europe-west 和 us-central 的两个位置在 Cloud Tasks 命令中分别称为 europe-west1 和 us-central1。

另一方面，使用 HTTP Target 任务不需要 App Engine 应用。在创建队列时，您可以选择 Google Cloud 位置。

创建 Cloud Tasks 队列

使用 Google Cloud SDK 创建队列：

    gcloud tasks queues create QUEUE_ID --location=LOCATION_NAME

请替换以下内容：

• LOCATION_NAME：运行队列的位置，例如 europe-west4。

  • 如果您的组织限制资源位置，并且您希望在 us-central1 或 us-central2 中创建队列，那么组织政策必须同时在 us-central1 和 us-central2 中创建队列（即使您只需要在其中一个区域创建一个队列）。

• QUEUE_ID：您为队列分配的标识符，例如 my-queue。

注意：如果要为 App Engine 队列配置路由，但未显式设置包含相应工作器的目标服务，则使用默认服务。如需了解详情，请参阅配置 Cloud Tasks 队列。

新创建的队列可能需要几分钟时间才能使用。然后，使用 describe 验证您的队列是否创建成功：

   gcloud tasks queues describe QUEUE_ID

输出应如下所示：

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

如果您没有看到上述输出结果，可以尝试以下操作：

• 等待至少一分钟时间，以便队列进行初始化。

• 确保不存在有相同 ID 的队列。您可以调用以下命令来查看项目中的队列：

  gcloud tasks queues list --location=LOCATION_NAME

  如要搜索多个位置，您需要发出多个请求。

• 检查您是否已达到队列上限：

  转到“Cloud Tasks API”页面

  并选择配额。

  如需提高资源限制，请从 Google Cloud 控制台的“配额”页面选择修改配额。

• 检查命令的各个部分，并重新运行命令。

注意：默认情况下，系统不会为队列启用日志记录。如需了解如何启用日志记录，请参阅将 Cloud Logging 与队列搭配使用。

后续步骤

• 了解如何配置 Cloud Tasks 队列。
• 如需详细了解队列管理，请参阅 RPC API 参考文档。
• 参阅 REST API 参考，了解队列管理。
• 查看 Cloud Tasks gcloud 命令的完整列表。