透過 Google Cloud 控制台安排及執行 Cron 工作

透過 Google Cloud 控制台安排及執行 Cron 工作

本快速入門導覽課程說明如何使用 Google Cloud 控制台，透過 Cloud Scheduler 執行一些基本作業。

在本快速入門導覽課程中，您將：

1. 建立 Pub/Sub 主題，做為 Cloud Scheduler 工作目標。
2. 使用 Cloud Scheduler 建立 Cron 工作，並為該工作設定週期性排程。
3. 執行工作。
4. 確認工作已成功執行。

Cloud Scheduler 提供免費方案，因此執行本快速入門導覽課程不會產生任何費用。詳情請參閱「定價」。

---

如要直接在 Google Cloud 控制台中，按照這項工作的逐步指南操作，請按一下「Guide me」(逐步引導)：

「Guide me」(逐步引導)

---

事前準備

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

如要使用現有專案進行本指南中的操作，請確認您具有所需的權限。如果您建立新專案，則已具備必要權限。

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Scheduler and Pub/Sub APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

如要使用現有專案進行本指南中的操作，請確認您具有所需的權限。如果您建立新專案，則已具備必要權限。

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Scheduler and Pub/Sub APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

必要的角色

如要取得完成本快速入門導覽課程所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

• Cloud Scheduler 管理員 (roles/cloudscheduler.admin)
• Pub/Sub 編輯者 (roles/pubsub.editor)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

建立 Pub/Sub 主題和訂閱項目

Pub/Sub 主題是發布者可傳送訊息的資源。 如要接收發布至某項主題的訊息，您必須為該主題建立訂閱項目。

1. 前往 Google Cloud 控制台的 Pub/Sub 頁面。

   前往 Pub/Sub

2. 按一下「建立主題」。

3. 在「主題 ID」欄位中，輸入 cron-topic 做為主題的 ID。

4. 保留預設值，包括「新增預設訂閱項目」選項。

5. 請勿選取任何其他選項。

6. 點選「建立」。

這會建立名為 cron-topic 的 Pub/Sub 主題，以及名為 cron-topic-sub 的主題訂閱項目。

使用 Cloud Scheduler 建立 Cron 工作

設定排程工作單元 (也稱為「Cron 工作」)，根據週期性排程將工作傳送到目標。

1. 前往 Google Cloud 控制台的「Cloud Scheduler」頁面。

   前往 Cloud Scheduler

2. 按一下「Create job」(建立工作)。

3. 為工作命名。

4. 在「Region」(區域) 清單中，選取工作所在的區域。

5. 使用以 unix-cron 為基礎的格式為工作指定頻率。例如：

   30 16 * * 7
   

   詳情請參閱「設定 Cron 工作時間表」。

6. 在「時區」清單中選取時區。

   在某些時區，日光節約時間可能會導致工作意外執行或未執行。詳情請參閱「時區」。

7. 按一下「繼續」。

8. 在「目標類型」清單中，選取「Pub/Sub」。

9. 選取您先前建立的主題：cron-topic。

10. 在「Message body」(訊息內文) 欄位中，輸入要傳送至 Pub/Sub 目標主題的字串，例如：「Hello world!」

11. 點選「建立」。

您已建立一項工作，會在星期日 16:30 將訊息傳送至 Pub/Sub 主題。現在可以執行工作。

執行工作

除了按照指定時間表執行作業外，您也可以強制立即執行作業。

1. 前往 Google Cloud 控制台的「Cloud Scheduler」頁面。

   前往 Cloud Scheduler

   系統應會列出您的工作。

2. 在工作的資料列中，依序按一下「 Actions」(動作) >「Force run」(強制執行)。

   請注意，由於某些初始設定的影響，在專案中建立的第一項工作可能需要幾分鐘的時間才能執行。

3. 如果在「Status of last execution」(上次執行狀態) 欄中看到 Success 狀態，表示 Cron 工作執行成功。

接著，您可以確認 Pub/Sub 是否收到訊息。

在 Pub/Sub 中驗證結果

從訂閱項目提取 Pub/Sub 訊息，確認 Pub/Sub 主題是否收到工作傳送的訊息。

1. 前往 Google Cloud 控制台的「Pub/Sub subscriptions」(Pub/Sub 訂閱項目) 頁面。

   前往 Pub/Sub

2. 按一下 Pub/Sub 主題的訂閱項目。

3. 按一下「Messages」(訊息) 分頁標籤。

4. 按一下「Pull」(提取)。

畫面上會顯示您發布的訊息，包括訊息內文、Hello world 和訊息發布時間。

清除所用資源

為了避免系統向您的 Google Cloud 帳戶收取本頁面所用資源的費用，請按照下列步驟操作。

1. 刪除您建立的 Cron 工作：

   1. 前往 Google Cloud 控制台的「Cloud Scheduler」頁面。

      前往 Cloud Scheduler

   2. 選取工作的核取方塊。

   3. 按一下「Delete」(刪除) 並確認刪除。

2. 刪除 Pub/Sub 主題：

   1. 前往 Google Cloud 控制台的「Pub/Sub」頁面。

      前往 Pub/Sub

   2. 勾選主題的核取方塊。

   3. 按一下「Delete」(刪除) 並確認刪除。

3. 刪除 Pub/Sub 訂閱項目：

   1. 前往 Google Cloud 控制台的「Pub/Sub」頁面。

      前往 Pub/Sub

   2. 勾選訂閱項目的核取方塊。

   3. 按一下「Delete」(刪除) 並確認刪除。

4. 或者，如果您建立新專案的目的在於瞭解如何使用 Cloud Scheduler，但現在已不再需要這項專案，請刪除專案：

   注意：刪除專案會造成以下影響：

   • 專案中所有內容遭到刪除。如果使用現有專案來進行本文中的任務，刪除專案將一併移除當中已完成的其他任務'。
   • 自訂專案 ID 會消失。當您之前建立這個專案時，可能建立了想要在日後使用的自訂專案 ID。如要保留使用該專案 ID 的網址 (例如 appspot.com 網址)，請刪除在該專案中選取的資源，而不是刪除整個專案。

   如果打算探索多種架構、教學課程或快速入門導覽課程，重複使用專案可避免超出專案配額限制。

   1. In the Google Cloud console, go to the Manage resources page.

      Go to Manage resources

   2. In the project list, select the project that you want to delete, and then click Delete.
   3. In the dialog, type the project ID, and then click Shut down to delete the project.

後續步驟

• 進一步瞭解 Cloud Scheduler
• 瞭解如何查看 Cloud Scheduler 記錄檔