測試及發布整合項目
在整合服務編輯器中新增整合服務,並設定必要的觸發條件、任務和邊緣連線後,即可測試或發布整合服務。使用 Google Cloud 控制台測試整合時,整合會以同步模式執行。
必要的角色
如要取得測試或發布整合所需的權限,請要求管理員授予您專案的下列 IAM 角色:
-
測試整合:Application Integration 叫用者 (
roles/integrations.integrationInvoker) -
發布整合:Application Integration 部署者 (
roles/integrations.integrationDeployer)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這些預先定義的角色具備測試或發布整合項目所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能測試或發布整合:
-
測試整合:
integrations.integrations.invoke -
發布整合項目:
integrations.integrationVersions.deploy
Application Integration 編輯者 (roles/integrations.integrationEditor) 角色包含這兩項權限。
如果整合項目使用「執行身分」服務帳戶,您也必須具備該服務帳戶的「服務帳戶使用者」(roles/iam.serviceAccountUser) 角色,才能測試或發布整合項目。請參閱「授予服務帳戶使用者角色」。
測試整合
如要確認整合功能是否正常運作,可以先進行測試再發布。測試整合作業可讓您實驗整合輸入變數值,並找出整合連線流程中的任何錯誤。
如要試行整合,請選取下列其中一個選項:
控制台
- 在 Google Cloud 控制台中,前往「Application Integration」頁面。
- 按一下左側導覽選單中的「Integrations」(整合),開啟「Integrations」(整合) 頁面。
- 選取要測試的整合。
- 在設計工具導覽列中,按一下「Test」(測試)。
如果您在整合中設定了多個觸發條件,請選取要從哪個觸發條件測試執行整合。「Test Integration」(測試整合) 窗格隨即顯示。
- 按一下「測試整合」。
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 秒。如需預先定義的要求參數組合清單,請參閱「系統參數」。
發布整合項目
發布整合版本後,系統會部署該版本,並將其設為有效狀態。系統會自動取消發布先前發布的整合版本,而所有依賴先前發布整合版本的服務,都會自動使用最新發布的版本。
如要發布整合,請選取下列其中一個選項:
控制台
- 在 Google Cloud 控制台中,前往「Application Integration」頁面。
- 按一下左側導覽選單中的「Integrations」(整合),開啟「Integrations」(整合) 頁面。
- 選取要發布的整合項目。
- 在設計工具導覽列中,按一下「Version」(版本) 下拉式選單,然後選取要發布的整合版本。
- 按一下 [發布]。
系統隨即會顯示「Autogenerate Integration description」(自動產生整合說明) 對話方塊。如要生成說明,請按一下「好,繼續」。如果不是,請按一下「不,直接發布」。
成功發布整合項目後,您可以查看及檢查已發布整合項目的執行記錄。如要查看記錄,請按一下整合編輯器工具列中的「Logs」(記錄)。
根據預設,Application Integration 會在整合項目發布後鎖定,禁止編輯。如要變更已發布的整合項目,請在整合編輯器中按一下「啟用編輯」。編輯已發布的整合項目,會建立該整合項目的新版本。
API
取消發布整合作業
取消發布「有效」整合版本後,系統會取消部署該整合版本,並將其設為「快照」狀態。凡是仰賴已發布整合版本的服務,都會自動停止。
如要取消發布整合,請選取下列任一選項:
控制台
- 在 Google Cloud 控制台中,前往「Application Integration」頁面。
- 按一下左側導覽選單中的「Integrations」(整合),開啟「Integrations」(整合) 頁面。
- 選取要取消發布的整合項目。
- 在設計工具導覽列中,按一下「Version」(版本) 下拉式選單,然後選取要取消發布的整合版本。
- 按一下「取消發布」。
成功取消發布整合項目後,您可以在整合編輯器中按一下「Enable editing」(啟用編輯功能),編輯整合項目。編輯整合項目會建立新版本。
API
配額與限制
如要瞭解 Application Integration 的配額與限制,請參閱「配額與限制」。
最佳做法
- 測試整合前,請先定義變數 (輸入或輸出變數) 的可用性。請參閱「整合變數」。
- 定義整合的錯誤處理。
配額與限制
如要瞭解配額和限制,請參閱「配額與限制」。