查看 Application Integration 支援的連接器。

Solace 觸發條件

Solace 觸發條件是連接器事件觸發條件，可讓您根據在 Solace 連線中訂閱的 Solace 事件叫用整合。

事前準備

如果您打算為 Solace 觸發條件建立或設定新的連線，請確認您在專案中具備下列 IAM 角色：

• 連接器管理員 (roles/connectors.admin)

如要進一步瞭解如何授予角色，請參閱「管理存取權」。

將下列 IAM 角色授予要用於 Solace 觸發事件的服務帳戶：

• Application Integration 叫用者 (roles/integrations.integrationInvoker)

如要瞭解如何將角色授予服務帳戶，請參閱「管理服務帳戶的存取權」。

新增 Solace 觸發條件

如要將 Solace 觸發條件新增至整合，請執行下列步驟：

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

   前往「應用程式整合」

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

   系統隨即會顯示「Integrations List」頁面，列出 Google Cloud 專案中可用的所有整合項目。

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

   如果您要建立新的整合功能：

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

   新建立的整合服務會在整合服務編輯器中開啟。

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

如要設定 Solace 觸發事件，您可以使用整合連接器中現有的 Solace 連線，也可以使用內嵌連線建立選項建立新的 Solace 連線。

使用現有連線設定 Solace 觸發條件

您可以使用 Integration Connectors 中的現有 Solace 連線，設定 Solace 觸發條件。請注意，Solace 觸發條件是連接器事件觸發條件，因此您只能使用已啟用事件訂閱的 Solace 連線來設定觸發條件。

如要瞭解如何使用新的 Solace 連線設定 Solace 觸發事件，請參閱「使用新的連線設定 Solace 觸發事件」。

如要使用現有的 Solace 連線設定 Solace 觸發條件，請執行下列步驟：

1. 按一下整合服務編輯器中的「Solace trigger」元素，開啟觸發條件設定窗格。
2. 按一下「設定觸發條件」。
3. 在「連接器事件觸發條件編輯器」頁面中提供下列設定詳細資料：
   1. 區域：選取 Solace 連線的區域。
   2. 連線：選取要使用的 Solace 連線。

      應用程式整合功能只會顯示已啟用事件訂閱功能的有效 Solace 連線。

   3. 選取 Queue 或「主題」做為 JMS Source Type。
      • 如果選取 Queue，請在 JMS Source Name 欄中提供 Solace 佇列名稱。
      • 如果您選取 Topic，請在「JMS Source Name」欄中提供 Solace 主題名稱。
   4. 服務帳戶：選取具備 Solace 觸發條件必要 IAM 角色的服務帳戶。
4. 按一下「完成」即可完成觸發條件設定，並關閉頁面。

使用新連線設定 Solace 觸發條件

如要使用新的 Solace 連線設定 Solace 觸發事件，請執行下列步驟：

