3.2. OpenShift での AMQ Streams ストレージを使用した Service Registry のインストール
このトピックでは、OpenShift テンプレートを使用して Red Hat AMQ Streams でストレージで Service Registry をインストールし、実行する方法を説明します。
以下のバージョンがサポートされます。
- AMQ Streams 1.4 または 1.3
- OpenShift 4.3、4.2、または 3.11
前提条件
- クラスター管理者として OpenShift クラスターにアクセスできる。
- AMQ Streams がすでにインストールされ、OpenShift に Kafka クラスターを設定している。「OpenShift での AMQ Streams ストレージの設定」を参照してください。
Red Hat Container Catalog で Service Registry イメージにアクセスできることを確認します。
- イメージのサービスアカウントおよびプルシークレットを作成します。詳細は、「コンテナーサービス アカウント」を参照 してください。
プルシークレットをダウンロードし、これを OpenShift クラスターに送信します。以下に例を示します。
oc create -f 11223344_service-registry-secret.yaml --namespace=myproject
$ oc create -f 11223344_service-registry-secret.yaml --namespace=myproject
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
手順
- Service Registry OpenShift テンプレート を取得します。
以下のコマンドを入力し、OpenShift クラスターの AMQ Streams で実行されている Kafka ブートストラップサービスの名前を取得します。
oc get services | grep .*kafka-bootstrap
$ oc get services | grep .*kafka-bootstrap
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc new-app
コマンドを使用して、新しい OpenShift アプリケーションを作成します。以下に例を示します。oc new-app service-registry-template.yml \ -p KAFKA_BOOTSTRAP_SERVERS=my-cluster-kafka-bootstrap:9092 \ -p REGISTRY_ROUTE=my-cluster-service-registry-myproject.example.com \ -p APPLICATION_ID=my-kafka-streams-app
$ oc new-app service-registry-template.yml \ -p KAFKA_BOOTSTRAP_SERVERS=my-cluster-kafka-bootstrap:9092 \ -p REGISTRY_ROUTE=my-cluster-service-registry-myproject.example.com \ -p APPLICATION_ID=my-kafka-streams-app
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下の引数を指定する必要があります。
-
service-registry-template.yml
: Service Registry の OpenShift テンプレートファイル。 -
KAFKA_BOOTSTRAP_SERVERS
: OpenShift クラスターの Kafka ブートストラップサービスの名前、その後に Kafka ブローカーポート。例:my-cluster-kafka-bootstrap:9092
-
REGISTRY_ROUTE
: OpenShift クラスター環境に基づく Service Registry を公開する OpenShift ルートの名前。例:my-cluster-service-registry-myproject.example.com
。 APPLICATION_ID
: AMQ Streams アプリケーションの名前。例:my-kafka-streams-app
-e
オプションを使用して、以下の環境変数を指定することもできます。-
APPLICATION_SERVER_HOST
: マルチノードの Kafka 設定に必要な Kafka Streams アプリケーションサーバーホストの IP アドレス。デフォルトは$(POD_IP)
です。 -
APPLICATION_SERVER_PORT
: マルチノードの Kafka 設定に必要な Kafka Streams アプリケーションサーバーのポート番号。デフォルトは9000
です。
-
完了したら、コマンドの出力を確認します。以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
oc status
を入力して、OpenShift での Service Registry インストールを表示します。
関連情報
- REST API 要求のサンプルについては、Registry REST API のドキュメント を参照してください。
クライアントアプリケーションの例の詳細: