設定 Eventarc 觸發條件

本頁說明如何在 Application Integration 中設定 Eventarc 觸發條件。

您可以透過 Eventarc 觸發條件，根據透過 Eventarc Standard 轉送的事件執行整合項目。您可以使用 Eventarc 觸發條件，建構由各種 Google Cloud 服務、第三方服務和自訂事件來源的事件觸發的整合流程。舉例來說，您可以在新物件上傳至 Cloud Storage bucket 時，使用觸發條件啟動整合。

在 Google Cloud 控制台中，您可以透過下列方式建立及設定 Eventarc 觸發條件：

事前準備

設定 Eventarc 觸發條件前，請先啟用 Eventarc API 和 Pub/Sub API：

啟用 API 時所需的角色

您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

注意事項

設定 Eventarc 觸發條件時，請注意下列事項：

  • 如果整合項目發布期間，因設定錯誤而無法建立 Eventarc 觸發條件，整合項目仍會發布，但觸發條件不會啟用。

    如要修正這個問題，請取消發布整合作業、仔細檢查並修正 Eventarc 觸發條件設定，然後重新發布整合作業。如要查看 Eventarc 觸發條件建立狀態，請點選 Google Cloud 控制台工具列中的「通知」。

  • 發布新版整合功能時，如果修改了 Eventarc 觸發條件設定，系統會自動以新觸發條件取代舊觸發條件。這樣可確保整合功能一律使用最新的觸發條件設定，並刪除所有過時的觸發條件。
  • 如果您發布新版整合項目，並使用相同的 Eventarc 觸發條件及其設定，系統不會建立新的觸發條件。而是會重複使用現有的 Eventarc 觸發條件，用於新的整合版本。

從 Application Integration 建立 Eventarc 觸發條件

如要透過 Application Integration 建立 Eventarc 觸發條件，請按照下列步驟操作：

  1. 在 Application Integration 中新增 Eventarc 觸發條件
  2. 在整合編輯器中設定 Eventarc 觸發條件

新增 Eventarc 觸發條件

如要將 Eventarc 觸發條件新增至整合服務，請完成下列步驟：

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

    前往「Application Integration」

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

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

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

    如要建立新的整合功能：

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

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

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

設定 Eventarc 觸發條件

如要設定 Eventarc 觸發條件，請在整合服務編輯器中點選「Eventarc 觸發條件」元素。「Eventarc 觸發條件」設定窗格隨即顯示，內含下列欄位：

  • 標籤： (選填) 整合中 Eventarc 觸發條件的顯示名稱。你可以將標籤改為所選名稱。
  • 附註： (選填) 您可以新增附註，提供有關觸發條件的其他資訊。
  • 按一下「設定 Eventarc 觸發條件」，並在「Eventarc 觸發條件編輯器」中提供下列輸入內容：
    • 觸發條件名稱：輸入觸發條件的名稱。
    • 觸發條件類型：選取下列其中一種觸發條件類型：
      • Google 來源：選取這個選項，即可為 Pub/Sub、Cloud Storage、Firestore 和其他 Google 事件供應商建立觸發條件。
      • 自訂：選取這個選項，為自訂事件來源建立觸發條件。
      • 第三方：選取這個選項，為提供 Eventarc 來源的非 Google 供應商建立觸發條件。詳情請參閱「Eventarc 中的第三方事件」。
    • 事件提供者：選取觸發條件的事件提供者。活動供應商清單取決於觸發類型。詳情請參閱「事件供應商和目的地」。
    • 活動類型：選取觸發條件的活動類型。觸發條件設定會因您選取的事件供應商而異。詳情請參閱「事件類型」。
    • 「Region」(區域)：選取觸發條件的區域。
    • 篩選器：(選用) 新增篩選器，選取符合條件的 API。舉例來說，如果您依特定名稱篩選 API，只有在符合篩選條件的 API 更新時，才會觸發事件。
    • 服務帳戶：選取要用於觸發條件的服務帳戶。如未選取服務帳戶，觸發程序在叫用服務時，會使用 Compute Engine 預設服務帳戶做為身分。與觸發條件相關聯的服務帳戶必須具備叫用服務的必要權限。

    • 「Retry on failure」(失敗時重試)：選取這個選項，即可在目的地無法處理事件時重試觸發程序。
    • 「網路連結」：選取要用於觸發程序的網路連結。這份清單是根據您專案中建立的網路附件產生。

      網路附件可促進服務供應商虛擬私有雲網路與消費者虛擬私有雲網路之間的通訊。Eventarc 會使用設定的網路連結，與消費者虛擬私有雲網路中託管的內部 HTTP 端點建立連線，以便傳送事件資料。如要進一步瞭解如何建立及管理網路連結，請參閱「建立及管理網路連結」。

  • 如要儲存觸發條件設定，請按一下「儲存觸發條件」。

