デプロイメント API の使用

ドメイン内の AquaLogic Service Bus リソースは、Java Management Extensions (JMX) の管理対象 Bean (MBean) を使用して管理機能をエクスポーズします。MBean は、JMX 仕様に従って開発された Java の具象クラスです。MBean を使用すると、管理対象リソース内の各管理属性に対する getter 操作と setter 操作だけでなく、リソースが提供するその他の管理操作を実行できます。

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

SessionManagementMBean : セッションの作成、アクティブ化、破棄、または既存のセッションの名前を返すために使用します。
ALSBConfigurationMBean : AquaLogic Service Bus コンフィグレーションのインポートとエクスポート、環境固有の情報 (エンドポイント URI など) の更新、および AquaLogic Service Bus コンフィグレーションおよびリソースの照会に使用します。

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

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

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

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

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

表 A-1 セッション管理メソッド
作業内容	メソッド
セッションをアクティブ化する。	`activateSession(String session, String description)`
ユーザ指定の名前が付いた新しいセッションを作成する。	`createSession(String session)`
変更をアクティブ化せずにセッションを削除する	`discardSession(String session)`
指定のセッション名が付いたセッションが存在する場合、true を返す。	`sessionExists(String session)`

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

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

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

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

ALSBConfigurationMBean インタフェースのリファレンス資料については、ALSB javadoc の com.bea.wli.sb.management.configuration パッケージにある「SessionManagementMBean」インタフェースを参照してください。ALSB javadoc は、http://edocs.bea.com/alsb/docs25/javadoc/ にあります。

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

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

ALSBConfigurationMBean のメソッドは、AquaLogic Service Bus Console に用意されている、対応する GUI と同じ順序で実行する必要があります。以下の表に、必要な手順、および各手順を実行するために ALSBConfigurationMBean インタフェースで使用できるメソッドを示します。

表 A-2 コンフィグレーションのインポート、エクスポート、照会を行うメソッド
作業内容	メソッド
この Mbean が動作するセッションの名前を返す。	`getSession()`
コンフィグレーション jar ファイルからコンフィグレーションデータを取得し、サーバでローカル (一時的) にステージングする。	`uploadJarFile(byte[] data)`
以前にアップロードした jar ファイルから選択したリソース、プロジェクト、またはフォルダをセッションにインポートする。	`importUploaded(Collection<Ref> refs, boolean includeDependencies, boolean preserveExistingEnvValues, String passphrase)`
指定のリソースクエリに基づいて特定のリソースタイプを検索し、検索条件を満たすリソースへの参照を返す。	`getRefs(ResourceQuery query)`
指定のルートの下にあるすべてのリソース、フォルダ、またはプロジェクトを返す。ルートは、ドメイン、プロジェクト、またはフォルダでもかまわない。	`getRefs(Ref root)`
特定のリソースの診断情報を取得する。	`getDiagnostics(Collection<Ref> refs)`
参照の特定の集合をエクスポートし、エクスポートデータを構成するバイトを返す。	`export(Collection<Ref> refsToExport, boolean includeDependencies, String passphrase)`

環境固有の情報の更新

環境固有の情報を更新するために、ALSBConfigurationMBean で使用できるメソッドを、次の表に示します。プロキシサービスとビジネスサービスのコンフィグレーションのエンドポイントの値と、ファイル、電子メール、および FTP 転送コンフィグレーションのディレクトリ要素が含まれています。

表 A-3 環境固有の値を更新するメソッド
作業内容	メソッド
環境値を直接設定する。	`assignEnvValues(Collection<QualifiedEnvValue> envValues)`
クエリに指定されている環境固有の値を検索する。	`findEnvValues(EnvValueQuery query)`
クエリに指定されている環境値を検索し (`EnvValueQuery.getSearchString()` によって返される)、環境値パターンに一致するすべての値を特定のパラメータに置き換える。	`replaceEnvValues(EnvValueQuery query, String replacement)`

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

サンプルコード

Java クライアントプログラムと WLST スクリプトで API を使用する方法の詳細とサンプルコードついては、表 A-4 の javadoc 情報を参照してください。MBean は、com.bea.wli.sb.management コンフィグレーションパッケージのインタフェースです。

表 A-4 セッションおよびコンフィグレーション管理の MBean を使用したコードサンプル
サンプルコードの内容	参照先
`SessionManagementMBean` および `ALSBConfigurationMBean` の取得方法。	SessionManagementMBean
セッションの作成方法。	SessionManagementMBean
AquaLogic Service Bus コンフィグレーションのインポート方法およびエクスポート方法。	`ALSBConfigurationMBean`
環境値の変更方法。
リソースの照会方法。

デプロイメント ガイド