1.8. ServiceMeshControlPlane の作成

手順

1. cluster-admin ロールを持つユーザーとして OpenShift Container Platform Web コンソールにログインします。(Red Hat OpenShift Dedicated を使用する場合) dedicated-admin ロールがあるアカウント。

2. istio-system という名前のプロジェクトを作成します。

   1. Home Projects に移動します。
   2. Create Project をクリックします。

   3. Name フィールドに istio-system と入力します。ServiceMeshControlPlane リソースは、マイクロサービスおよび Operator とは異なるプロジェクトにインストールする必要があります。

      これらのステップは istio-system を例として使用しますが、サービスが含まれるプロジェクトから分離されない限り、Service Mesh コントロールプレーンを任意のプロジェクトにデプロイできます。

   4. Create をクリックします。
3. Operators Installed Operators に移動します。
4. Red Hat OpenShift Service Mesh Operator をクリックした後に、Istio Service Mesh Control Plane をクリックします。
5. Istio Service Mesh Control Plane タブで Create ServiceMeshControlPlane をクリックします。

6. Create ServiceMeshControlPlane ページで、デフォルトの Service Mesh コントロールプレーンバージョンを受け入れて、製品の最新バージョンで利用可能な機能を活用します。コントロールプレーンのバージョンは、Operator のバージョンに関係なく利用可能な機能を判別します。

   1. Create をクリックします。Operator は、設定パラメーターに基づいて Pod、サービス、Service Mesh コントロールプレーンのコンポーネントを作成します。ServiceMeshControlPlane 設定は後で設定できます。

7. Istio Service Mesh Control Plane タブをクリックしてコントロールプレーンが正常にインストールされることを確認します。

   1. 新規コントロールプレーンの名前をクリックします。
   2. Resources タブをクリックして、Red Hat OpenShift Service Mesh コントロールプレーンリソース (Operator が作成し、設定したもの) を表示します。

手順

1. cluster-admin ロールを持つユーザーとして OpenShift Container Platform CLI にログインします。(Red Hat OpenShift Dedicated を使用する場合) dedicated-admin ロールがあるアカウント。

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. istio-system という名前のプロジェクトを作成します。

   $ oc new-project istio-system

3. 以下の例を使用して istio-installation.yaml という名前の ServiceMeshControlPlane ファイルを作成します。Service Mesh コントロールプレーンのバージョンは、Operator のバージョンに関係なく利用可能な機能を判別します。

   バージョン 2.4 istio-installation.yaml の例

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.4
     tracing:
       type: Jaeger
       sampling: 10000
     addons:
       jaeger:
         name: jaeger
         install:
           storage:
             type: Memory
       kiali:
         enabled: true
         name: kiali
       grafana:
         enabled: true

4. 以下のコマンドを実行して Service Mesh コントロールプレーンをデプロイします。ここで、<istio_installation.yaml> にはファイルへの完全パスが含まれます。

   $ oc create -n istio-system -f <istio_installation.yaml>

5. Pod のデプロイメントの進行状況を監視するには、次のコマンドを実行します。

   $ oc get pods -n istio-system -w

   以下のような出力が表示されるはずです。

   NAME                                   READY   STATUS    RESTARTS   AGE
   grafana-b4d59bd7-mrgbr                 2/2     Running   0          65m
   istio-egressgateway-678dc97b4c-wrjkp   1/1     Running   0          108s
   istio-ingressgateway-b45c9d54d-4qg6n   1/1     Running   0          108s
   istiod-basic-55d78bbbcd-j5556          1/1     Running   0          108s
   jaeger-67c75bd6dc-jv6k6                2/2     Running   0          65m
   kiali-6476c7656c-x5msp                 1/1     Running   0          43m
   prometheus-58954b8d6b-m5std            2/2     Running   0          66m

手順

1. cluster-admin ロールを持つユーザーとして OpenShift Container Platform CLI にログインします。(Red Hat OpenShift Dedicated を使用する場合) dedicated-admin ロールがあるアカウント。

   $ oc login https://<HOSTNAME>:6443

2. 次のコマンドを実行して、Service Mesh コントロールプレーンのインストールを確認します。istio-system は、Service Mesh コントロールプレーンをインストールした namespace です。

   $ oc get smcp -n istio-system

   STATUS 列が ComponentsReady の場合は、インストールが正常に終了しています。

   NAME    READY   STATUS            PROFILES      VERSION   AGE
   basic   10/10   ComponentsReady   ["default"]   2.1.1     66m

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Operators Installed Operators に移動します。
3. Red Hat OpenShift Service Mesh Operator をクリックし、次に Istio Service Mesh Control Plane をクリックします。
4. コントロールプレーンリソースの名前をクリックします。たとえば、basic です。
5. YAML をクリックします。

