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
手順
- Service Registry OpenShift テンプレート を取得します。
以下のコマンドを入力し、OpenShift クラスターの AMQ Streams で実行されている Kafka ブートストラップサービスの名前を取得します。
$ oc get services | grep .*kafka-bootstrap
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
以下の引数を指定する必要があります。
-
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
です。
-
完了したら、コマンドの出力を確認します。以下に例を示します。
Deploying template "myproject/service-registry" for "service-registry-template.yml" to project myproject service-registry --------- Congratulations on deploying Service Registry into OpenShift! All components have been deployed and configured. * With parameters: * Registry Route Name=my-cluster-service-registry-myproject.example.com * Registry Max Memory Limit=1300Mi * Registry Memory Requests=600Mi * Registry Max CPU Limit=1 * Registry CPU Requests=100m * Kafka Bootstrap Servers=my-cluster-kafka-bootstrap:9092 * Kafka Application ID=my-kafka-streams-app --> Creating resources ... imagestream.image.openshift.io "registry" created service "service-registry" created deploymentconfig.apps.openshift.io "service-registry" created route.route.openshift.io "service-registry" created --> Success Access your application via route 'my-cluster-service-registry-myproject.example.com'
-
oc status
を入力して、OpenShift での Service Registry インストールを表示します。
関連情報
- REST API 要求のサンプルについては、Registry REST API のドキュメント を参照してください。
クライアントアプリケーションの例の詳細: