第4章 Operator ベースのブローカーデプロイメントの設定

手順

1. カスタムリソース (CR) インスタンスの設定を開始し、ブローカーデプロイメントのアドレスおよびキューを定義します。

   1. OpenShift コマンドラインインターフェイスの使用:

      1. ブローカーのデプロイメントを含むプロジェクトの管理者権限で OpenShift にログインします。

         oc login -u <user> -p <password> --server=<host:port>

      2. ダウンロードした Operator インストールアーカイブの deploy/crs ディレクトリーに含まれる broker_activemqartemisaddress_cr.yaml というサンプル CR ファイルを開きます。

   2. OpenShift Container Platform Web コンソールの使用

      1. ブローカーのデプロイメントを含むプロジェクトの管理者権限でコンソールにログインします。
      2. アドレス CRD に基づいて新規 CR インスタンスを起動します。左側のペインで、Administration → Custom Resource Definitions をクリックします。
      3. ActiveMQArtemisAddresss CRD をクリックします。
      4. Instances タブをクリックします。

      5. Create ActiveMQArtemisAddress をクリックします。

         コンソールで、YAML エディターが開き、CR インスタンスを設定できます。

2. CR の spec セクションで、行を追加してアドレス、キュー、およびルーティングタイプを定義します。以下に例を示します。

   apiVersion: broker.amq.io/v2alpha2
   kind: ActiveMQArtemisAddress
   metadata:
       name: myAddressDeployment0
       namespace: myProject
   spec:
       ...
       addressName: myAddress0
       queueName: myQueue0
       routingType: anycast
       ...

   上記の設定では、myQueue0 という名前のキューと anycast ルーティングタイプを持つ myAddress0 という名前のアドレスが定義されます。

   注記

   metadata セクションで、namespace プロパティーを追加し、OpenShift Container Platform Web コンソールを使用して CR インスタンスを作成する場合にのみ値を指定する必要があります。指定する値は、ブローカーデプロイメントの OpenShift プロジェクトの名前です。

3. CR インスタンスをデプロイします。

   1. OpenShift コマンドラインインターフェイスの使用:

      1. CR ファイルを保存します。

      2. ブローカーのデプロイメントが含まれるプロジェクトに切り替えます。

         $ oc project <project-name>

      3. CR を作成します。

         $ oc create -f <path/to/address-custom-resource-instance>.yaml

   2. OpenShift Web コンソールの使用

      1. CR の設定が完了したら、Create をクリックします。

4. (オプション) CR インスタンスを使用して以前にデプロイメントに追加されたアドレスおよびキューを削除するには、以下のコマンドを使用します。

   $ oc delete -f <path/to/address-custom-resource-instance>.yaml

手順

1. CR インスタンスを設定して、デッドレターアドレスとキューを追加して、デプロイメント内の各ブローカーの配信されていないメッセージを受信します。

   1. OpenShift コマンドラインインターフェイスの使用:

      1. ブローカーのデプロイメントを含むプロジェクトの管理者権限で OpenShift にログインします。

         oc login -u <user> -p <password> --server=<host:port>

      2. ダウンロードした Operator インストールアーカイブの deploy/crs ディレクトリーに含まれる broker_activemqartemisaddress_cr.yaml というサンプル CR ファイルを開きます。

   2. OpenShift Container Platform Web コンソールの使用

      1. ブローカーのデプロイメントを含むプロジェクトの管理者権限でコンソールにログインします。
      2. アドレス CRD に基づいて新規 CR インスタンスを起動します。左側のペインで、Administration → Custom Resource Definitions をクリックします。
      3. ActiveMQArtemisAddresss CRD をクリックします。
      4. Instances タブをクリックします。

      5. Create ActiveMQArtemisAddress をクリックします。

         コンソールで、YAML エディターが開き、CR インスタンスを設定できます。

2. CR の spec セクションで、未配信のメッセージを受信するデッドレターアドレスおよびキューを指定する行を追加します。以下に例を示します。

   apiVersion: broker.amq.io/v2alpha2
   kind: ActiveMQArtemisAddress
   metadata:
       name: ex-aaoaddress
   spec:
       ...
       addressName: myDeadLetterAddress
       queueName: myDeadLetterQueue
       routingType: anycast
       ...

   上記の設定では、myDeadLetterQueue という名前のデッドレターキューと anycast ルーティングタイプを持つ myDeadLetterAddress という名前のデッドレターアドレスを定義します。

   注記

   metadata セクションで、namespace プロパティーを追加し、OpenShift Container Platform Web コンソールを使用して CR インスタンスを作成する場合にのみ値を指定する必要があります。指定する値は、ブローカーデプロイメントの OpenShift プロジェクトの名前です。

3. アドレス CR インスタンスをデプロイします。

   1. OpenShift コマンドラインインターフェイスの使用:

      1. CR ファイルを保存します。

      2. ブローカーデプロイメントのプロジェクトに切り替えます。

         $ oc project <project-name>

      3. アドレス CR を作成します。

         $ oc create -f <path/to/address-custom-resource-instance>.yaml

   2. OpenShift Web コンソールの使用

      1. CR の設定が完了したら、Create をクリックします。

