第3章 Red Hat Integration - AMQ Interconnect Operator の追加
Red Hat Integration - AMQ Interconnect Operator は、OpenShift Container Platform に AMQ Interconnect ルーターネットワークを作成し、管理します。この Operator は、これを使用するプロジェクトごとに個別にインストールする必要があります。
Operator をインストールするためのオプションは次のとおりです。
Operator をインストールするには、OpenShift クラスターの管理者権限が必要です。
3.1. CLI を使用した Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
本セクションの手順では、OpenShift コマンドラインインターフェイス (CLI) を使用して、指定の OpenShift プロジェクトに Red Hat Integration - AMQ Interconnect Operator の最新バージョンをインストールし、デプロイする方法を説明します。
3.1.1. Operator コードの取得 リンクのコピーリンクがクリップボードにコピーされました!
この手順では、最新バージョンの AMQ Interconnect 1.10 用 Operator をインストールするのに必要なコードにアクセスし、準備する方法を説明します。
手順
- Web ブラウザーで、AMQ Interconnect リリース の Software Downloads ページに移動します。
-
Version ドロップダウンリストの値が
1.10.7に設定され、Releases タブが選択されていることを確認します。 AMQ Interconnect 1.10.7 Operator Installation and Example Files の横にある Download をクリックします。
amq-interconnect-operator-1.10.7-ocp-install-examples.zip圧縮アーカイブのダウンロードが自動的に開始します。ダウンロードが完了したら、アーカイブを選択したインストールディレクトリーに移動します。以下の例では、アーカイブを
~/router/operatorという名前のディレクトリーに移動します。mkdir ~/router mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/router
$ mkdir ~/router $ mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/routerCopy to Clipboard Copied! Toggle word wrap Toggle overflow 選択したインストールディレクトリーで、アーカイブの内容を展開します。以下に例を示します。
cd ~/router unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zip
$ cd ~/router $ unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zipCopy to Clipboard Copied! Toggle word wrap Toggle overflow アーカイブの展開時に作成されたディレクトリーに移動します。以下に例を示します。
cd operator
$ cd operatorCopy to Clipboard Copied! Toggle word wrap Toggle overflow クラスター管理者として OpenShift Container Platform にログインします。以下に例を示します。
oc login -u system:admin
$ oc login -u system:adminCopy to Clipboard Copied! Toggle word wrap Toggle overflow Operator をインストールするプロジェクトを指定します。新規プロジェクトを作成するか、または既存プロジェクトに切り替えることができます。
新しいプロジェクトを作成します。
oc new-project <project-name>
$ oc new-project <project-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow または、既存のプロジェクトに切り替えます。
oc project <project-name>
$ oc project <project-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Operator で使用するサービスアカウントを作成します。
oc create -f deploy/service_account.yaml
$ oc create -f deploy/service_account.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Operator のロールを作成します。
oc create -f deploy/role.yaml
$ oc create -f deploy/role.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Operator のロールバインディングを作成します。ロールバインディングは、指定した名前に基づいて、事前に作成されたサービスアカウントを Operator ロールにバインドします。
oc create -f deploy/role_binding.yaml
$ oc create -f deploy/role_binding.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
以下の手順では、Operator をプロジェクトにデプロイします。
3.1.2. CLI を使用した Operator のデプロイ リンクのコピーリンクがクリップボードにコピーされました!
本セクションの手順では、OpenShift コマンドラインインターフェイス (CLI) を使用して、OpenShift プロジェクトに最新バージョンの AMQ Interconnect 1.10 用 Operator デプロイする方法を説明します。
前提条件
- Operator デプロイメントのために OpenShift プロジェクトを準備している必要がある。「Operator コードの取得」を参照してください。
- 本セクションの手順を実行する前に、Red Hat Container Registry Authentication で説明されている手順を完了する必要があります。
手順
OpenShift コマンドラインインターフェイス (CLI) で、クラスター管理者として OpenShift Container Platform にログインします。以下に例を示します。
oc login -u system:admin
$ oc login -u system:adminCopy to Clipboard Copied! Toggle word wrap Toggle overflow Operator デプロイメント用に以前に準備したプロジェクトに切り替えます。以下に例を示します。
oc project <project-name>
$ oc project <project-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以前の手順で Operator インストールアーカイブを展開する際に作成されたディレクトリーに移動します。以下に例を示します。
cd ~/router/operator/qdr-operator-1.10-ocp-install-examples
$ cd ~/router/operator/qdr-operator-1.10-ocp-install-examplesCopy to Clipboard Copied! Toggle word wrap Toggle overflow Operator に含まれる CRD をデプロイします。Operator をデプロイし、起動する前に、CRD を OpenShift クラスターにインストールする必要があります。
oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yaml
$ oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Ecosystem Catalog での認証に使用されるアカウントに関連付けられたプルシークレットを、OpenShift プロジェクトの
default、deployer、およびbuilderサービスアカウントにリンクします。oc secrets link --for=pull default <secret-name> oc secrets link --for=pull deployer <secret-name> oc secrets link --for=pull builder <secret-name>
$ oc secrets link --for=pull default <secret-name> $ oc secrets link --for=pull deployer <secret-name> $ oc secrets link --for=pull builder <secret-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記OpenShift Container Platform 4.1 以降では、Web コンソールを使用して、プルシークレットを AMQ Interconnect Operator などのコンテナーイメージをデプロイするプロジェクトに関連付けることもできます。そのためには、
をクリックします。Red Hat コンテナーレジストリーでの認証に使用するアカウントに関連付けられたプルシークレットを指定します。 Operator をデプロイします。
oc create -f deploy/operator.yaml
$ oc create -f deploy/operator.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Operator が実行されていることを確認します。
oc get pods -l name=qdr-operator
$ oc get pods -l name=qdr-operatorCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力が Pod が実行されていることを報告しない場合は、以下のコマンドを使用して、実行を妨げている問題を判別します。
oc describe pod -l name=qdr-operator
$ oc describe pod -l name=qdr-operatorCopy to Clipboard Copied! Toggle word wrap Toggle overflow CRD がクラスターに登録されていることを確認し、CRD の詳細を確認します。
oc get crd oc describe crd interconnects.interconnectedcloud.github.io
$ oc get crd $ oc describe crd interconnects.interconnectedcloud.github.ioCopy to Clipboard Copied! Toggle word wrap Toggle overflow
所定の OpenShift プロジェクトに AMQ Interconnect Operator の 単一インスタンス のみをデプロイすることが推奨されます。Operator デプロイメントの replicas 要素を 1 より大きい値に設定したり、同じプロジェクトで Operator を 複数回デプロイしたりすることは 推奨されません。
関連情報
- OperatorHub グラフィカルインターフェイスを使用する AMQ Interconnect Operator の別のインストール方法は、「Operator Lifecycle Manager を使用した Operator のインストール」を参照してください。