Cloud Scheduler 觸發條件

Cloud Scheduler 觸發程序可讓您排定整合執行作業，在多個區域內以定義的時間間隔或規律間隔執行。

Cloud Scheduler 觸發程序 會運用 Cloud Scheduler 服務，在 Application Integration 中提供全代管的企業級 Cron 工作排程器。現在您可以使用這個觸發程序，透過 Application Integration UI 和 Cloud Scheduler 資訊主頁，管理整合服務中建立的所有 Cron 工作。此外，您也可以使用 Cloud Scheduler 觸發程序部署跨區域的 Cron 工作，排定整合執行作業。

舉例來說，如果您已在 us-central1 中佈建整合服務，可以在 asia-east1 (或 Cloud Scheduler 支援的任何 Google Cloud 區域) 中使用 Cloud Scheduler 觸發程序部署 Cron 工作，以便在 us-central1 中呼叫整合服務的端點。

事前準備

請務必先在 Google Cloud 專案中執行下列工作，再設定 Cloud Scheduler 觸發程序：

  1. 啟用 Cloud Scheduler API (cloudscheduler.googleapis.com)。

    啟用 Cloud Scheduler API

  2. 確認您擁有已指派「Application Integration 叫用者」角色的 Google 服務帳戶。如果沒有服務帳戶，請建立新帳戶，並指派 Application Integration Invoker 角色。

    如要瞭解如何建立及管理服務帳戶，請參閱「建立及管理服務帳戶」

    如需預先定義的 Application Integration 角色相關資訊，請參閱「預先定義的 IAM 角色」。

新增 Cloud Scheduler 觸發條件

如要為整合服務新增 Cloud Scheduler 觸發條件，請按照下列步驟操作：

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

    前往 Application Integration

  2. 在導覽選單中，按一下「整合」

    系統隨即會顯示「整合清單」頁面，列出 Google Cloud 專案中可用的所有整合功能。

  3. 選取現有整合，或按一下「建立整合」建立新整合。

    如要建立新的整合項目：

    1. 在「建立整合」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
    4. 點選「建立」。

    新建立的整合作業會在整合編輯器中開啟。

  4. 在整合服務編輯器的導覽列中，按一下「觸發條件」，即可查看可用觸發條件的清單。
  5. 在整合服務編輯器中，按一下並放置「Cloud Scheduler trigger」(Cloud Scheduler 觸發條件) 元素。

設定 Cloud Scheduler 觸發條件

如要設定 Cloud Scheduler 觸發條件，請完成下列步驟：

  1. 在整合服務編輯器中，按一下「Cloud Scheduler trigger」(Cloud Scheduler 觸發條件) 元素，開啟觸發條件設定窗格。

    使用下列任一選項，指定 Cloud Scheduler 觸發條件的排程：

    • 基本：使用使用者介面設定 Cron 工作時間表。
    • 進階：使用 unix-cron 運算式設定 Cron 工作時間表。
  2. (適用於「基本」選項) 選取「基本」分頁，並在指定欄位中執行下列操作：
    1. 時間：選取整合作業的執行時間間隔。
      • 在特定時間執行： 選取這個選項，即可在特定時間執行整合。
      • 每小時重複執行： 選取這個選項，即可每小時重複執行整合作業。
      • 每分鐘重複執行： 選取這個選項，即可根據指定的分鐘數重複執行整合作業
    2. 天數：選取整合作業的執行日期。您可以選擇每天、每週特定日期或每月的特定日期執行整合。
    3. 月份：選取整合作業必須執行的月份。你可以選擇每月或特定月份執行整合。
  3. (進階選項) 選取「進階」分頁，然後使用 Cron 運算式指定 Cron 工作排程。

    Cron 運算式有五個值，必須依下列順序指定：

    1. 分鐘 (0 到 59)
    2. 小時 (0-23)
    3. 日期 (1-31)
    4. 月份，可以是下列任一值：
      • 介於 1 至 12 之間的數字
      • 月份縮寫 (三個字母)，例如 Jan、Feb、Mar
    5. 星期幾，值為下列其中之一：
      • 數字 0 到 6，星期日為 0
      • 星期幾的三個字母縮寫 (例如：週一、週二、週三)

    舉例來說，如要在每個月的第一天執行整合，請使用 * * 1 * * cron 運算式。

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

  4. 區域： 選取要部署 Cloud Scheduler 工作的區域。
  5. 服務帳戶電子郵件地址：輸入您建立的 Google 服務帳戶電子郵件地址。

觸發輸出

針對在整合版本中設定及發布的每個 Cloud Scheduler 觸發條件，Application Integration 會在 Google Cloud 專案中建立新的 Cloud Scheduler 工作。

為避免工作重複錯誤，系統會使用下列命名慣例建立 Cloud Scheduler 工作： 

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER

示例：DemoIntegration__V1__1

觸發記錄