1. 按一下整合服務編輯器中的「Solace trigger」元素，開啟觸發條件設定窗格。
2. 按一下「設定觸發條件」。
3. 略過「區域」欄位。
4. 按一下「連線」，然後在下拉式選單中選取「建立連線」選項。
5. 在「建立連線」窗格中完成下列步驟：
   1. 在「位置」步驟中，選擇新 Solace 連線的位置：
      1. 區域：從下拉式清單中選取位置。

         如需所有支援地區的清單，請參閱「位置」一節。

      2. 點按「Next」。
   2. 在「連線詳細資料」部分中，完成下列操作：
      1. 連接器：從可用連接器的下拉式清單中選取「Solace」。
      2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
      3. 在「Connection Name」欄位中，輸入連線例項的名稱。

         連線名稱必須符合下列條件：

         • 連線名稱可以包含英文字母、數字或連字號。
         • 字母必須為小寫。
         • 連線名稱的開頭必須是英文字母，結尾則須為英文字母或數字。
         • 連結名稱不得超過 49 個半形字元。
         • 如果連接器支援事件訂閱，則連線名稱開頭不得為「goog」前置字串。
      4. 視需要輸入連線例項的「Description」(說明)。
      5. 服務帳戶：選取具備必要角色的服務帳戶。
      6. 如要將連線用於事件訂閱，請選取「啟用事件訂閱」。選取這個選項後，系統就會啟用事件訂閱功能，並提供動作。
      7. Message VPN：您要連線的 Solace Pub/Sub+ 訊息路由器 Message VPN。連線是專屬於 Message VPN，如果您有許多訊息 VPN，則必須為每個訊息 VPN 建立個別的連線。
      8. 預設佇列名稱：預設佇列的名稱，執行動作時可能會覆寫。
      9. 預設主題名稱：要連線的主題名稱。
      10. (選用) 如要使用 SSL，請選取「啟用 SSL」，然後指定 SSL 設定詳細資料。
      1. 選取信任存放區類型。您可以指定「公開」、「私人」或「不安全的連線」。
      2. 根據信任存放區選項選取憑證。舉例來說，如果您選取「Private」(私人)，請指定自訂信任存放區。
      3. 如果您使用 mTLS，請在「Key Store」部分選取金鑰庫憑證。
      4. 視需要選取 TLS 版本。
      5. 輸入支援的加密套件。請輸入多個加密套件，並以半形逗號分隔值。詳情請參閱「支援的加密組合」。
      11. (選用) 設定連線節點設定。
      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。處理的交易量越多，就需要越多節點；反之，處理的交易量越少，就需要越少節點。如要瞭解節點對連接器定價的影響，請參閱「 連線節點的定價」。如果您未輸入任何值，系統會預設將最小節點設為 2 (以提高可用性)，並將最大節點設為 50。

      12. 您可以按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
      13. 點按「Next」。
   3. 在「目的地」部分中，輸入要連線的遠端主機 (後端系統) 詳細資料。
      1. 目的地類型：選取目的地類型。
         • 從清單中選取「主機位址」，指定目的地的主機名稱或 IP 位址。
         • 如果您想建立與後端系統的私人連線，請從清單中選取「Endpoint attachment」，然後從「Endpoint Attachment」清單中選取所需的端點附件。

         如果您想建立與後端系統的公開連線，並提供額外安全性，建議您為連線設定靜態外連 IP 位址，然後設定防火牆規則，只允許特定靜態 IP 位址進入白名單。

      2. 點按「Next」。
   4. 在「Authentication」部分中，輸入驗證詳細資料。
      1. 選取「驗證類型」並輸入相關詳細資料。

         Solace 連線支援下列驗證類型：

         • 匿名
         • 使用者名稱和密碼

      如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

      2. 點按「Next」。
   5. 在「事件訂閱詳細資料」部分，設定事件相關詳細資料。
      • 輸入死信設定。如果您設定無效信件，連線會將未處理的事件寫入指定的 Pub/Sub 主題。輸入下列詳細資料：
        1. 死信專案 ID： 您設定死信 Pub/Sub 主題的 Google Cloud 專案 ID。
        2. 無效信件主題： 您要寫入未處理事件詳細資料的 Pub/Sub 主題。
   6. 查看：查看連線和驗證詳細資料。
   7. 按一下 [建立]。

   觸發輸出

   Solace 觸發事件需要幾分鐘的時間才能完成事件訂閱設定。您可以在觸發事件設定窗格中的「事件訂閱詳細資料」下方，查看事件訂閱的狀態。

   Solace 觸發事件會使用下列狀態表示事件訂閱狀態：

   • restart_alt Creating：表示觸發事件正在訂閱事件訂閱項目。
   • check_circle Active：表示觸發事件已成功訂閱事件訂閱項目。
   • error Error：表示已設定的事件訂閱項目發生問題。

   除了事件訂閱狀態之外，「事件訂閱詳細資料」部分還會顯示其他詳細資料，例如連線區域、連線名稱和事件訂閱名稱。

   觸發輸出變數

   對於每個事件，Solace 觸發條件會產生 ConnectorEventPayload 輸出變數 (以 JSON 格式表示)，可用於後續工作。輸出變數會包含 Solace 事件的酬載。例如：

   {
   "message": "Hello world",
   "messageContentType": "Text"
   }

   查看事件訂閱項目

   如要在 Integration Connectors 中查看及管理與連線相關聯的所有事件訂閱，請按照下列步驟操作：

   1. 前往「Integration Connectors」>「Connections」頁面。

      前往「連線」頁面

   2. 按一下要查看訂閱項目的連線。
   3. 按一下「事件訂閱」分頁標籤。

      這會顯示連線的所有事件訂閱項目。

   編輯 Solace 觸發條件

   您可以編輯 Solace 觸發事件，變更或更新連線設定和事件訂閱詳細資料。

   如要編輯 Solace 觸發條件，請執行下列步驟：

   1. 按一下整合服務編輯器中的「Solace trigger」元素，開啟觸發條件設定窗格。
   2. 按一下「設定 Solace 觸發條件」。
   3. 在「Connector Event Trigger Editor」頁面中執行下列操作：
      1. 如要保留先前設定的事件訂閱項目，請按一下「保留」，否則請按一下「刪除」。
      2. 視需要更新連線設定和事件訂閱詳細資料。
      3. 按一下 [完成]。

   您可以在「事件訂閱詳細資料」下方的觸發事件設定窗格中，查看更新後的連線和事件訂閱詳細資料。

   配額與限制

   如要進一步瞭解配額和限制，請參閱「配額與限制」。

   後續步驟

   • 瞭解所有工作和觸發條件。
   • 瞭解如何測試及發布整合。
   • 瞭解 錯誤處理。
   • 瞭解整合執行記錄。