AMQ Interconnect の使用

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを開きます。

2. ルーターに、クライアント接続の秘密鍵と証明書を定義する sslProfile が含まれていない場合は、これを追加します。

   この sslProfile には、ルーターがクライアントからの接続の暗号化に使用する秘密鍵と証明書の場所が含まれます。

   sslProfile {
       name: service-tls
       certFile: /etc/pki/tls/certs/tls.crt
       caCertFile: /etc/pki/tls/certs/ca.crt
       privateKeyFile: /etc/pki/tls/private/tls.key
       password: file:/etc/pki/tls/private/password.txt
       ...
   }

   name

   この sslProfile の参照に使用できる一意の名前。

   certFile

   このルーターのパブリック証明書を含むファイルへの絶対パス。

   caCertFile

   ルーターが受信クライアントの認証に使用する CA 証明書への絶対パス。

   privateKeyFile

   このルーターのパブリック証明書に対する秘密鍵が含まれるファイルへの絶対パス。

   注記

   qdrouterd または root ユーザーが秘密鍵にアクセスできることを確認します。以下は例になります。

   chmod 0600 /etc/pki/tls/private/tls.key
   chown qdrouterd /etc/pki/tls/private/tls.key

   パスワード

   証明書キーのロックを解除するパスワード。証明書キーにパスワードがない場合は、指定する必要はありません。異なる接頭辞を使用することで、セキュリティー要件に応じてパスワードを複数回指定できます。

   • パスワードを含むファイルへの絶対パスを指定します。これは、パスワードを含むファイルにパーミッションを設定することができるため、最も安全なオプションです。以下は例になります。

     password: file:/etc/qpid-dispatch-certs/inter-router/password.txt

   • パスワードを保存する環境変数を指定します。他のプロセスの環境は特定のプラットフォームで表示されるため、このオプションの使用には注意が必要です。以下は例になります。

     password: env:CERT_PASSWORD

   • パスワードをクリアテキストで指定します。このオプションは安全ではないため、セキュリティーが懸念されていない場合にのみ使用してください。以下は例になります。

     password: pass:mycertpassword

3. SSL/TLS を使用して接続を暗号化するように、この接続が listener を設定します。

   この例では、normal リスナーがクライアントからの接続を暗号化するように設定します。

   listener {
       host: 0.0.0.0
       port: 5672
       role: normal
       sslProfile: inter_router_tls
       requireSsl: yes
       ...
   }

   sslProfile

   SSL/TLS プライベートキーおよびクライアント接続の証明書を定義する sslProfile の名前。

   requireSsl

   true を指定して SSL/TLS で接続を暗号化します。

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを開きます。

2. SSL/TLS を使用してクライアントを認証するように、この接続の listener を設定します。

   この例では、クライアントからの受信接続を認証するために、normal リスナーに SSL/TLS 認証を追加します。クライアントは、独自の X.509 証明書を提示してルーターにだけ接続でき、ルーターを使用してクライアントのアイデンティティーを検証するために使用されます。

   listener {
       host: 0.0.0.0
       port: 5672
       role: normal
       sslProfile: service-tls
       requireSsl: yes
       authenticatePeer: yes
       saslMechanisms: EXTERNAL
       ...
   }

   authenticatePeer

   クライアントのアイデンティティーを認証するには yes を指定します。

   saslMechanisms

   X.509 クライアント証明書認証を有効にするために EXTERNAL を指定します。

手順

1. 必要に応じて、ユーザー名とパスワードを SASL データベースに追加します。

   この例では、新しいユーザー (user1@example.com) を SASL データベース (qdrouterd.sasldb) に追加します。

   $ sudo saslpasswd2 -c -f qdrouterd.sasldb -u example.com user1

   注記

   完全なユーザー名は、入力したユーザー名 (<user-name>@<domain-name>) です。ユーザーをデータベースに追加する場合、ドメイン名を指定する必要はありませんが、これを指定しないと、デフォルトのドメインが自動的に追加されます (ツールが実行されているマシンのホスト名)。

2. qdrouterd プロセスが SASL データベースを読み取りできることを確認します。

   qdrouterd プロセスが非特権ユーザーとして実行される場合は、ルーターが読み取れるように SASL データベースのパーミッションまたは所有権を調整する必要がある場合があります。

   この例では、qdrouterd ユーザーが SASL データベースの所有者になります。

   $ sudo chown qdrouterd /var/lib/qdrouterd/qdrouterd.sasldb