6. 次の例に示すように、nodeSelector フィールドと tolerations フィールドを ServiceMeshControlPlane リソースの spec.runtime.defaults.pod 仕様に追加します。

   spec:
     runtime:
       defaults:
         pod:
           nodeSelector: 1
             node-role.kubernetes.io/infra: ""
           tolerations: 2
           - effect: NoSchedule
             key: node-role.kubernetes.io/infra
             value: reserved
           - effect: NoExecute
             key: node-role.kubernetes.io/infra
             value: reserved

   1

   ServiceMeshControlPlane Pod がインフラストラクチャーノード上でのみスケジュールされるようにします。

   2

   Pod が実行のためにインフラストラクチャーノードによって受け入れられることを確認します。

7. Save をクリックします。
8. Reload をクリックします。

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Operators Installed Operators に移動します。
3. Red Hat OpenShift Service Mesh Operator をクリックし、次に Istio Service Mesh Control Plane をクリックします。
4. コントロールプレーンリソースの名前をクリックします。たとえば、basic です。
5. YAML をクリックします。

6. 次の例に示すように、nodeSelector フィールド と tolerations フィールドを ServiceMeshControlPlane リソースの spec.runtime.components.pilot.pod 仕様に追加します。

   spec:
     runtime:
       components:
         pilot:
           pod:
             nodeSelector: 1
               node-role.kubernetes.io/infra: ""
             tolerations: 2
             - effect: NoSchedule
               key: node-role.kubernetes.io/infra
               value: reserved
             - effect: NoExecute
               key: node-role.kubernetes.io/infra
               value: reserved

   1

   Istiod Pod がインフラストラクチャーノード上でのみスケジュールされることを確認します。

   2

   Pod が実行のためにインフラストラクチャーノードによって受け入れられることを確認します。

7. 次の例に示すように、nodeSelector フィールドと tolerations フィールドを ServiceMeshControlPlane リソースの spec.gateways.ingress.runtime.pod および spec.gateways.egress.runtime.pod 仕様に追加します。

   spec:
     gateways:
       ingress:
         runtime:
           pod:
             nodeSelector: 1
               node-role.kubernetes.io/infra: ""
             tolerations: 2
             - effect: NoSchedule
               key: node-role.kubernetes.io/infra
               value: reserved
             - effect: NoExecute
               key: node-role.kubernetes.io/infra
               value: reserved
       egress:
         runtime:
           pod:
             nodeSelector: 3
               node-role.kubernetes.io/infra: ""
             tolerations: 4
             - effect: NoSchedule
               key: node-role.kubernetes.io/infra
               value: reserved
             - effect: NoExecute
               key: node-role.kubernetes.io/infra
               value: reserved

   1 3

   ゲートウェイ Pod がインフラストラクチャーノード上でのみスケジュールされることを確認します

   2 4

   Pod が実行のためにインフラストラクチャーノードによって受け入れられることを確認します。

8. Save をクリックします。
9. Reload をクリックします。

手順

1. ServiceMeshControlPlane リソースを YAML ファイルとして開きます。

   $ oc -n istio-system edit smcp <name> 1

   1

   <name> は、ServiceMeshControlPlane リソースの名前を表します。

2. ServiceMeshControlPlane によってデプロイされたすべての Service Mesh コンポーネントをインフラストラクチャーノードで実行するには、ServiceMeshControlPlane リソースの spec.runtime.defaults.pod 仕様に nodeSelector フィールドと tolerations フィールドを追加します。

   spec:
     runtime:
       defaults:
         pod:
           nodeSelector: 1
             node-role.kubernetes.io/infra: ""
           tolerations: 2
           - effect: NoSchedule
             key: node-role.kubernetes.io/infra
             value: reserved
           - effect: NoExecute
             key: node-role.kubernetes.io/infra
             value: reserved

   1

   SMCP Pod がインフラストラクチャーノード上でのみスケジュールされることを確認します。

   2

   インフラストラクチャーノードが Pod を受け入れることを確認します。

手順

1. ServiceMeshControlPlane リソースを YAML ファイルとして開きます。

   $ oc -n istio-system edit smcp <name> 1

   1

   <name> は、ServiceMeshControlPlane リソースの名前を表します。

2. インフラストラクチャーノードで Istiod コンポーネントを実行するには、ServiceMeshControlPlane リソースの spec.runtime.components.pilot.pod 仕様に nodeSelector フィールドと tolerations フィールドを追加します。

   spec:
     runtime:
       components:
         pilot:
           pod:
             nodeSelector: 1
               node-role.kubernetes.io/infra: ""
             tolerations: 2
             - effect: NoSchedule
               key: node-role.kubernetes.io/infra
               value: reserved
             - effect: NoExecute
               key: node-role.kubernetes.io/infra
               value: reserved

   1

   Istiod Pod がインフラストラクチャーノード上でのみスケジュールされることを確認します。

   2

   インフラストラクチャーノードが Pod を受け入れるか確認します。

