2.3. AMQ Broker Operator のインストール
本セクションの手順では以下の方法を説明します。
- Operator for AMQ Broker 7.4 の最新バージョンのインストール
- ブローカーデプロイメント用のAMQ Broker 7.4の最新ブローカーコンテナーイメージの指定
以下では、Operator のインストールについて注意すべき重要な事項について説明します。
- AMQ Broker 7.4 は、Long Term Support (LTS) リリースバージョンとして指定されています。バグ修正およびセキュリティーアドバイザリーは、少なくとも 12 カ月間、一連のマイクロリリース(7.4.1、7.42、7.3 など)で AMQ Broker 7.4 で利用可能になります。つまり、新しいマイナーリリースにアップグレード することなく、AMQ Broker の最新のバグ修正およびセキュリティーアドバイザリーを取得できます。
- サポート対象の設定を維持するには、LTS リリースストリームの最新マイクロリリースにアップグレードする必要があります。つまり、ブローカーデプロイメントの LTS ストリームから最新のブローカーコンテナーイメージを使用する必要があります。ここでは、AMQ Broker Operator をベースとしたブローカーデプロイメントの最新ブローカーコンテナーイメージを指定する方法を説明します。
- AMQ Broker Operator for AMQ Broker 7.4 のバージョン 0.6 は、テクノロジープレビュー機能としてのみご利用いただけます。Operator のバージョン 0.6 が OpenShift プロジェクトにインストールされている場合、Operator を最新の LTS(Long Term Support)バージョンに更新することが推奨されます。Operator の LTS バージョンには、バグおよびセキュリティーアドバイザリーの修正が含まれます。Red Hat は、実稼働環境での使用のために Operator の LTS バージョンをサポートします。
- AMQ Broker Operator のバージョン 0.6 によって使用されるカスタムリソース定義(CRD)は、Long Term Support(LTS)バージョンと互換性がありません。Operator の最新の LTS バージョンをインストールするには、最新の CRD をデプロイする前に、OpenShift クラスターにデプロイされた CRD を削除する必要があります。また、Operator の LTS バージョンをインストールするプロジェクトから既存の Operator およびブローカーデプロイメントを削除する必要もあります。以下の手順は、本項の手順で説明します。
- 最新の CRD をデプロイするには、OpenShift クラスターのクラスター管理者権限が必要です。管理者以外のユーザーは、カスタムリソース(CR)をデプロイして OpenShift プロジェクトにブローカーインスタンスを作成できます。
- 最新の CRD で OpenShift クラスターを更新すると、この更新はクラスター内の すべてのプロジェクト に影響します。バージョン 0.6 から以前にデプロイされたブローカー Pod は機能しなくなりました。OpenShift クラスターの影響を受ける各プロジェクトを、Operator の LTS バージョンを使用するように更新する必要があります。その後、Operator の LTS バージョンに含まれるカスタムリソース(CR)をデプロイして、以前のブローカーデプロイメントを再作成できます。
2.3.1. Operator コードの取得 リンクのコピーリンクがクリップボードにコピーされました!
この手順では、AMQ Broker 7.4 用の Operator の最新の LTS バージョンをインストールするために必要なコードにアクセスして準備する方法を説明します。
手順
- Web ブラウザーで、AMQ Broker Software Downloads ページ に移動します。
-
Version ドロップダウンメニューで
7.4.6を選択します。 AMQ Broker 7.4.6 Operator Installation and Example Files の横にある Download をクリックします。
amq-broker-operator-7.4.6-ocp-install-examples.zip圧縮アーカイブのダウンロードが自動的に開始されます。ダウンロードが完了したら、アーカイブを選択したインストールディレクトリーに移動します。以下の例では、アーカイブを
/broker/operatorというディレクトリーに移動します。sudo mv amq-broker-operator-7.4.6-ocp-install-examples.zip /broker/operator選択したインストールディレクトリーで、アーカイブの内容を展開します。以下に例を示します。
cd /broker/operator sudo unzip amq-broker-operator-7.4.6-ocp-install-examples.zipクラスター管理者として OpenShift Container Platform にログインします。以下に例を示します。
$ oc login -u system:adminOperator をインストールするプロジェクトを指定します。新規プロジェクトを作成するか、または既存プロジェクトに切り替えることができます。
新しいプロジェクトを作成します。
$ oc new-project <project_name>または、既存のプロジェクトに切り替えます。
$ oc project <project_name>
Operator で使用するサービスアカウントを指定します。
-
展開した Operator アーカイブの
deployディレクトリーで、service_account.yamlファイルを開きます。 -
kind要素がServiceAccountに設定されていることを確認します。 -
metadataセクションで、カスタム名をサービスアカウントに割り当てるか、デフォルト名を使用します。デフォルトの名前はamq-broker-operatorです。 プロジェクトにサービスアカウントを作成します。
$ oc create -f deploy/service_account.yaml
-
展開した Operator アーカイブの
Operator のロール名を指定します。
-
role.yamlファイルを開きます。このファイルは、Operator が使用できるリソースを指定し、変更します。 -
kind要素がRoleに設定されていることを確認します。 -
metadataセクションで、カスタム名をロールに割り当てるか、デフォルト名を使用します。デフォルトの名前はamq-broker-operatorです。 プロジェクトにロールを作成します。
$ oc create -f deploy/role.yaml
-
Operator のロールバインディングを指定します。ロールバインディングは、指定した名前に基づいて、事前に作成されたサービスアカウントを Operator ロールにバインドします。
role_binding.yamlファイルを開きます。ServiceAccountとRoleのnameの値がservice_account.yamlおよびrole.yamlファイルで指定された値と一致していることを確認します。以下に例を示します。metadata: name: amq-broker-operator subjects: kind: ServiceAccount name: amq-broker-operator roleRef: kind: Role name: amq-broker-operatorプロジェクトでロールバインディングを作成します。
$ oc create -f deploy/role_binding.yaml