第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 をインストールするのに必要なコードにアクセスし、準備する方法を説明します。

手順

  1. Web ブラウザーで、AMQ Interconnect リリースSoftware Downloads ページに移動します。
  2. Version ドロップダウンリストの値が 1.10.7 に設定され、Releases タブが選択されていることを確認します。
  3. AMQ Interconnect 1.10.7 Operator Installation and Example Files の横にある Download をクリックします。

    amq-interconnect-operator-1.10.7-ocp-install-examples.zip 圧縮アーカイブのダウンロードが自動的に開始します。

  4. ダウンロードが完了したら、アーカイブを選択したインストールディレクトリーに移動します。以下の例では、アーカイブを ~/router/operator という名前のディレクトリーに移動します。

    $ mkdir ~/router
    $ mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/router
  5. 選択したインストールディレクトリーで、アーカイブの内容を展開します。以下に例を示します。

    $ cd ~/router
    $ unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zip
  6. アーカイブの展開時に作成されたディレクトリーに移動します。以下に例を示します。

    $ cd operator
  7. クラスター管理者として OpenShift Container Platform にログインします。以下に例を示します。

    $ oc login -u system:admin
  8. Operator をインストールするプロジェクトを指定します。新規プロジェクトを作成するか、または既存プロジェクトに切り替えることができます。

    1. 新しいプロジェクトを作成します。

      $ oc new-project <project-name>
    2. または、既存のプロジェクトに切り替えます。

      $ oc project <project-name>
  9. Operator で使用するサービスアカウントを作成します。

    $ oc create -f deploy/service_account.yaml
  10. Operator のロールを作成します。

    $ oc create -f deploy/role.yaml
  11. Operator のロールバインディングを作成します。ロールバインディングは、指定した名前に基づいて、事前に作成されたサービスアカウントを Operator ロールにバインドします。

    $ oc create -f deploy/role_binding.yaml

以下の手順では、Operator をプロジェクトにデプロイします。

3.1.2. CLI を使用した Operator のデプロイ

本セクションの手順では、OpenShift コマンドラインインターフェイス (CLI) を使用して、OpenShift プロジェクトに最新バージョンの AMQ Interconnect 1.10 用 Operator デプロイする方法を説明します。

前提条件

手順

  1. OpenShift コマンドラインインターフェイス (CLI) で、クラスター管理者として OpenShift Container Platform にログインします。以下に例を示します。

    $ oc login -u system:admin
  2. Operator デプロイメント用に以前に準備したプロジェクトに切り替えます。以下に例を示します。

    $ oc project <project-name>
  3. 以前の手順で Operator インストールアーカイブを展開する際に作成されたディレクトリーに移動します。以下に例を示します。

    $ cd ~/router/operator/qdr-operator-1.10-ocp-install-examples
  4. Operator に含まれる CRD をデプロイします。Operator をデプロイし、起動する前に、CRD を OpenShift クラスターにインストールする必要があります。

    $ oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yaml
  5. Red Hat Ecosystem Catalog での認証に使用されるアカウントに関連付けられたプルシークレットを、OpenShift プロジェクトの defaultdeployer、および 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>
    注記

    OpenShift Container Platform 4.1 以降では、Web コンソールを使用して、プルシークレットを AMQ Interconnect Operator などのコンテナーイメージをデプロイするプロジェクトに関連付けることもできます。そのためには、AdministrationService Accounts をクリックします。Red Hat コンテナーレジストリーでの認証に使用するアカウントに関連付けられたプルシークレットを指定します。

  6. Operator をデプロイします。

    $ oc create -f deploy/operator.yaml
  7. Operator が実行されていることを確認します。

    $ oc get pods -l name=qdr-operator

    出力が Pod が実行されていることを報告しない場合は、以下のコマンドを使用して、実行を妨げている問題を判別します。

    $ oc describe pod -l name=qdr-operator
  8. CRD がクラスターに登録されていることを確認し、CRD の詳細を確認します。

    $ oc get crd
    $ oc describe crd interconnects.interconnectedcloud.github.io
注記

所定の OpenShift プロジェクトに AMQ Interconnect Operator の 単一インスタンス のみをデプロイすることが推奨されます。Operator デプロイメントの replicas 要素を 1 より大きい値に設定したり、同じプロジェクトで Operator を 複数回デプロイしたりすることは 推奨されません

関連情報