Cloud Scheduler 觸發條件會在每次整合執行作業開始和結束時產生記錄。您可以在 Cloud Logging 記錄檔探索工具頁面中，查看 Cloud Scheduler 觸發程序記錄：

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

    前往 Cloud Scheduler

  2. 找到 Cloud Scheduler 工作，然後按一下「記錄」欄中的「查看」。

    「Cloud Logging 記錄探索工具」頁面隨即顯示，其中列出 Cloud Scheduler 觸發程序產生的記錄。

編輯 Cloud Scheduler 觸發條件

應用程式整合

如要從 Application Integration 編輯 Cloud Scheduler 觸發條件，請按照下列步驟操作：

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

    前往 Application Integration

  2. 按一下左側導覽選單中的「整合」，開啟「整合」頁面。
  3. 選取要編輯的整合服務。
  4. 在整合服務編輯器中，按一下版本下拉式選單，然後選取要編輯的整合服務版本 (內含 Cloud Scheduler 觸發條件)。
  5. 取消發布並啟用編輯功能：如果所選整合版本已發布 (處於有效狀態)。
  6. 在整合服務編輯器中，按一下「Cloud Scheduler trigger」(Cloud Scheduler 觸發條件) 元素，開啟觸發條件設定窗格。
  7. 視需要修改 Cloud Scheduler 工作設定。

Cloud Scheduler

如要編輯 Cloud Scheduler 觸發條件，請前往 Cloud Scheduler，然後修改 Cloud Scheduler 工作的設定：

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

    前往 Cloud Scheduler

  2. 選取要編輯的 Cloud Scheduler 工作。
  3. 按一下 [編輯]。
  4. 視需要修改 Cloud Scheduler 工作設定。

暫停、繼續及複製 Cloud Scheduler 工作

使用 Cloud Scheduler 觸發條件建立的 Cloud Scheduler 工作，Application Integration 不支援暫停、繼續和複製作業。

如果您從 Cloud Scheduler 手動暫停執行 Cloud Scheduler 工作，Cloud Scheduler 觸發程序會在觸發程序設定窗格中擲回錯誤。

如要進一步瞭解 Cloud Scheduler 觸發條件錯誤訊息，請參閱「排解 Cloud Scheduler 觸發條件問題」。如要瞭解如何使用 Cloud Scheduler 暫停及恢復 Cron 工作，請參閱「暫停或恢復工作」一文。

刪除 Cloud Scheduler 工作

您可以從 Application Integration 的整合服務中，或從 Cloud Scheduler 刪除 Cloud Scheduler 工作。

應用程式整合

如要從 Application Integration 刪除 Cloud Scheduler 工作，請按照下列步驟操作：

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

    前往 Application Integration

  2. 按一下左側導覽選單中的「整合」，開啟「整合」頁面。
  3. 選取要編輯的整合服務。
  4. 在整合服務編輯器中，按一下版本下拉式選單，然後選取包含要刪除的 Cloud Scheduler 觸發條件的整合服務版本。
  5. 取消發布所選整合版本。

    系統會刪除對應整合版本的 Cloud Scheduler 工作。

Cloud Scheduler

如要從 Cloud Scheduler 刪除 Cloud Scheduler 工作，請按照下列步驟操作：

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

    前往 Cloud Scheduler

  2. 選取要刪除的 Cloud Scheduler 工作。
  3. 按一下「刪除」。

    系統會刪除對應整合版本的 Cloud Scheduler 工作。

最佳做法

最佳做法是，不再需要 Cloud Scheduler 觸發程序時，請取消發布。如果發布多餘的 Cloud Scheduler 觸發條件，該觸發條件會繼續自動叫用整合功能，可能導致產生額外費用。

排解 Cloud Scheduler 觸發條件問題

下表說明您在 Cloud Scheduler 觸發程序中可能遇到的錯誤，以及造成這些錯誤的原因。

錯誤位置 發生錯誤 錯誤訊息 可能原因 解析度
觸發條件設定窗格 > 錯誤訊息 Cloud Scheduler 工作停止執行整合作業時 The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB does not exist. It might be deleted from your Google Cloud project. 使用 Cloud Scheduler 刪除 Cloud Scheduler 工作。 建立新的整合版本，覆寫現有的 Cloud Scheduler 工作。
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project. 使用 Cloud Scheduler 暫停 Cloud Scheduler 工作。 從 Cloud Scheduler 繼續執行 Cloud Scheduler 工作。
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error. 查看觸發記錄，找出問題。 建立新的整合版本，覆寫現有的 Cloud Scheduler 工作。
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation. 提供的服務帳戶沒有必要的 IAM 權限。 如要從這個狀態還原作業，請重試 CloudScheduler.UpdateJob 作業，直到收到成功的回應為止。
The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more. CLOUD_SCHEDULER_JOB_ISSUE 不適用

「服務水準協議」排除條款

Cloud Scheduler 觸發程序取決於 Cloud Scheduler 產品。由於這項依附元件屬於 Application Integration 外部元件，因此只有在成功排定 active 整合的執行時間時，才適用 Application Integration 服務等級協議 (SLA) 條款及細則。