統合のテストや公開は、必要なトリガー、タスク、エッジ接続で統合を追加して構成した後、統合エディタから行えます。Google Cloud コンソールを使用してインテグレーションをテストまたは公開すると、インテグレーションは同期モードで実行されます。
必要なロール
統合をテストまたは公開するために必要な権限がユーザー アカウントに付与されるように、ユーザー アカウントApplication Integration サービス エージェント (roles/integrations.serviceAgent
)プロジェクトに対する IAM ロールに権限を付与するよう管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理に関する記事をご覧ください。
管理者は、カスタムロールや他の事前定義ロールを使用して、必要な権限をユーザー アカウントに付与することもできます。
統合をテストする
必要に応じて、統合が意図したとおりに機能していることを確認する場合は、公開前にテストできます。統合をテストすると、統合入力変数の値を試すことができ、統合接続フローの障害を特定するのに役立ちます。
統合をテスト実行するには、次の手順を行います。
- Apigee UI で、Apigee 組織を選択します。
- [Develop] > [Integrations] の順にクリックします。
- テストする統合を選択します。
- デザイナーのナビゲーション バーで [Test] をクリックします。
統合に複数のトリガーが構成されている場合は、統合をテスト実行するトリガーを選択します。[Test Integration] ペインが表示されます。
- [Test Integration] をクリックします。
Apigee Integration で統合がテスト実行され、[Test Integration] ペインに実行結果が表示されます。
- 入力変数を編集するには、[Edit input variables] をクリックします。
- 統合を再テストするには、[Retest integration] をクリックします。
- 値を復元するには、[Restore values] をクリックします。
- テスト実行の実行ログを表示して検査するには、[View logs] をクリックします。
- Cloud Logging を有効にしている場合、Cloud Logging でログを表示するには、[View Cloud logs] をクリックします。
- 統合の新しいバージョンを作成せずに統合を編集するには、[Edit integration] をクリックします。
- テスト オペレーションを閉じて統合エディタに戻るには、[Close] をクリックします。
統合を公開する
統合バージョンを公開すると、その統合バージョンがデプロイされ、アクティブ状態になります。以前に公開された統合バージョンは自動的に公開停止され、以前に公開された統合バージョンに依存するすべてのサービスは自動的に最新の公開バージョンを使用します。
統合を公開するには、次の手順を行います。
- Apigee UI で、Apigee 組織を選択します。
- [Develop] > [Integrations] の順にクリックします。
- 編集する統合を選択します。
- デザイナーのナビゲーション バーで、[Version] プルダウンをクリックして、公開する統合バージョンを選択します。
- [Publish] をクリックします。
[Autogenerate Integration description] ダイアログが表示されます。説明を生成する場合は、[Sure, continue] をクリックします。それ以外の場合は、[No, just publish] をクリックします。
統合が正常に公開されると、公開された統合の実行ログを表示、検査できます。ログを表示するには、統合エディタのツールバーで [Logs] をクリックします。
デフォルトでは、Apigee Integration は公開時に編集できないようにロックします。公開済みの統合に変更を加えるには、統合エディタで [Enable editing] をクリックします。公開された統合を編集すると、その統合の新しいバージョンが作成されます。
統合の公開を停止する
アクティブな統合バージョンの公開を停止すると、その統合バージョンがデプロイ解除され、スナップショット状態になります。その統合の公開済みのバージョンに依存するサービスはすべて自動的に停止されます。
統合を公開停止するには、次の手順を行います。
- Apigee UI で、Apigee 組織を選択します。
- [Develop] > [Integrations] の順にクリックします。
- 公開停止する統合を選択します。
- デザイナーのナビゲーション バーで、[Version] プルダウンをクリックし、公開を停止する統合バージョンを選択します。
- [Unpublish] をクリックします。
統合の公開停止に成功したら、統合エディタで [Enable editing] をクリックして統合を編集します。統合を編集すると、その統合の新しいバージョンが作成されます。
割り当てと上限
Apigee Integration の割り当てと上限については、割り当てと上限をご覧ください。
ベスト プラクティス
- 統合をテストする前に、変数(入力変数または出力変数)のユーザビリティを定義します。統合変数をご覧ください。
- 統合のエラー処理を定義します。