3. Ingress Gateway と Egress Gateway をインフラストラクチャーノードで実行する場合は、ServiceMeshControlPlane リソースの spec.gateways.ingress.runtime.pod 仕様と spec.gateways.egress.runtime.pod 仕様に、nodeSelector フィールドと tolerations フィールドを追加します。

   spec:
     gateways:
       ingress:
         runtime:
           pod:
             nodeSelector: 1
               node-role.kubernetes.io/infra: ""
             tolerations: 2
             - effect: NoSchedule
               key: node-role.kubernetes.io/infra
               value: reserved
             - effect: NoExecute
               key: node-role.kubernetes.io/infra
               value: reserved
       egress:
         runtime:
           pod:
             nodeSelector: 3
               node-role.kubernetes.io/infra: ""
             tolerations: 4
             - effect: NoSchedule
               key: node-role.kubernetes.io/infra
               value: reserved
             - effect: NoExecute
               key: node-role.kubernetes.io/infra
               value: reserved

   1 3

   ゲートウェイ Pod がインフラストラクチャーノード上でのみスケジュールされることを確認します

   2 4

   インフラストラクチャーノードが Pod を受け入れるか確認します。

手順

1. istio-system という名前のプロジェクトを作成します。

   1. Home Projects に移動します。
   2. Create Project をクリックします。

   3. Name フィールドに istio-system と入力します。ServiceMeshControlPlane リソースは、マイクロサービスおよび Operator とは異なるプロジェクトにインストールする必要があります。

      これらの手順では、istio-system をサンプルとして使用します。Service Mesh コントロールプレーンは、サービスが含まれるプロジェクトから分離されている限り、任意のプロジェクトにデプロイできます。

   4. Create をクリックします。
2. Operators Installed Operators に移動します。
3. Red Hat OpenShift Service Mesh Operator をクリックした後に、Istio Service Mesh Control Plane をクリックします。
4. Istio Service Mesh Control Plane タブで Create ServiceMeshControlPlane をクリックします。
5. YAML view をクリックします。Service Mesh コントロールプレーンのバージョンは、Operator のバージョンに関係なく利用可能な機能を判別します。

6. YAML ファイルの spec.mode フィールドを変更して、Clusterwide を指定します。

   バージョン 2.4 istio-installation.yaml の例

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.4
     mode: ClusterWide

7. Create をクリックします。Operator は、設定パラメーターに基づいて Pod、サービス、Service Mesh コントロールプレーンのコンポーネントを作成します。ServiceMeshMemberRoll がデフォルト設定の一部として存在しないと、オペレーターは ServiceMeshMemberRoll も作成します。

8. Istio Service Mesh Control Plane タブをクリックしてコントロールプレーンが正常にインストールされることを確認します。

   1. 新しい ServiceMeshControlPlane オブジェクトの名前をクリックします。
   2. Resources タブをクリックして、Red Hat OpenShift Service Mesh コントロールプレーンリソース (Operator が作成し、設定したもの) を表示します。

手順

1. cluster-admin ロールを持つユーザーとして OpenShift Container Platform CLI にログインします。(Red Hat OpenShift Dedicated を使用する場合) dedicated-admin ロールがあるアカウント。

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. istio-system という名前のプロジェクトを作成します。

   $ oc new-project istio-system

3. 以下の例を使用して istio-installation.yaml という名前の ServiceMeshControlPlane ファイルを作成します。

   バージョン 2.4 istio-installation.yaml の例

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.4
     mode: ClusterWide

4. 以下のコマンドを実行して Service Mesh コントロールプレーンをデプロイします。ここで、<istio_installation.yaml> にはファイルへの完全パスが含まれます。

   $ oc create -n istio-system -f <istio_installation.yaml>

5. Pod のデプロイの進行状況を監視するには、次のコマンドを実行します。

   $ oc get pods -n istio-system -w

   次の例のような出力が表示されるはずです。

   出力例

   NAME                                   READY   STATUS    RESTARTS   AGE
   grafana-b4d59bd7-mrgbr                 2/2     Running   0          65m
   istio-egressgateway-678dc97b4c-wrjkp   1/1     Running   0          108s
   istio-ingressgateway-b45c9d54d-4qg6n   1/1     Running   0          108s
   istiod-basic-55d78bbbcd-j5556          1/1     Running   0          108s
   jaeger-67c75bd6dc-jv6k6                2/2     Running   0          65m
   kiali-6476c7656c-x5msp                 1/1     Running   0          43m
   prometheus-58954b8d6b-m5std            2/2     Running   0          66m