Cloud Scheduler 快速入门

本快速入门将引导您使用 Cloud Scheduler 执行以下基本操作:

  • 创建 Cloud Scheduler 作业。
  • 为作业设置周期性计划。
  • 将 Cloud Pub/Sub 主题指定为作业目标。
  • 运行作业。
  • 验证运行是否成功。

Cloud Scheduler 提供免费层级,因此运行此快速入门不会产生任何费用。要了解详情,请参阅价格

准备工作

使用以下说明为本快速入门做准备。您可能已经完成了其中一些步骤。

安装并配置 gcloud 命令行工具:

  1. 安装并初始化 Cloud SDK

  2. 为产品添加 gcloud 组件:

     gcloud components install
    
  3. 更新所有组件:

     gcloud components update
    

使用 App Engine 应用创建项目

或者您可以使用现有项目(如有)。

  1. 在安装了 Cloud SDK 的机器上打开终端并创建 GCP 项目:

     gcloud projects create [PROJECT_ID]
    

    其中 PROJECT_ID 是您要创建的项目的 ID。项目 ID 必须以小写字母开头,可以包含小写 ASCII 字母、数字或连字符。长度必须介于 6 到 30 个字符之间。

  2. 配置 gcloud 以使用您选择的项目:

     gcloud config set project [PROJECT-ID]
    

    其中 PROJECT_ID 是您之前设置的 ID。

  3. 现在创建应用

     gcloud app create [--region=REGION]
    

    其中 [REGION] 是应用运行所在的位置。请注意,App Engine 命令中名为 europe-westus-central 的两个位置在 Cloud Tasks 命令中分别称为 europe-west1us-central1

    您可以使用以下命令检查现有应用的区域:

     gcloud app describe
    

    区域按 locationId 列出,例如 locationId: us-central

    为 App Engine 应用设置地区后,您无法更改它。

使用 Google Cloud Platform Console 启用功能:

  1. 为您的项目启用结算功能

  2. 启用 Cloud Scheduler API

  3. 启用 Cloud Pub/Sub API

使用 gcloud 设置 Cloud Pub/Sub:

  1. 设置 Cloud Pub/Sub 主题以用作 cron 作业的目标:

    gcloud pubsub topics create cron-topic
    

    此命令将创建一个名为“cron-topic”的主题。记下该名称,因为您稍后会在本快速入门中用到。

  2. 创建 Cloud Pub/Sub 订阅;你需要借助它来查看作业的结果。

    gcloud pubsub subscriptions create cron-sub --topic cron-topic
    

创建作业

  1. 访问控制台中的 Cloud Scheduler 页面:

    Cloud Scheduler

  2. 点击创建作业按钮。

  3. 为您的作业命名,并视需要添加说明。

    图片

  4. 使用 unix-cron 格式指定作业的频率

    * * * * *
    

    如需了解详情,请参阅配置 Cron 作业时间表。熟悉 App Engine Cron 格式的开发者也可以使用此格式。

  5. 选择您所在的时区。

  6. 目标字段中,从下拉菜单中选择 Pub/Sub 主题,然后输入您刚才创建的主题 (cron-topic)。

  7. 添加要发送到您的 Cloud Pub/Sub 目标的负载字符串。

    图片

  8. 点击创建

您现在将获得每分钟向您的 Cloud Pub/Sub 主题发送一条消息的作业。让我们运行您刚刚创建的作业。

运行作业

  1. 在随项目打开的 Cloud Scheduler 控制台页面中,点击立即运行按钮。

    由于进行相关必要配置,在项目中创建的第一个作业可能需要几分钟才能在第一次调用时运行。所以您可能需要等待一会儿。

  2. 在“结果”列下查看结果。

    图片

恭喜!您刚刚在控制台中查看了运行向 Cloud Pub/Sub 发送一条消息的 cron 作业的结果。接下来,您将了解如何验证 Cloud Pub/Sub 是否成功收到该消息。

验证 Cloud Pub/Sub 中的结果

要验证您的 Cloud Pub/Sub 主题是否将收到来自作业的消息,请执行以下操作:

  1. 调用以下命令:

     gcloud pubsub subscriptions pull cron-sub --limit 5
    
  2. 查看结果。您将看到如下所示的输出:

     +-------------+----------------+------------+-----------------------------+
     | DATA        | MESSAGE_ID     | ATTRIBUTES | ACK_ID                      |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56344662920621 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340561244339 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340388879975 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337745052761 |            | EkwnGERJUytDCypYEU4EISE...  |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337890896134 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
    

清理

为避免系统因本快速入门中使用的资源向您的 GCP 帐号收取费用,请执行以下操作:

删除 Cloud Scheduler 作业

  1. 转到 GCP Console 中的 Cloud Scheduler 页面。

    转到“Cloud Scheduler”页面

  2. 点击作业旁边的复选框。

  3. 点击页面顶部的删除按钮并确认删除操作。

删除 Pub/Sub 主题

  1. 转到 GCP Console 中的 Cloud Pub/Sub 页面。

    转到 Pub/Sub 页面

  2. 点击主题旁边的复选框。

  3. 在页面顶部,点击删除并确认删除操作。

删除项目

如果您为本快速入门创建了项目时需要执行此操作。

  1. 在 GCP Console 中,转到“项目”页面。

    转到“项目”页面

  2. 在项目列表中,选择要删除的项目,然后点击删除
  3. 在对话框中输入项目 ID,然后点击关闭以删除项目。

后续步骤

此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Cloud Scheduler 文档