測試及發布整合項目

在整合服務編輯器中新增整合服務,並設定必要的觸發條件、任務和邊緣連線後,即可測試或發布整合服務。使用 Google Cloud 控制台測試整合時,整合會以同步模式執行。

必要的角色

如要取得測試或發布整合所需的權限,請要求管理員授予您專案的下列 IAM 角色:

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

這些預先定義的角色具備測試或發布整合項目所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能測試或發布整合:

  • 測試整合:integrations.integrations.invoke
  • 發布整合項目: integrations.integrationVersions.deploy

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

Application Integration 編輯者 (roles/integrations.integrationEditor) 角色包含這兩項權限。

如果整合項目使用「執行身分」服務帳戶,您也必須具備該服務帳戶的「服務帳戶使用者」(roles/iam.serviceAccountUser) 角色,才能測試或發布整合項目。請參閱「授予服務帳戶使用者角色」。

測試整合

如要確認整合功能是否正常運作,可以先進行測試再發布。測試整合作業可讓您實驗整合輸入變數值,並找出整合連線流程中的任何錯誤。

如要試行整合,請選取下列其中一個選項:

控制台

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

    前往 Application Integration

  2. 按一下左側導覽選單中的「Integrations」(整合),開啟「Integrations」(整合) 頁面。
  3. 選取要測試的整合。

  4. 在設計工具導覽列中,按一下「Test」(測試)。

    如果您在整合中設定了多個觸發條件,請選取要從哪個觸發條件測試執行整合。「Test Integration」(測試整合) 窗格隨即顯示。

  5. 按一下「測試整合」。

    Application Integration 會執行整合,並在「Test Integration」(測試整合) 窗格中顯示執行結果:

    • 如要編輯輸入變數,請按一下「Edit input variables」(編輯輸入變數)。
    • 如要重新測試整合,請按一下「重新測試整合」。
    • 如要還原值,請按一下「還原值」。
    • 如要查看及檢查測試執行的執行記錄,請按一下「View logs」(查看記錄)。
    • 如果您已啟用 Cloud Logging,請按一下「View Cloud logs」(查看 Cloud 記錄),在 Cloud Logging 中查看記錄。
    • 如要編輯整合,但不建立新版本,請按一下「編輯整合」。
    • 如要關閉測試作業並返回整合編輯器,請按一下「Close」(關閉)。

API

呼叫 projects.locations.integrations.test 方法。

要求主體中的 clientId 欄位為必填。請設為 Google Cloud 專案編號,而非專案 ID。

如要設定流程的逾時時間,請設定標頭中的 X-Server-Timeout 欄位。預設逾時時間為 120 秒。如需預先定義的要求參數組合清單,請參閱「系統參數」。

發布整合項目

發布整合版本後,系統會部署該版本,並將其設為有效狀態。系統會自動取消發布先前發布的整合版本,而所有依賴先前發布整合版本的服務,都會自動使用最新發布的版本。

如要發布整合,請選取下列其中一個選項:

控制台

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

    前往 Application Integration

  2. 按一下左側導覽選單中的「Integrations」(整合),開啟「Integrations」(整合) 頁面。
  3. 選取要發布的整合項目。

  4. 在設計工具導覽列中,按一下「Version」(版本) 下拉式選單,然後選取要發布的整合版本。
  5. 按一下 [發布]。

    系統隨即會顯示「Autogenerate Integration description」(自動產生整合說明) 對話方塊。如要生成說明,請按一下「好,繼續」。如果不是,請按一下「不,直接發布」。

成功發布整合項目後,您可以查看及檢查已發布整合項目的執行記錄。如要查看記錄,請按一下整合編輯器工具列中的「Logs」(記錄)。

根據預設,Application Integration 會在整合項目發布後鎖定,禁止編輯。如要變更已發布的整合項目,請在整合編輯器中按一下「啟用編輯」。編輯已發布的整合項目,會建立該整合項目的新版本。

API

呼叫 projects.locations.integrations.versions.publish 方法。

取消發布整合作業

取消發布「有效」整合版本後,系統會取消部署該整合版本,並將其設為「快照」狀態。凡是仰賴已發布整合版本的服務,都會自動停止。

如要取消發布整合,請選取下列任一選項:

控制台

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

    前往 Application Integration

  2. 按一下左側導覽選單中的「Integrations」(整合),開啟「Integrations」(整合) 頁面。
  3. 選取要取消發布的整合項目。

  4. 在設計工具導覽列中,按一下「Version」(版本) 下拉式選單,然後選取要取消發布的整合版本。
  5. 按一下「取消發布」。

    成功取消發布整合項目後,您可以在整合編輯器中按一下「Enable editing」(啟用編輯功能),編輯整合項目。編輯整合項目會建立新版本。

API

呼叫 projects.locations.integrations.versions.unpublish 方法。

配額與限制

如要瞭解 Application Integration 的配額與限制,請參閱「配額與限制」。

最佳做法

配額與限制

如要瞭解配額和限制,請參閱「配額與限制」。