3. /etc/sasl2/qdrouterd.conf 設定ファイルを開きます。

   以下の例では、/etc/sasl2/qdrouterd.conf 設定ファイルを示しています。

   pwcheck_method: auxprop
   auxprop_plugin: sasldb
   sasldb_path: qdrouterd.sasldb
   mech_list: ANONYMOUS DIGEST-MD5 EXTERNAL PLAIN GSSAPI

4. mech_list 属性に PLAIN メカニズムが含まれることを確認します。
5. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを開きます。

6. router セクションで、SASL 設定ファイルへのパスを指定します。

   router {
       mode: interior
       id: Router.A
       saslConfigDir: /etc/sasl2/
   }

   saslConfigDir

   ユーザー名とパスワードを格納する SASL データベースへのパスが含まれる SASL 設定ファイルへのパス。

7. SASL PLAIN を使用してクライアントを認証するように、この接続の listener を設定します。

   この例では、listener に基本的なユーザー名とパスワード認証を設定します。この場合、SSL/TLS 暗号化は使用されません。

   listener {
       host: 0.0.0.0
       port: 5672
       authenticatePeer: yes
       saslMechanisms: PLAIN
       }

手順

1. ルーターのホストマシンで、/etc/sasl2/qdrouterd.conf 設定ファイルを開きます。

   以下の例では、/etc/sasl2/qdrouterd.conf 設定ファイルを示しています。

   pwcheck_method: auxprop
   auxprop_plugin: sasldb
   sasldb_path: qdrouterd.sasldb
   keytab: /etc/krb5.keytab
   mech_list: ANONYMOUS DIGEST-MD5 EXTERNAL PLAIN GSSAPI

2. 以下を確認します。

   • mech_list 属性には GSSAPI メカニズムが含まれます。
   • keytab 属性は、キータブファイルの場所を参照します。
3. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを開きます。

4. router セクションで、SASL 設定ファイルへのパスを指定します。

   router {
       mode: interior
       id: Router.A
       saslConfigDir: /etc/sasl2/
   }

   saslConfigDir

   SASL データベースへのパスが含まれる SASL 設定ファイルへのパス。

5. 認証に Kerberos を使用する各着信接続に対して、listener が GSSAPI メカニズムを使用するように設定します。

   listener {
       host: 0.0.0.0
       port: 5672
       authenticatePeer: yes
       saslMechanisms: GSSAPI
       }

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを開きます。

2. 外部 AMQP コンテナーのアイデンティティーの検証に使用できる証明書を定義する sslProfile が含まれていない場合は、これを追加します。

   sslProfile {
       name: broker-tls
       caCertFile: /etc/qpid-dispatch-certs/ca.crt
       ...
   }

   name

   この sslProfile の参照に使用できる一意の名前。

   caCertFile

   外部 AMQP コンテナーのアイデンティティーの検証に使用される CA 証明書への絶対パス。

3. SSL/TLS を使用して、SSL ハンドシェイク中にブローカーによって受信されたサーバー証明書を検証するために、この接続で connector を設定します。

   この例では、connector をブローカーに設定します。ルーターはブローカーに接続すると、broker-tls sslProfile に定義された CA 証明書を使用して、ブローカーから受け取ったサーバー証明書を検証します。

   connector {
       host: 192.0.2.1
       port: 5672
       role: route-container
       sslProfile: broker-tls
       ...
   }

   sslProfile

   外部 AMQP コンテナーのアイデンティティーの検証に使用する証明書を定義する sslProfile の名前。

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを開きます。

