デプロイメント ガイド

デプロイメント API の使用

Oracle Service Bus MBeans を Java プログラムおよび WLST スクリプトで使用すると、開発環境からテスト環境、ステージング環境を経て、最終的にプロダクション環境に至るまで、Oracle Service Bus コンフィグレーションのプロモーションを自動化できます。以下の Oracle Service Bus MBean を使用すると、デプロイメント処理をプログラムで実行できます。

後者の MBean は、com.bea.wli.sb.management.configuration パッケージのインタフェースです。

デプロイメント時にさまざまなカスタマイズ オプションを適用できます。さまざまな環境変数を使用して、環境を移行する際の設定を保持または調整することが可能です。

この節では、以下のトピックを取り上げます。

プログラムとスクリプトを使用したセッションの管理

Oracle Service Bus セッションを使用すると、異なるユーザが相互に干渉することなくコンフィグレーション データの個々の部分を更新できます。セッションは基本的に名前付きのサンドボックスで、行った変更はアクティブ化されるまでは、他のユーザおよびコア データ (Oracle Service Bus の動作の基盤となっているデータ) によって抽出されます。リソースと Oracle Service Bus コンフィグレーションを変更するには、セッションを作成し、作成したセッションで変更を実行する必要があります。セッションをアクティブ化した場合にのみ、変更はコア データに反映されます。セッションの名前が同じでない限り、複数のセッションを作成できます。セッションは、そのセッション データで動作する SessionManagementMBean のインスタンスを使用した場合のみアクティブ化できます。

各 MBean タイプ (SessionManagementMBean を除く) には、セッションごとに 1 つのインスタンスがあります。セッションが作成されると、新しい一連の MBean インスタンス (MBean タイプごとに 1 つ) が自動的に生成されます。各 MBean タイプのインスタンスは、Oracle Service Bus データ キャッシュに保存されているコア データで動作します。セッションが破棄またはアクティブ化されると、セッションに作成された MBean インスタンスは破棄されます。ただし、コア データで動作する MBean インスタンスは破棄されません。コア データで動作する MBean インスタンスでは、更新操作はサポートされていません。

セッションの作成、アクティブ化、破棄、検索

Oracle Service Bus セッションは Oracle Service Bus Console を使用して作成します。SessionManagementMBean インタフェースのメソッドは、Oracle Service Bus Console で提供されている対話機能と同等の機能であり、対応する GUI と同じ順序で実行する必要があります。以下の表に、SessionManagementMBean インタフェースで使用できるメソッド、およびメソッドによって実行されるタスクを示します。

SessionManagementMBean インタフェースのリファレンス資料、Java の使用例、および Java クライアントやスクリプトで MBean を使用する方法を示したサンプル コードについては、Oracle Service Bus の Javadoc の com.bea.wli.sb.management.configuration パッケージにある「SessionManagementMBean インタフェース」を参照してください。

サンプル

Oracle Service Bus の Javadoc の com.bea.wli.sb.management.configuration パッケージにある「SessionManagementMBean インタフェース」には、セッションの作成方法、セッションを作成するための SessionManagementMBean の取得方法、および作成されたセッションおよびコア データで動作させるための ALSBConfigurationMBean の取得方法などを示すサンプル コードが含まれます。

プログラムとスクリプトを使用したコンフィグレーション タスクの管理

Oracle Service Bus ALSBConfigurationMBean を使用すると、Oracle Service Bus ドメインで、リソースの照会、エクスポート、およびインポート、検証エラーの取得、環境値の取得と設定、およびリソース コンフィグレーションの全般的な管理をプログラムで行うことができます。Oracle Service Bus コンフィグレーションは、プロキシ サービス、WSDL、ビジネス サービスなど、Oracle Service Bus リソースを含む単純な JAR としてパッケージ化されています。これらのリソースは、複数のプロジェクトにまたがるものにしたり、コンフィグレーション情報の一部だけを含めたりできます。たとえば、プロジェクトのサブセットだけをエクスポートしたり、プロジェクト全体をエクスポートしたり、多数のプロジェクトのリソースのサブセットをエクスポートしたりできます。

以下の節では、ALSBConfigurationMBean を使用して Java クライアントからこれらのデプロイメント アクティビティを実行する方法を説明します。

ALSBConfigurationMBean インタフェースのリファレンス資料については、Oracle Service Bus の Javadoc の com.bea.wli.sb.management.configuration パッケージにある 「ALSBConfigurationMBean」インタフェースを参照してください。

コンフィグレーションのインポート、エクスポート、照会

Oracle Service Bus コンフィグレーションは Oracle Service Bus Console で作成され、エクスポートにより .jar ファイルに格納されます。コンフィグレーション .jar ファイルをエクスポートしたら、そのコンフィグレーションを別の Oracle Service Bus ドメインにインポートし、コンフィグレーションの環境固有の値を新しい環境の値に合わせて変更して、コンフィグレーションをプロモートできます。

ALSBConfigurationMBean インタフェースのメソッドを使用すると、Oracle Service Bus ドメインで次のようなリソースの管理を行うことができます。

およびその他のタスクを実行できます。ALSBConfigurationMBean メソッドの包括的なメソッド概要については、「ALSBConfigurationMBean の Javadoc」を参照してください。

環境固有の情報の更新

ALSBConfigurationMBean および Customization クラスのメソッドを使用して、環境固有の情報を更新できます。以下が含まれます。

およびその他のタスクを実行できます。メソッドの包括的な概要については、「ALSBConfigurationMBean の Javadoc」および「Customization クラスの Javadoc」を参照してください。インポートのカスタマイズは ALSBImportPlan によってサポートされています。「ALSBImportPlan クラス」を参照してください。

セキュリティ コンフィグレーションと他のすべての環境固有の設定は、Oracle Service Bus Console を使用して対話的に更新する必要があります。セキュリティのコンフィグレーションについては、『Oracle Service Bus Console オンライン ヘルプ』の「セキュリティ コンフィグレーション」に関する説明を参照してください。その他の環境固有の設定のコンフィグレーションについては、「手順 4.Oracle Service Bus コンフィグレーションのデプロイ」を参照してください。

サンプル

Oracle Service Bus の Javadoc の com.bea.wli.sb.management.configuration パッケージにある 「ALSBConfigurationMBean」インタフェースには、Oracle Service Bus のコンフィグレーションのインポートおよびエクスポートの方法、環境値の変更方法、リソースの照会方法などを示すサンプル コードが含まれます。

関連トピック

Oracle Service Bus の『ユーザーズ ガイド』の「Oracle Service Bus API」