在升级到最新 App Engine 服务 SDK 版本之前,请先查看迁移概览。
您可以通过将 App Engine 服务 SDK 更新到最新版本来自动迁移到 Cloud Tasks。升级后,SDK 会自动为您将 PushQueue 调用重定向到 Cloud Tasks 前端 API。Cloud Tasks 会保留您现有的任务队列和任务,因此无需进行额外的迁移。
在后台,更新后的 SDK 使用 Cloud Tasks API 来保持与任务队列功能的功能对等,SDK 支持以下功能:
- 批量创建任务:SDK 使用批量 API,支持在单次调用中添加最多 100 个任务。
- 批量删除任务:SDK 使用批量 API,支持在单次调用中删除最多 1,000 个任务。
- 任务级重试:SDK 支持针对特定任务的重试配置。
- 事务性任务:SDK 会将 Datastore 事务中的任务加入队列。为保持可靠性,请创建或修改
cron.yaml文件。
价格和配额
将推送队列迁移到 Cloud Tasks 可能会影响应用的价格和配额。
价格
在迁移之前,请查看 Cloud Tasks 价格以估算您的每月费用。
与任务队列类似,使用 Cloud Tasks 推送目标向 App Engine 应用发送请求是免费的。不过,与任务队列不同,Cloud Tasks 会针对执行的操作(例如创建、删除或管理任务)收费。与免费的 App Engine 任务队列相比,这可能会导致每月总费用更高。
如果您通过升级 App Engine 服务 SDK 进行迁移,并且您的应用在 Datastore 事务中将事务性任务加入队列,则除了标准 Cloud Tasks API 结算费用之外,每个加入队列的任务都会在 Datastore 中产生 3 次写入、2 次读取和 1 次删除。
配额
Cloud Tasks 请求也会计入 App Engine 请求配额。
与任务队列一样,Cloud Tasks 具有特定于服务的配额。迁移到 Cloud Tasks 可能会更改您的配额。
优化请求延迟时间
由于更新后的 SDK 会直接向 Cloud Tasks API 发送请求,因此与旧版任务队列服务相比,按顺序将单个任务加入队列或删除单个任务可能会增加请求延迟时间。如需最大限度地缩短延迟时间,请执行以下操作:
- 将多个任务批量合并到单次调用中:将任务分组到批量添加调用(每次调用最多 100 个任务)或批量删除调用(每次调用最多 1,000 个任务)中,而不是在循环中逐个将任务加入队列或删除任务。
- 使用异步 API 调用:使用
add_async()和delete_tasks_async()等非阻塞方法,以便任务操作不会阻塞请求处理。
准备工作
在将推送队列迁移到 Cloud Tasks 之前,请完成以下步骤:
确保您有权访问 App Engine 源代码。
启用 Cloud Tasks API 和 Cloud Scheduler API:
如需确保 App Engine 服务账号具有必要的权限,以便 SDK 将任务分派到 Cloud Tasks API,请让您的管理员授予该项目的 Cloud Tasks Enqueuer (
roles/cloudtasks.enqueuer) IAM 角色。
更新 App Engine 服务 SDK
确保您的应用使用的是最新版本的 App Engine 服务 SDK。
在
requirements.txt文件中,将appengine-python-standard依赖项更新到3.1.0或更高版本,并添加google-cloud-tasks。例如:Flask==3.0.0 appengine-python-standard>=3.1.0 google-cloud-tasks
启用 Cloud Tasks 路由
runtime: python315 service: my-service-b env_variables: APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"部署应用:
gcloud app deploy如需验证您的应用是否正在使用 Cloud Tasks,请前往Google Cloud 控制台中的 Cloud Tasks 页面。
配置事务性任务(可选)
如果您的应用在 Datastore 事务中将任务加入队列,则 SDK 会依赖内部 Cron 作业来确保最终处理在数据存储区提交期间未能加入队列的所有任务。
如需处理推送队列事务性任务,请创建或更新 cron.yaml 文件,以定期调用内部处理器。例如:
cron:
- description: "Process push queue transactional tasks"
url: /_ah/cloudtask/sweep
schedule: every 30 minutes # Change this based on the usage pattern