2. ルーターに、外部の AMQP コンテナーに接続するための秘密鍵と証明書を定義する sslProfile が含まれていない場合は、これを追加します。

   この sslProfile には、ルーターがピアとの認証に使用する秘密鍵と証明書の場所が含まれます。

   sslProfile {
       name: broker-tls
       certFile: /etc/pki/tls/certs/tls.crt
       caCertFile: /etc/pki/tls/certs/ca.crt
       privateKeyFile: /etc/pki/tls/private/tls.key
       password: file:/etc/pki/tls/private/password.txt
       ...
   }

   name

   この sslProfile の参照に使用できる一意の名前。

   certFile

   このルーターのパブリック証明書を含むファイルへの絶対パス。

   caCertFile

   ルーターが受信クライアントの認証に使用する CA 証明書への絶対パス。

   privateKeyFile

   このルーターのパブリック証明書に対する秘密鍵が含まれるファイルへの絶対パス。

   注記

   qdrouterd または root ユーザーが秘密鍵にアクセスできることを確認します。以下は例になります。

   chmod 0600 /etc/pki/tls/private/tls.key
   chown qdrouterd /etc/pki/tls/private/tls.key

   パスワード

   証明書キーのロックを解除するパスワード。証明書キーにパスワードがない場合は、指定する必要はありません。異なる接頭辞を使用することで、セキュリティー要件に応じてパスワードを複数回指定できます。

   • パスワードを含むファイルへの絶対パスを指定します。これは、パスワードを含むファイルにパーミッションを設定することができるため、最も安全なオプションです。以下は例になります。

     password: file:/etc/qpid-dispatch-certs/inter-router/password.txt

   • パスワードを保存する環境変数を指定します。他のプロセスの環境は特定のプラットフォームで表示されるため、このオプションの使用には注意が必要です。以下は例になります。

     password: env:CERT_PASSWORD

   • パスワードをクリアテキストで指定します。このオプションは安全ではないため、セキュリティーが懸念されていない場合にのみ使用してください。以下は例になります。

     password: pass:mycertpassword

3. 作成した sslProfile を使用するように、このコネクションの connector を設定します。

   connector {
       host: 192.0.2.1
       port: 5672
       role: route-container
       sslProfile: broker-tls
       saslMechanisms: EXTERNAL
       ...
   }

   sslProfile

   SSL/TLS プライベートキーおよびルーター間ネットワークの証明書を定義する sslProfile の名前。

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを開きます。

2. このコネクションが、外部 AMQP コンテナーに対してユーザー名とパスワードのクレデンシャルを提供するように connector を設定します。

   connector {
       host: 192.0.2.1
       port: 5672
       role: route-container
       saslMechanisms: PLAIN
       saslUsername: user
       saslPassword: file:/path/to/file/password.txt
       }

   saslPassword

   ピアに接続するためのパスワード。異なる接頭辞を使用することで、セキュリティー要件に応じてパスワードを複数回指定できます。

   • パスワードを含むファイルへの絶対パスを指定します。これは、パスワードを含むファイルにパーミッションを設定することができるため、最も安全なオプションです。以下は例になります。

     password: file:/path/to/file/password.txt

   • パスワードを保存する環境変数を指定します。他のプロセスの環境は特定のプラットフォームで表示されるため、このオプションの使用には注意が必要です。以下は例になります。

     password: env:PASSWORD

   • パスワードをクリアテキストで指定します。このオプションは安全ではないため、セキュリティーが懸念されていない場合にのみ使用してください。以下は例になります。

     password: pass:mypassword

手順

1. vhost セクションを追加し、メッセージングエンドポイントの接続およびメッセージのサイズ制限を定義します。

   接続制限は、vhost に接続されているすべてのユーザーに適用されます。これらの制限により、vhost を同時に接続できるユーザーの数を制御します。

   vhost {
       hostname: "example.com"
       aliases: "example.org, example.net"
       maxConnections: 10000
       maxMessageSize: 500000
       maxConnectionsPerUser: 100
       maxConnectionsPerHost: 100
       allowUnknownUser: true
       ...
   }

   hostname

   vhost (メッセージングエンドポイント) のリテラルホスト名または vhost ホスト名に一致するパターンのリテラルホスト名。この vhost ポリシーは、指定したホスト名に転送されるクライアント接続に適用されます。この名前は一意でなければなりません。ホスト名ごとに 1 つの vhost ポリシーのみを指定できます。

   enableVhostNamePatterns が true に設定されている場合、ワイルドカードを使用してホスト名の範囲に一致するパターンを指定できます。詳細は、「vhost ポリシーホスト名パターン一致ルール」 を参照してください。

   aliases

   この vhost の設定を使用するようにルーターに指示する代替のリテラルホスト名またはパターン受信接続に一致するエイリアスホスト名には、vhost セクションで定義された設定が使用されます。マルチテナント設定では、vhost エイリアスへの接続はテナント namespace のベース vhost ホスト名を使用します。この例では、接続が vhost example.org に表示される場合、ベース vhost ホスト名 example.com の設定が適用され、example.com がテナントの名前空間になります。すべての vhosts の hostname と aliases の設定は一意でなければなりません。

   enableVhostNamePatterns が true に設定されている場合、ワイルドカードを使用してホスト名エイリアスの範囲に一致するパターンを指定できます。詳細は、「vhost ポリシーホスト名パターン一致ルール」 を参照してください。

   maxConnections

   この vhost で許可されている同時クライアント接続のグローバル最大数デフォルトは 65535 です。

   maxMessageSize

   この vhost へのコネクションに対して許可される AMQP メッセージ転送の最大サイズ (バイト単位)。この制限は、ポリシーの maxMessageSize 値を上書きし、vhost ユーザーグループの設定で上書きされる可能性があります。値が 0 の場合は、この制限が無効になります。

   maxConnectionsPerUser

   すべてのユーザーが許容される同時クライアント接続の最大数。デフォルトは 65535 です。

   maxConnectionsPerHost

   すべてのリモートホスト (クライアントが接続しているホスト) に対して許可される同時クライアント接続の最大数。デフォルトは 65535 です。

   allowUnknownUser

   不明なユーザー (定義されたユーザーグループのメンバーであるユーザー) が vhost への接続を許可するかどうか。不明なユーザーは、$default ユーザーグループに割り当てられ、$default 設定を受け取ります。デフォルトは false で、不明なユーザーには許可されないことを意味します。

