5.3. マルチプライマリーマルチネットワークメッシュのインストール
2 つの OpenShift Container Platform クラスターのマルチプライマリーマルチネットワークトポロジーに Istio をインストールします。
この手順では、CLUSTER1 は East クラスター、CLUSTER2 は West クラスターです。
これらの手順は、2 つ以上のクラスターにまたがるメッシュに適応できます。
前提条件
- メッシュを構成するすべてのクラスターに OpenShift Service Mesh 3 Operator をインストールした。
- 「マルチクラスターメッシュの証明書の作成」を完了した。
- 「マルチクラスタートポロジーへの証明書の適用」を完了した。
- Istio Container Network Interface (CNI) リソースを作成した。
-
この手順を実行するために使用できるノートパソコンに
istioctlをインストールした。
手順
以下のコマンドを実行して、インストールする Istio バージョンを定義する
ISTIO_VERSION環境変数を作成します。$ export ISTIO_VERSION=1.24.3Istio を East クラスターにインストールします。
次のコマンドを実行して、East クラスターに
Istioリソースを作成します。$ cat <<EOF | oc --context "${CTX_CLUSTER1}" apply -f - apiVersion: sailoperator.io/v1 kind: Istio metadata: name: default spec: version: v${ISTIO_VERSION} namespace: istio-system values: global: meshID: mesh1 multiCluster: clusterName: cluster1 network: network1 EOF次のコマンドを実行して、コントロールプレーンが
Readyステータス条件を返すまで待機します。$ oc --context "${CTX_CLUSTER1}" wait --for condition=Ready istio/default --timeout=3m次のコマンドを実行して、East クラスターに East-West ゲートウェイを作成します。
$ oc --context "${CTX_CLUSTER1}" apply -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/deployment-models/resources/east-west-gateway-net1.yaml次のコマンドを実行して、ゲートウェイを介してサービスを公開します。
$ oc --context "${CTX_CLUSTER1}" apply -n istio-system -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/deployment-models/resources/expose-services.yaml
Istio を West クラスターにインストールします。
次のコマンドを実行して、West クラスターに
Istioリソースを作成します。$ cat <<EOF | oc --context "${CTX_CLUSTER2}" apply -f - apiVersion: sailoperator.io/v1 kind: Istio metadata: name: default spec: version: v${ISTIO_VERSION} namespace: istio-system values: global: meshID: mesh1 multiCluster: clusterName: cluster2 network: network2 EOF次のコマンドを実行して、コントロールプレーンが
Readyステータス条件を返すまで待機します。$ oc --context "${CTX_CLUSTER2}" wait --for condition=Ready istio/default --timeout=3m次のコマンドを実行して、West クラスターに East-West ゲートウェイを作成します。
$ oc --context "${CTX_CLUSTER2}" apply -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/deployment-models/resources/east-west-gateway-net2.yaml次のコマンドを実行して、ゲートウェイを介してサービスを公開します。
$ oc --context "${CTX_CLUSTER2}" apply -n istio-system -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/deployment-models/resources/expose-services.yaml
次のコマンドを実行して、East クラスターの
istio-reader-service-accountサービスアカウントを作成します。$ oc --context="${CTX_CLUSTER1}" create serviceaccount istio-reader-service-account -n istio-system次のコマンドを実行して、West クラスターの
istio-reader-service-accountサービスアカウントを作成します。$ oc --context="${CTX_CLUSTER2}" create serviceaccount istio-reader-service-account -n istio-system次のコマンドを実行して、East クラスターに
cluster-readerロールを追加します。$ oc --context="${CTX_CLUSTER1}" adm policy add-cluster-role-to-user cluster-reader -z istio-reader-service-account -n istio-system次のコマンドを実行して、West クラスターに
cluster-readerロールを追加します。$ oc --context="${CTX_CLUSTER2}" adm policy add-cluster-role-to-user cluster-reader -z istio-reader-service-account -n istio-system次のコマンドを実行して、West クラスターの API サーバーへのアクセスを提供するリモートシークレットを、East クラスターにインストールします。
$ istioctl create-remote-secret \ --context="${CTX_CLUSTER2}" \ --name=cluster2 \ --create-service-account=false | \ oc --context="${CTX_CLUSTER1}" apply -f -次のコマンドを実行して、East クラスターの API サーバーへのアクセスを提供するリモートシークレットを、West クラスターにインストールします。
$ istioctl create-remote-secret \ --context="${CTX_CLUSTER1}" \ --name=cluster1 \ --create-service-account=false | \ oc --context="${CTX_CLUSTER2}" apply -f -
5.3.1. マルチクラスタートポロジーの確認 リンクのコピーリンクがクリップボードにコピーされました!
サンプルアプリケーションをデプロイし、2 つの OpenShift Container Platform クラスターのマルチクラスタートポロジーでトラフィックを確認します。
この手順では、CLUSTER1 は East クラスター、CLUSTER2 は West クラスターです。
前提条件
- メッシュを構成するすべてのクラスターに OpenShift Service Mesh Operator をインストールした。
- 「マルチクラスターメッシュの証明書の作成」を完了した。
- 「マルチクラスタートポロジーへの証明書の適用」を完了した。
- Istio Container Network Interface (CNI) リソースを作成した。
-
この手順を実行するために使用するノートパソコンに
istioctlをインストールした。 - マルチクラスタートポロジーをインストールした。
手順
East クラスターにサンプルアプリケーションをデプロイします。
次のコマンドを実行して、East クラスター上にサンプルアプリケーション namespace を作成します。
$ oc --context "${CTX_CLUSTER1}" get project sample || oc --context="${CTX_CLUSTER1}" new-project sample以下のコマンドを実行して、サイドカーインジェクションをサポートするようにアプリケーション namespace にラベルを付けます。
$ oc --context="${CTX_CLUSTER1}" label namespace sample istio-injection=enabledhelloworldアプリケーションをデプロイします。以下のコマンドを実行して
helloworldサービスを作成します。$ oc --context="${CTX_CLUSTER1}" apply \ -f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/helloworld/helloworld.yaml \ -l service=helloworld -n sample以下のコマンドを実行して
helloworld-v1デプロイメントを作成します。$ oc --context="${CTX_CLUSTER1}" apply \ -f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/helloworld/helloworld.yaml \ -l version=v1 -n sample
次のコマンドを実行して、
sleepアプリケーションをデプロイします。$ oc --context="${CTX_CLUSTER1}" apply \ -f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/sleep/sleep.yaml -n sample次のコマンドを実行して、East クラスターの
helloworldアプリケーションがReadyステータス条件を返すまで待機します。$ oc --context="${CTX_CLUSTER1}" wait --for condition=available -n sample deployment/helloworld-v1次のコマンドを実行して、East クラスターの
sleepアプリケーションがReadyステータス条件を返すまで待機します。$ oc --context="${CTX_CLUSTER1}" wait --for condition=available -n sample deployment/sleep
West クラスターにサンプルアプリケーションをデプロイします。
次のコマンドを実行して、West クラスターにサンプルアプリケーション namespace を作成します。
$ oc --context "${CTX_CLUSTER2}" get project sample || oc --context="${CTX_CLUSTER2}" new-project sample以下のコマンドを実行して、サイドカーインジェクションをサポートするようにアプリケーション namespace にラベルを付けます。
$ oc --context="${CTX_CLUSTER2}" label namespace sample istio-injection=enabledhelloworldアプリケーションをデプロイします。以下のコマンドを実行して
helloworldサービスを作成します。$ oc --context="${CTX_CLUSTER2}" apply \ -f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/helloworld/helloworld.yaml \ -l service=helloworld -n sample以下のコマンドを実行して、
helloworld-v2デプロイメントを作成します。$ oc --context="${CTX_CLUSTER2}" apply \ -f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/helloworld/helloworld.yaml \ -l version=v2 -n sample
次のコマンドを実行して、
sleepアプリケーションをデプロイします。$ oc --context="${CTX_CLUSTER2}" apply \ -f https://raw.githubusercontent.com/openshift-service-mesh/istio/release-1.24/samples/sleep/sleep.yaml -n sample次のコマンドを実行して、West クラスターの
helloworldアプリケーションがReadyステータス条件を返すまで待機します。$ oc --context="${CTX_CLUSTER2}" wait --for condition=available -n sample deployment/helloworld-v2次のコマンドを実行して、West クラスターの
sleepアプリケーションがReadyステータス条件を返すまで待機します。$ oc --context="${CTX_CLUSTER2}" wait --for condition=available -n sample deployment/sleep
クラスター間のトラフィックフローの確認
East クラスターの場合は、次のコマンドを実行して、
helloworldサービスに 10 個のリクエストを送信します。$ for i in {0..9}; do \ oc --context="${CTX_CLUSTER1}" exec -n sample deploy/sleep -c sleep -- curl -sS helloworld.sample:5000/hello; \ done両方のクラスターからの応答が表示されていることを確認します。つまり、サービスのバージョン 1 とバージョン 2 が応答で確認できます。
West クラスターの場合は、
helloworldサービスに 10 個のリクエストを送信します。$ for i in {0..9}; do \ oc --context="${CTX_CLUSTER2}" exec -n sample deploy/sleep -c sleep -- curl -sS helloworld.sample:5000/hello; \ done両方のクラスターからの応答が表示されていることを確認します。つまり、サービスのバージョン 1 とバージョン 2 が応答で確認できます。
5.3.2. 開発環境からのマルチクラスタートポロジーの削除 リンクのコピーリンクがクリップボードにコピーされました!
開発環境でマルチクラスター機能を試した後、すべてのクラスターからマルチクラスタートポロジーを削除します。
この手順では、CLUSTER1 は East クラスター、CLUSTER2 は West クラスターです。
前提条件
- マルチクラスタートポロジーをインストールした。
手順
次のコマンドを実行して、Istio とサンプルアプリケーションを開発環境の East クラスターから削除します。
$ oc --context="${CTX_CLUSTER1}" delete istio/default ns/istio-system ns/sample ns/istio-cni次のコマンドを実行して、Istio とサンプルアプリケーションを開発環境の West クラスターから削除します。
$ oc --context="${CTX_CLUSTER2}" delete istio/default ns/istio-system ns/sample ns/istio-cni