使用 Eventarc 控制台建立 Eventarc 觸發條件

如要從 Eventarc 控制台頁面建立 Eventarc 觸發條件，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，依序前往「Eventarc」>「Triggers」(觸發條件) 頁面。

    前往「Triggers」(觸發條件)

    「觸發條件」頁面會列出專案中的所有觸發條件。

  2. 按一下「建立觸發條件」。
  3. 在「建立觸發條件」頁面中，提供下列輸入內容：
    1. 觸發條件名稱：輸入觸發條件的名稱。
    2. 觸發條件類型：選取下列其中一種觸發條件類型：
      • Google 來源：選取這個選項，為 Pub/Sub、Cloud Storage、Firestore 和其他 Google 事件供應商建立觸發條件。
      • 自訂：選取這個選項，為自訂事件來源建立觸發條件。
      • 第三方：選取這個選項，為提供 Eventarc 來源的非 Google 供應商建立觸發條件。詳情請參閱「Eventarc 中的第三方事件」。
    3. 事件提供者：選取觸發條件的事件提供者。活動供應商清單取決於觸發類型。詳情請參閱「事件供應商和目的地」。
    4. 活動類型：選取觸發條件的活動類型。觸發條件設定會因您選取的事件供應商而異。詳情請參閱「事件類型」。
    5. 事件資料內容類型：選取事件內容的資料類型。選取「application/json」或「application/protobuf」。
    6. 「Region」(區域)：選取觸發程序的區域。
    7. 服務帳戶：選取要用於觸發條件的服務帳戶。如未選取服務帳戶，觸發程序在叫用服務時，會使用 Compute Engine 預設服務帳戶做為身分。與觸發條件相關聯的服務帳戶必須具備叫用服務所需的權限。
    8. 事件目的地：選取「應用程式整合」。
    9. 選取整合：選取要建立觸發條件的整合。如果整合項目已發布，Application Integration 會建立新的草稿版本，以便在其中新增 Eventarc 觸發條件。
    10. 「網路連結」：選取要用於觸發程序的網路連結。這份清單是根據您專案中建立的網路附件產生。

      網路附件可促進服務供應商虛擬私有雲 (VPC) 網路與消費者虛擬私有雲網路之間的通訊。Eventarc 會使用設定的網路連結，與消費者虛擬私有雲網路中託管的內部 HTTP 端點建立連線，以便傳送事件資料。如要進一步瞭解網路連結，請參閱「關於網路連結」。

  4. 按一下「Open integration」。

    系統會開啟「Application Integration」編輯器頁面，並選取整合服務，且在整合服務中新增 Eventarc 觸發條件元素。

  5. 按一下「Eventarc 觸發條件」元素，開啟觸發條件設定窗格。
  6. 在 Eventarc 觸發條件編輯器頁面中，檢查並驗證觸發條件設定。
  7. 將新的 Eventarc 觸發條件連結至整合流程，然後發布整合。