第12章 ルーティングの設定

手順

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルで、ブローカーキューのを追加します。

   ポイントポイントアドレスは、メッセージをルーティングするブローカーのキューを識別します。以下の例では、my_queue キューのポイントアドレスを追加します。

   address {
       prefix: my_queue
       waypoint: yes
   }

   prefix | pattern

   メッセージの送信先のブローカーキューに一致するアドレス接頭辞またはパターン。接頭辞を指定して、アドレスの正確なアドレスまたは開始セグメントと一致するように指定できます。または、ワイルドカードを使用してアドレスに一致するパターンを指定できます。

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

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

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

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

   注記

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

   waypoint

   ルーターがこのアドレスに送信されたメッセージをポイントとして処理するように、この属性を yes に設定します。

2. ルーターをブローカーに接続します。

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

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

      注記

      ブローカーへの接続に失敗すると、AMQ Interconnect は自動的に接続を再確立し、メッセージ配信を利用可能な別の宛先に再ルーティングしようとします。ただし、一部の配信は RELEASED または MODIFIED で送信側に返される場合があります。したがって、クライアントがこれらの配信を適切に処理できるようにする必要があります (通常は再送することです)。

   2. メッセージをブローカーキューに送信する場合は、送信自動リンクをブローカーキューに追加します。

      キューが複数のブローカーにシャードされている場合は、各ブローカーに出力自動リンクを追加する必要があります。

      この例では、送信自動リンクを設定し、メッセージをブローカーキューに送信します。

      autoLink {
          address: my_queue
          connection: my_broker
          direction: out
          ...
      }

      address

      ブローカーキューのアドレス。自動リンクが作成されると、このアドレスに割り当てられます。

      externalAddress

      ブローカーキューのオプションの代替アドレス。ブローカーキューが送信者が使用するアドレスとは別のアドレスを持つ必要がある場合、外部アドレスを使用します。このシナリオでは、送信側は address アドレスにメッセージを送信し、ルーターはそれらを externalAddress アドレスで表されるブローカーキューにルーティングします。

      connection | containerID

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

      direction

      この属性を out に設定して、この自動リンクがルーターからブローカーにメッセージを送信できるように指定します。

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

3. ブローカーキューからメッセージを受信したい場合は、ブローカーキューから受信自動リンクを追加します。

   キューが複数のブローカーにシャードされている場合は、各ブローカーに出力自動リンクを追加する必要があります。

   この例では、受信自動リンクを設定し、ブローカーキューからメッセージを受信します。

   autoLink {
       address: my_queue
       connection: my_broker
       direction: in
       ...
   }

   address

   ブローカーキューのアドレス。自動リンクが作成されると、このアドレスに割り当てられます。

   externalAddress

   ブローカーキューのオプションの代替アドレス。ブローカーキューが受信者が使用するアドレスとは別のアドレスを持つ必要がある場合、外部アドレスを使用します。このシナリオでは、受信側は address アドレスからメッセージを受信し、ルーターは externalAddress アドレスで表されるブローカーキューからメッセージを取得します。

   connection | containerID

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

   direction

   この自動リンクがブローカーからルーターにメッセージを送受信するように指定するには、この属性を in に設定します。

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

1. /etc/qpid-dispatch/qdrouterd.conf 設定ファイルで、アドレスのフォールバック宛先を有効にします。

   address {
       prefix: my_address
       enableFallback: yes
   }

2. 発信自動リンクをブローカーのキューに追加します。

   フォールバックを有効にしたアドレスで、メッセージがコンシューマーにルーティング可能でない場合、ルーターはこの自動リンクを使用してメッセージをブローカーのキューに送信します。

   autoLink {
       address: my_address.2
       direction: out
       connection: my_broker
       fallback: yes
   }

3. ルーターネットワークに接続した直後に、ルーターがキューに置かれたメッセージを接続させる場合は、受信自動リンクを追加します。

   コンシューマーがルーターに接続するとすぐに、ブローカーキューに保管されたメッセージと、プロデューサーによって送信される新しいメッセージを受信します。キューに格納されたメッセージの元の配信順序は保持されますが、キューに置かれたメッセージは新しいメッセージによってインターリーブされます。

   受信自動リンクを追加しない場合、メッセージはブローカーに保存されますが、ルーターに割り当てるとコンシューマーには送信されません。

   autoLink {
       address: my_address.2
       direction: in
       connection: my_broker
       fallback: yes
   }