2. vhost セクションで、追加した接続設定の下に、group エンティティーを追加して、リソース制限を定義します。

   ユーザーグループでリソース制限を定義します。ユーザーグループは、グループのメンバーがアクセス可能なメッセージングリソースを指定します。

   以下の例は、admin、developer、および $default の 3 つのユーザーグループを示しています。

   vhost {
       ...
       groups: {
           admin: {
               users: "admin1, admin2"
               remoteHosts: "127.0.0.1, ::1"
               sources: "*"
               targets: "*"
           }
           developers: {
               users: "dev1, dev2, dev3"
               remoteHosts: "*"
               sources: "myqueue1, myqueue2"
               targets: "myqueue1, myqueue2"
           }
           $default: {
               remoteHosts: "*"
               allowDynamicSource: true,
               allowAdminStatusUpdate: true,
               sources: "myqueue1, myqueue2"
               targets: "myqueue1, myqueue2"
           }
       }
   }

   注記

   引用符を使用して文字列値を定義します。

   users

   このユーザーグループに認証されたユーザーの一覧。複数のユーザーを分離する場合はコンマで区切ります。ユーザーは 1 つの vhost ユーザーグループにしか属することができません。

   remoteHosts

   ユーザーが接続できるリモートホストの一覧。ホストには、ホスト名、IP アドレス、または IP アドレス範囲を指定できます。複数のホストを分離する場合はコンマで区切ります。すべてのリモートホストからアクセスを許可するには、ワイルドカード * を指定します。すべてのリモートホストからアクセスを拒否するには、この属性を空白のままにします。

   maxConnectionsPerUser

   このユーザーグループでユーザーが作成できる接続の最大数。この値が指定されている場合には、vhost maxConnectionsPerUser の値が上書きされます。

   maxConnectionsPerHost

   許可されたリモートホストからこのユーザーグループのユーザーによって作成できる同時接続の最大数。この値が指定されている場合には、vhost maxConnectionsPerUser の値が上書きされます。

   maxMessageSize

   このグループのユーザーが作成したコネクションに許可される AMQP メッセージ転送の最大サイズ (バイト単位)。この制限により、ポリシーと vhost maxMessageSize の値が上書きされます。値が 0 の場合は、この制限が無効になります。

   allowDynamicSource

   true の場合、このグループのユーザーからの接続は受信側を動的ソースに割り当てることができます。これにより、リスナーが一時的なアドレスまたは一時キューに作成できるようになります。false の場合、動的ソースの使用は許可されません。

   allowAdminStatusUpdate

   true の場合、このグループのユーザーからの接続は、接続の adminStatus を変更することが許可されます。これにより、送信者またはレシーバー接続の終了が許可されます。false の場合、このグループのユーザーは、接続を終了できなくなります。ルーター間接続はどのユーザーでも終了できません。ポリシーが設定されていない場合でも、デフォルトは true になります。

   allowWaypointLinks

   true の場合、このグループ内のユーザーからの接続は、ポイントポイント機能を使ってリンクを割り当てることができます。これにより、エンドポイントが自動リンクを設定する必要なく、ポイント (ブローカー) として機能できるようになります。false の場合は、ポイント機能の使用が許可されません。

   allowDynamicLinkRoutes

   true の場合、このグループのユーザーからの接続は、接続スコープのリンクルートの宛先を動的に作成できます。これにより、エンドポイントはリンクルートの設定を必要とせずに、リンクルートの宛先 (ブローカー) として機能できます。false の場合、動的リンクルートの宛先の作成は許可されません。

   allowFallbackLinks

   true の場合、このグループのユーザーからの接続は、フォールバックリンク機能を使用してリンクを割り当てることができます。これにより、エンドポイントはフォールバックが有効にされているアドレスのフォールバック宛先 (およびソース) として動作します。false の場合は、フォールバックリンク機能の使用は許可されません。

   sources | sourcePattern

   このグループのユーザーがメッセージを受信する AMQP ソースアドレスのリスト。

   sources を使用して、1 つ以上のリテラルアドレスを指定します。複数のアドレスを指定するには、コンマ区切りリストを使用します。このグループのユーザーが任意のアドレスからメッセージを受信しないようにするには、この属性を空白のままにしておきます。特定のユーザー固有のアドレスへのアクセスを許可するには、${user} トークンを指定します。詳細は、「vhost ポリシーのソースおよびターゲットアドレスを指定する方法」 を参照してください。

   または、sourcePattern を使用して、パターンに対応する 1 つ以上のアドレスと一致させることもできます。パターンは、. または / のいずれかで区切られた単語シーケンスです。ワイルドカード文字を使用して単語を表すことができます。* 文字は 1 つの単語にマッチし、# 文字はゼロ以上の単語のシーケンスと一致します。

   複数のアドレス範囲を指定するには、アドレスパターンのコンマ区切りリストを使用します。詳細は、を参照してください。特定のユーザーに固有の範囲へのアクセスを許可するには、${user} トークンを指定します。詳細は、xref:methods-specifying-vhost-policy-source-target-addresses-router-rhel[ を参照してください。

   targets | targetPattern

   このグループのユーザーがメッセージを送信できる AMQP ターゲットアドレスのリスト。複数の AMQP アドレスを指定し、ユーザー名の置換とアドレスパターンをソースアドレスと同じように使用できます。

3. 必要な場合は、vhost ユーザーグループに高度なユーザーグループ設定を追加します。

   高度なユーザーグループ設定では、AMQP コネクションのオープン、セッション開始、および接続のリンクアタッチフェーズに基づいて、リソース制限を定義できます。詳細は、man ページの qdrouterd.conf で vhost を参照してください。

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルで、vhost ポリシー定義 JSON ファイルを保存するディレクトリーを指定します。

   policy {
       ...
       policyDir: /etc/qpid-dispatch-policies
   }

   policyDir

   JSON 形式の vhost ポリシー定義ファイルを保持するディレクトリーへの絶対パス。ルーターは、このディレクトリーにある各 JSON ファイルで、すべての vhost ポリシーを処理します。

2. vhost ポリシー定義ディレクトリーで、各 vhost ポリシーに JSON ファイルを作成します。

   例10.1 vhost ポリシー定義 JSON ファイル

   [
       ["vhost", {
           "hostname": "example.com",
           "maxConnections": 10000,
           "maxConnectionsPerUser": 100,
           "maxConnectionsPerHost": 100,
           "allowUnknownUser": true,
           "groups": {
               "admin": {
                   "users": ["admin1", "admin2"],
                   "remoteHosts": ["127.0.0.1", "::1"],
                   "sources": "*",
                   "targets": "*"
               },
               "developers": {
                   "users": ["dev1", "dev2", "dev3"],
                   "remoteHosts": "*",
                   "sources": ["myqueue1", "myqueue2"],
                   "targets": ["myqueue1", "myqueue2"]
               },
               "$default": {
                   "remoteHosts": "*",
                   "allowDynamicSource": true,
                   "sources": ["myqueue1", "myqueue2"],
                   "targets": ["myqueue1", "myqueue2"]
               }
           }
       }]
   ]

   これらの属性についての詳細は、「vhost ポリシーの作成」 を参照してください。

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルで、$connector ユーザーグループを指定して vhost セクションを追加します。

   vhost {
       hostname: "my-connector-policy"
       groups: {
           $connector: {
               sources: "*"
               targets: "*"
               maxSenders: 5
               maxReceivers: 10
               allowAnonymousSender: true
               allowWaypointLinks: true
           }
       }
   }

   hostname

   コネクター vhost ポリシーを識別する一意の名前。この名前は実際のホスト名を表示しないため、実際の vhost ホスト名と競合しない名前を選択します。

   $connector

   この vhost ポリシーをコネクター vhost ポリシーとして特定します。適用することのできるリソース制限の詳細は、「vhost ポリシーの作成」 を参照してください。

2. コネクター vhost ポリシーを外部 AMQP コンテナーへの接続を確立するコネクターに適用します。

   以下の例では、前のステップで設定したコネクター vhost ポリシーを適用します。

   connector {
       host: 192.0.2.10
       port: 5672
       role: normal
       policyVhost: my-connector-policy
   }

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルで address セクションを追加します。

   address {
       prefix: my_address
       distribution: multicast
       ...
   }

   prefix | pattern

   アドレス設定を適用するアドレスのアドレスまたはグループ。接頭辞を指定して、アドレスの正確なアドレスまたは開始セグメントと一致するように指定できます。または、ワイルドカードを使用してアドレスに一致するパターンを指定できます。

   接頭辞は、. または / 文字のいずれかで区切られたアドレス内の正確なアドレスまたは最初のセグメントと一致します。たとえば、接頭辞 my_address は、my_address と my_address.1 および my_address/1 のアドレスと一致します。ただし、my_address1 と一致しません。

   パターンは、パターンに対応するアドレスと一致します。パターンは、. または / のいずれかで区切られた単語シーケンスです。ワイルドカード文字を使用して単語を表すことができます。* 文字は 1 つの単語にマッチし、# 文字はゼロ以上の単語のシーケンスと一致します。

   * および # 文字はワイルドカードとして予約されています。したがって、メッセージアドレスでは使用しないでください。

   アドレスパターンの作成に関する詳細は、「アドレスパターンの一致」 を参照してください。

   注記

   prefix 値を pattern に変換するには 、/# をそれに追加します。たとえば、接頭辞 a/b/c は、パターン a/b/c/# と同等です。

   distribution

   メッセージディストリビューションパターン。デフォルトは balanced ですが、以下のオプションのいずれかを指定できます。

   • balanced: アドレスに送信されたメッセージは受信側のいずれかにルーティングされ、ルーティングネットワークはセットレートに基づいてトラフィックの負荷のバランスを取ります。
   • closest: アドレスに送信されたメッセージは、送信先に到達するために最短パスで送信されます。つまり、同じアドレスに複数の受信側がある場合は、最も近いもののみがメッセージを受信します。

   • multicast: メッセージはパブリッシュ/サブスクライブモデルのアドレスにアタッチされるすべてのレシーバーに送信されます。

     メッセージディストリビューションパターンに関する詳細は、「ルーティングパターン」 を参照してください。

   その他の属性の詳細は、qdrouterd.conf の man ページの address を参照してください。

2. アドレスを使用する必要のある他のルーターに同じ address セクションを追加します。

   このルーター設定ファイルに追加した address は、このルーターがアドレスに送信されるメッセージを配布する方法のみ制御します。このアドレスにメッセージを分散する必要のあるルーターネットワークに追加のルーターがある場合、設定ファイルに同じ address セクションを追加する必要があります。

手順

1. ブローカーに外向き接続がない場合は、その接続を追加します。

   キューが複数のブローカーにシャードされている場合は、各ブローカーの接続を追加する必要があります。詳細は、「外部 AMQP コンテナーへの接続」 を参照してください。

2. クライアントがローカルトランザクションをブローカーに送信する場合は、トランザクションコーディネーターのリンクルートを作成します。

   linkRoute {
       prefix: $coordinator  1
       connection: my_broker
       direction: in
   }

   1

   $coordinator 接頭辞は、このリンクルートをトランザクションコーディネーターとして指定します。クライアントがトランザクションセッションを開くと、トランザクションの開始および終了リクエストは、ブローカーへのこのリンクルートと共に伝播されます。

   AMQ Interconnect では、複数のブローカーへのトランザクションのルーティングはサポートされません。環境に複数のブローカーがある場合は、単一のブローカーを選択し、すべてのトランザクションをそのブローカーにルーティングします。

3. クライアントがこのリンクルートにメッセージを送信するには、受信リンクルートを作成します。

   linkRoute {
       prefix: my_queue
       connection: my_broker
       direction: in
       ...
   }

   prefix | pattern

   ルーティングされたリンク添付の宛先となるブローカーキューに一致するアドレス接頭辞またはパターン。この接頭辞またはパターンに一致するメッセージはすべて、リンクルートとともに分散されます。接頭辞を指定して、アドレスの正確なアドレスまたは開始セグメントと一致するように指定できます。または、ワイルドカードを使用してアドレスに一致するパターンを指定できます。

   接頭辞は、. または / 文字のいずれかで区切られたアドレス内の正確なアドレスまたは最初のセグメントと一致します。たとえば、接頭辞 my_address は、my_address と my_address.1 および my_address/1 のアドレスと一致します。ただし、my_address1 と一致しません。

   パターンは、パターンに対応するアドレスと一致します。パターンは、. または / のいずれかで区切られた単語シーケンスです。ワイルドカード文字を使用して単語を表すことができます。* 文字は 1 つの単語にマッチし、# 文字はゼロ以上の単語のシーケンスと一致します。

   * および # 文字はワイルドカードとして予約されています。したがって、メッセージアドレスでは使用しないでください。

   アドレスパターンの作成に関する詳細は、「アドレスパターンの一致」 を参照してください。

   注記

   prefix 値を pattern に変換するには 、/# をそれに追加します。たとえば、接頭辞 a/b/c は、パターン a/b/c/# と同等です。

   connection | containerID

   ルーターによるブローカーへの接続方法。発信接続 (connection) またはブローカーのコンテナー ID (containerID) のいずれかを指定できます。

   この接続で複数のブローカーがルーターに接続されている場合、リンクルートの接頭辞またはパターンに一致するアドレスの要求がブローカー全体で分散されます。または、特定のブローカーを指定する場合は、containerID を使用し、ブローカーのコンテナー ID を追加します。

   direction

   このリンクルート上のルーターネットワークにメッセージを送信するように、この属性を in に設定します。

   その他の属性の詳細は、qdrouterd.conf の man ページの linkRoute を参照してください。

4. クライアントがこのリンクルート上のメッセージを受信するには、出力リンクルートを作成します。

   linkRoute {
       prefix: my_queue
       connection: my_broker
       direction: out
       ...
   }

   prefix | pattern

   ルーティングされたリンク割り当てを受信するブローカーキューに一致するアドレス接頭辞またはパターン。この接頭辞またはパターンに一致するメッセージはすべて、リンクルートとともに分散されます。接頭辞を指定して、アドレスの正確なアドレスまたは開始セグメントと一致するように指定できます。または、ワイルドカードを使用してアドレスに一致するパターンを指定できます。

   接頭辞は、. または / 文字のいずれかで区切られたアドレス内の正確なアドレスまたは最初のセグメントと一致します。たとえば、接頭辞 my_address は、my_address と my_address.1 および my_address/1 のアドレスと一致します。ただし、my_address1 と一致しません。

   パターンは、パターンに対応するアドレスと一致します。パターンは、. または / のいずれかで区切られた単語シーケンスです。ワイルドカード文字を使用して単語を表すことができます。* 文字は 1 つの単語にマッチし、# 文字はゼロ以上の単語のシーケンスと一致します。

   * および # 文字はワイルドカードとして予約されています。したがって、メッセージアドレスでは使用しないでください。

   アドレスパターンの作成に関する詳細は、「アドレスパターンの一致」 を参照してください。

   注記

   prefix 値を pattern に変換するには 、/# をそれに追加します。たとえば、接頭辞 a/b/c は、パターン a/b/c/# と同等です。

   connection | containerID

   ルーターによるブローカーへの接続方法。発信接続 (connection) またはブローカーのコンテナー ID (containerID) のいずれかを指定できます。

   この接続で複数のブローカーがルーターに接続されている場合、リンクルートの接頭辞またはパターンに一致するアドレスの要求がブローカー全体で分散されます。または、特定のブローカーを指定する場合は、containerID を使用し、ブローカーのコンテナー ID を追加します。

   direction

   このリンクルートが受信側用であることを指定するには、この属性を out に設定します。

   その他の属性の詳細は、qdrouterd.conf の man ページの linkRoute を参照してください。