Anypoint Studio を使用した Azure Service Bus Management 1.0 の設定 - Mule 4

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

「アプリケーションログの表示」​で説明されているように、コネクタを実行するときに、アプリケーションログを表示できます。

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​「Azure Service Bus Management リファレンス」​を参照してください。

Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

  1. Studio で、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

Azure Service Bus Management 用 Anypoint Connector (Azure Service Bus Management Connector) を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​pom.xml​ ファイルに必須の連動関係を追加します。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Modules to Project (モジュールをプロジェクトに追加)]​ で、検索項目に「​azure​」と入力します。

  3. [Available modules (使用可能なモジュール)]​ で ​[Azure Service Bus Management]​ をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

入力元の設定

入力元は、指定された条件が満たされたときにフローを開始します。 次の入力元のいずれかを設定して、Azure Service Bus Management Connector で使用できます。

  • HTTP Listener​: 設定されたホストとポートで要求を受信するたびにフローを開始

  • Scheduler​: 時間ベースの条件が満たされたときにフローを開始

たとえば、​HTTP リスナー​を設定するには、次の手順に従います。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[HTTP]​ > ​[Listener]​ を選択します。

  2. [Listener]​ を Studio キャンバスにドラッグします。

  3. [Listener (リスナー)]​ 設定画面で、必要に応じて ​[Display Name (表示名)]​ 項目の値を変更します。

  4. [Path (パス)]​ 項目の値を指定します。

  5. [Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (+) をクリックして、アプリケーション内のすべての ​HTTP Listener​ インスタンスで使用できるグローバル要素を設定します。

  6. [General (一般)]​ タブで、接続情報を指定します。

  7. [TLS]​ タブで、必要に応じて TLS 情報を指定します。

  8. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  9. [Test Connection (接続をテスト)]​ をクリックして、Mule が特定のサーバーに接続できることを確認します。

  10. [OK]​ をクリックします。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Azure Service Bus Management Connector の操作を追加する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[Azure Service Bus Management]​ を選択し、目的の操作を選択します。

  2. その操作を Studio キャンバスの入力元の右にドラッグします。

コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。グローバル要素の設定では、コネクタが対象の Azure Service Bus インスタンスにアクセスするために使用する認証ログイン情報を提供する必要があります。Azure Service Bus Management Connector では、共有アクセス署名 (SAS) 認証がサポートされます。

Azure Service Bus Management Connector のグローバル要素を設定する手順は、次のとおりです。

  1. Studio キャンバスでコネクタの名前を選択します。

  2. 操作の設定画面で、​[Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (+) をクリックし、グローバル要素設定項目にアクセスします。

  3. [General (一般)]​ タブで、次の項目の値を入力して共有アクセス署名 (SAS) 認証を設定します。

    項目 ユーザーアクション

    Service Namespace (サービス名前空間)

    サブスクリプション内の Azure Service Bus Service の名前空間。

    Shared Access Key Name (共有アクセスキー名)

    SAS トークンの名前。

    Shared Access Key (共有アクセスキー)

    SAS トークン

    次のスクリーンショットは、共有アクセス署名 (SAS) 認証を設定する例を示しています。このスクリーンショットでは、項目値にプロパティプレースホルダーを使用しています。プロパティプレースホルダーの使用についての詳細は、​「Anypoint Connector 設定」​を参照してください。

    [General (一般)] タブの SAS 認証設定項目
    Figure 1. SAS 認証の項目
  4. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  5. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  6. [OK]​ をクリックします。

その他のコネクタ項目の設定

Azure Service Bus Management Connector のグローバル要素を設定したら、コネクタ操作の他の必須項目を設定します。

たとえば、キューまたはトピックを作成または更新するには、​Create or Update Entity​ 操作を使用して次の項目に入力します。

項目 説明

Entity (Queue or Topic) (エンティティ (キューまたはトピック))

作成または更新するエンティティの名前を入力します。

If Match (一致する場合)

既存のエンティティを更新するには、このヘッダーを ​*​ に設定します。それ以外の場合、この項目を空白のままにします。

Content (コンテンツ)

キューの説明またはトピックを入力します。

アプリケーションログの表示

アプリケーションログは次の方法で表示できます。

  • アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。

  • コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。 アプリケーションのログファイル (​log4j2.xml​) でログファイルパスがカスタマイズされていない場合、次のデフォルトの場所でアプリケーションログを表示することもできます。 ​MULE_HOME/logs/<app-name>.log​ アプリケーションログについての詳細は、​「ログの設定」​を参照してください。

次のステップ

その他の設定情報については、​「追加設定情報」​を参照してください。