5.4. プライマリーリモートマルチネットワークメッシュのインストール

手順

1. 以下のコマンドを実行して、インストールする Istio バージョンを定義する ISTIO_VERSION 環境変数を作成します。

   $ export ISTIO_VERSION=1.24.1

2. Istio を East クラスターにインストールします。

   1. 次のコマンドを実行して、East クラスターのデフォルトネットワークを設定します。

      $ oc --context="${CTX_CLUSTER1}" label namespace istio-system topology.istio.io/network=network1

   2. 次のコマンドを実行して、East クラスターに Istio リソースを作成します。

      $ cat <<EOF | oc --context "${CTX_CLUSTER1}" apply -f -
      apiVersion: sailoperator.io/v1alpha1
      kind: Istio
      metadata:
        name: default
      spec:
        version: v${ISTIO_VERSION}
        namespace: istio-system
        values:
          global:
            meshID: mesh1
            multiCluster:
              clusterName: cluster1
            network: network1
            externalIstiod: true 1
      EOF

      1

      これにより、East クラスターにインストールされたコントロールプレーンが、他のリモートクラスターの外部コントロールプレーンとして機能できるようになります。

   3. 次のコマンドを実行して、コントロールプレーンが "Ready" ステータス状態を返すまで待機します。

      $ oc --context "${CTX_CLUSTER1}" wait --for condition=Ready istio/default --timeout=3m

   4. 次のコマンドを実行して、East クラスターに East-West ゲートウェイを作成します。

      $ oc --context "${CTX_CLUSTER1}" apply -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/multicluster/east-west-gateway-net1.yaml

   5. 次のコマンドを実行して、West クラスターのサービスがコントロールプレーンにアクセスできるように、ゲートウェイを介してコントロールプレーンを公開します。

      $ oc --context "${CTX_CLUSTER1}" apply -n istio-system -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/multicluster/expose-istiod.yaml

   6. 次のコマンドを実行して、ゲートウェイを介してアプリケーションサービスを公開します。

      $ oc --context "${CTX_CLUSTER1}" apply -n istio-system -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/multicluster/expose-services.yaml

3. Istio を West クラスターにインストールします。

   1. 次のコマンドを実行して、East クラスターで実行されている East-West ゲートウェイの IP アドレスを保存します。

      $ export DISCOVERY_ADDRESS=$(oc --context="${CTX_CLUSTER1}" \
          -n istio-system get svc istio-eastwestgateway \
          -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

   2. 次のコマンドを実行して、West クラスターに Istio リソースを作成します。

      $ cat <<EOF | oc --context "${CTX_CLUSTER2}" apply -f -
      apiVersion: sailoperator.io/v1alpha1
      kind: Istio
      metadata:
        name: default
      spec:
        version: v${ISTIO_VERSION}
        namespace: istio-system
        profile: remote
        values:
          istiodRemote:
            injectionPath: /inject/cluster/cluster2/net/network2
          global:
            remotePilotAddress: ${DISCOVERY_ADDRESS}
      EOF

   3. 次のコマンドを実行して、West クラスター内の istio-system namespace にアノテーションを付けて、East クラスターのコントロールプレーンによって管理されるようにします。

      $ oc --context="${CTX_CLUSTER2}" annotate namespace istio-system topology.istio.io/controlPlaneClusters=cluster1

   4. 次のコマンドを実行して、West クラスターのデフォルトネットワークを設定します。

      $ oc --context="${CTX_CLUSTER2}" label namespace istio-system topology.istio.io/network=network2

   5. 次のコマンドを実行して、West クラスターの API サーバーへのアクセスを提供する East クラスターにリモートシークレットをインストールします。

      $ istioctl create-remote-secret \
        --context="${CTX_CLUSTER2}" \
        --name=cluster2 | \
        oc --context="${CTX_CLUSTER1}" apply -f -

   6. 以下のコマンドを実行して、Istio リソースが "Ready" ステータス状態を返すまで待機します。

      $ oc --context "${CTX_CLUSTER2}" wait --for condition=Ready istio/default --timeout=3m

   7. 次のコマンドを実行して、West クラスターに East-West ゲートウェイを作成します。

      $ oc --context "${CTX_CLUSTER2}" apply -f https://raw.githubusercontent.com/istio-ecosystem/sail-operator/main/docs/multicluster/east-west-gateway-net2.yaml

      注記

      West クラスターはリモートプロファイルとともにインストールされるため、East クラスターでアプリケーションサービスを公開すると、それらのサービスが両方のクラスターの East-West ゲートウェイで公開されます。