1.8. ServiceMeshControlPlane の作成

手順

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

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

   1. Home Projects に移動します。
   2. Create Project をクリックします。
   3. Name フィールドに istio-system と入力します。ServiceMeshControlPlane リソースは、マイクロサービスおよび Operator とは別に、istio-system プロジェクトにインストールする必要があります。
   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 をクリックします。

   1. 製品の最新バージョンで使用できる機能を利用するには、デフォルトの Service Mesh コントロールプレーンバージョンを受け入れます。コントロールプレーンのバージョンは、Operator のバージョンに関係なく利用可能な機能を判別します。
   2. Red Hat OpenShift Service on AWS に必要な spec.security.identity.type.ThirdParty フィールドを追加します。
   3. Create をクリックします。

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

手順

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

   $ oc new-project istio-system

   ServiceMeshControlPlane リソースは、マイクロサービスおよび Operator とは別に、istio-system プロジェクトにインストールする必要があります。

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

   ServiceMeshControlPlane リソースの例

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.6
     security:
       identity:
         type: ThirdParty 1
     tracing:
       type: None
       sampling: 10000
     policy:
       type: Istiod
     addons:
       grafana:
         enabled: true
       kiali:
         enabled: true
       prometheus:
         enabled: true
     telemetry:
       type: Istiod

   1

   Red Hat OpenShift Service on AWS に必要な設定を指定します。

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

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

4. 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
   kiali-6476c7656c-x5msp                 1/1     Running   0          43m
   prometheus-58954b8d6b-m5std            2/2     Running   0          66m

1. 前提条件

   • Red Hat OpenShift Service Mesh Operator がインストールされている。
   • OpenShift CLI (oc) へのアクセスがある。
   • Red Hat OpenShift Service on AWS に、dedicated-admin ロールを持つユーザーとしてログインしている。

手順

1. 次のコマンドを実行して、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.6.4     66m

手順

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. spec.mode フィールドを変更し、spec.security.identity.type.ThirdParty フィールドを追加します。

   ServiceMeshControlPlane リソースの例

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.6
     mode: ClusterWide 1
     security:
       identity:
         type: ThirdParty 2
     tracing:
       type: Jaeger
       sampling: 10000
     policy:
       type: Istiod
     addons:
       grafana:
         enabled: true
       jaeger:
         install:
           storage:
             type: Memory
       kiali:
         enabled: true
       prometheus:
         enabled: true
     telemetry:
       type: Istiod

   1

   リソースがクラスター全体のデプロイメント用であることを指定します。

   2

   Red Hat OpenShift Service on AWS に必要な設定を指定します。

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

手順

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

   $ oc new-project istio-system

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

   ServiceMeshControlPlane リソースの例

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.6
     mode: ClusterWide 1
     security:
       identity:
         type: ThirdParty 2

   1

   リソースがクラスター全体のデプロイメント用であることを指定します。

   2

   Red Hat OpenShift Service on AWS に必要な設定を指定します。

3. 次のコマンドを実行して、Service Mesh コントロールプレーンをデプロイします。

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

   ここでは、以下のようになります。

   <istio_installation.yaml>

   ファイルへの完全パスを指定します。

検証

1. 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