4. ブローカーデプロイメントのカスタムリソース (CR) インスタンスの設定を開始します。

   1. CR ファイルのサンプルの場合:

      1. ダウンロードした Operator インストールアーカイブの deploy/crs ディレクトリーに含まれる broker_activemqartemis_cr.yaml というサンプル CR ファイルを開きます。

   2. OpenShift Container Platform Web コンソールの使用

      1. メインブローカー CRD に基づいて新規 CR インスタンスを起動します。左側のペインで、Administration → Custom Resource Definitions をクリックします。
      2. ActiveMQArtemis CRD をクリックします。
      3. Instances タブをクリックします。

      4. Create ActiveMQArtemis をクリックします。

         コンソールで、YAML エディターが開き、CR インスタンスを設定できます。

   基本的なブローカーデプロイメントの場合、設定が以下のように表示される可能性があります。

   apiVersion: broker.amq.io/v2alpha3
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.7.0
       deploymentPlan:
           size: 3
           image: registry.redhat.io/amq7/amq-broker:7.7
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true

   注記

   metadata セクションで、namespace プロパティーを追加し、OpenShift Container Platform Web コンソールを使用して CR インスタンスを作成する場合にのみ値を指定する必要があります。指定する値は、ブローカーデプロイメントの OpenShift プロジェクトの名前です。

5. CR の deploymentPlan セクションで、以下に示すように単一の addressSetting セクションが含まれる新規 addressSettings セクションを追加します。

   spec:
       version: 7.7.0
       deploymentPlan:
           size: 3
           image: registry.redhat.io/amq7/amq-broker:7.7
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:

6. addressSetting ブロックに match プロパティーのインスタンスを 1 つ追加します。アドレス一致式を指定します。以下に例を示します。

   spec:
       version: 7.7.0
       deploymentPlan:
           size: 3
           image: registry.redhat.io/amq7/amq-broker:7.7
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:
                -  match: myAddress

   match

   ブローカーが以下の設定を適用するアドレスまたはアドレスのセットを指定します。この例では、match プロパティーの値は myAddress と呼ばれる単一のアドレスに対応します。

7. 未配信メッセージに関連するプロパティーを追加し、値を指定します。以下に例を示します。

   spec:
       version: 7.7.0
       deploymentPlan:
           size: 3
           image: registry.redhat.io/amq7/amq-broker:7.7
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:
                -  match: myAddress
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 5

   deadLetterAddress

   ブローカーが未達のメッセージを送信するアドレス。

   maxDeliveryAttempts

   メッセージを設定済みのデッドレターアドレスに移動する前にブローカーが行う最大配信試行数。

   上記の例では、ブローカーによって、myAddress で始まるアドレスにメッセージの配信が 5 回失敗する場合、ブローカーはメッセージを指定の dead letter address (myDeadLetterAddress) に移動します。

8. (オプション) 別のアドレスまたはアドレスセットに同様の設定を適用します。以下に例を示します。

   spec:
       version: 7.7.0
       deploymentPlan:
           size: 3
           image: registry.redhat.io/amq7/amq-broker:7.7
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:
                -  match: myAddress
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 5
                -  match: 'myOtherAddresses*'
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 3

   この例では、2 つ目の match プロパティーの値にはアスタリスクワイルドカード文字が含まれます。ワイルドカード文字では、上記の設定が文字列 myOtherAddresses で始まる任意のアドレスに適用されることを意味します。

   注記

   ワイルドカード式を match プロパティーの値として使用する場合には、値を単一引用符で囲む必要があります (例: 'myOtherAddresses*')。

9. addressSettings セクションの最初に applyRule プロパティーを追加し、値を指定します。以下に例を示します。

   spec:
       version: 7.7.0
       deploymentPlan:
           size: 3
           image: registry.redhat.io/amq7/amq-broker:7.7
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               applyRule: merge_all
               addressSetting:
                -  match: myAddress
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 5
                -  match: 'myOtherAddresses*'
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 3

   applyRule プロパティーは、Operator を一致するアドレスまたはアドレスのセットごとに CR に追加する設定を適用する方法を指定します。指定できる値は次のとおりです。

   merge_all

   • CR で指定されるアドレス設定と、同じアドレスまたはアドレスのセットに一致するデフォルト設定の両方の場合:

     • デフォルト設定で指定されるプロパティー値を CR で指定されたプロパティー値に置き換えます。
     • CR またはデフォルト設定で一意で指定されるプロパティー値を保持します。これらはそれぞれ最終マージされた設定の組み込みます。
   • CR で指定されるアドレス設定または特定のアドレスセットに一意になるデフォルト設定の場合は、これらを最終でマージされた設定に含めます。

   merge_replace

   • CR に指定されたアドレス設定と、同じアドレスまたはアドレスセットに一致するデフォルト設定について、最終的なマージされた設定の CR に指定された設定を含めます。それらのプロパティーが CR で指定されていない場合でも、デフォルト設定に指定されたプロパティーを含めないでください。
   • CR で指定されるアドレス設定または特定のアドレスセットに一意になるデフォルト設定の場合は、これらを最終でマージされた設定に含めます。

   replace_all

   デフォルト設定に指定されたすべてのアドレス設定を CR で指定されたアドレス設定に置き換えます。最後にマージされた設定は、CR で指定したものと完全に対応します。

   注記

   CR に applyRule プロパティーを明示的に含ない場合、Operator は merge_all のデフォルト値を使用します。

10. ブローカー CR インスタンスをデプロイします。

    1. OpenShift コマンドラインインターフェイスの使用:

       1. CR ファイルを保存します。

       2. CR を作成します。

          $ oc create -f <path/to/broker-custom-resource-instance>.yaml

    2. OpenShift Web コンソールの使用

       1. CR の設定が完了したら、Create をクリックします。