通过升级到最新版 SDK (PHP) 将推送队列迁移到 Cloud Tasks

在升级到最新 App Engine 服务 SDK 版本之前,请先查看迁移概览。

您可以通过将 App Engine 服务 SDK 更新到最新版本来自动迁移到 Cloud Tasks。升级后,SDK 会自动为您将 PushQueue 调用重定向到 Cloud Tasks 前端 API。Cloud Tasks 会保留您现有的任务队列和任务,因此无需进行额外的迁移。

在后台,更新后的 SDK 使用 Cloud Tasks API 来保持与任务队列功能的功能对等,SDK 支持以下功能:

  • 批量创建任务:SDK 使用批量 API,支持在单次调用中添加最多 100 个任务。
  • 任务级重试:SDK 支持针对特定任务的重试配置。

价格和配额

将推送队列迁移到 Cloud Tasks 可能会影响应用的价格和配额。

价格

在迁移之前,请查看 Cloud Tasks 价格以估算您的每月费用。

与任务队列类似,使用 Cloud Tasks 推送目标向 App Engine 应用发送请求是免费的。不过,与任务队列不同,Cloud Tasks 会针对执行的操作(例如创建、删除或管理任务)收费。与免费的 App Engine 任务队列相比,这可能会导致每月总费用更高。

配额

Cloud Tasks 请求也会计入 App Engine 请求配额。

与任务队列一样,Cloud Tasks 具有特定于服务的配额。迁移到 Cloud Tasks 可能会更改您的配额。

优化请求延迟时间

由于更新后的 SDK 会直接向 Cloud Tasks API 发送请求,因此与旧版任务队列服务相比,按顺序将单个任务加入队列或删除单个任务可能会增加请求延迟时间。如需最大限度地缩短延迟时间,请执行以下操作:

  • 将多项任务批量合并到单次调用中:将任务分组到批量添加调用中(每次调用最多 100 项任务),而不是在循环中逐个将任务加入队列。

准备工作

在将推送队列迁移到 Cloud Tasks 之前,请完成以下步骤:

  1. 确保您有权访问 App Engine 源代码。

  2. 启用 Cloud Tasks API 和 Cloud Scheduler API:

    启用 API

  3. 如需确保 App Engine 服务账号具有必要的权限,以便 SDK 将任务分派到 Cloud Tasks API,请让您的管理员授予该项目的 Cloud Tasks Enqueuer (roles/cloudtasks.enqueuer) IAM 角色。

更新 App Engine 服务 SDK

  1. 确保您的应用使用的是最新版本的 App Engine 服务 SDK。

    在 composer.json 文件中,将 google/appengine-php-sdk 更新为 ^2.3 或更高版本,并添加 google/cloud-tasks。

    {
      "require": {
        "google/appengine-php-sdk": "^2.3",
        "google/cloud-tasks": "^2.3"
      }
    }
  2. 启用 Cloud Tasks 路由

    runtime: php85
    service: my-service-b
    
    env_variables:
      APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"
    
  3. 部署应用:

    gcloud app deploy
    
  4. 如需验证您的应用是否正在使用 Cloud Tasks,请前往Google Cloud 控制台中的 Cloud Tasks 页面。

后续步骤