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 のバージョンに関係なく利用可能な機能を判別します。

   ServiceMeshControlPlane 設定は後で設定できます。詳細は、Red Hat OpenShift Service Mesh の設定を参照してください。

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

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.3 istio-installation.yaml の例

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     version: v2.3
     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. cluster-admin 権限を持つユーザーとして OpenShift Container Platform Web コンソールにログインします。(Red Hat OpenShift Dedicated を使用する場合) dedicated-admin ロールがあるアカウント。
2. Networking Routes に移動します。

3. Routes ページで、Namespace メニューから Service Mesh コントロールプレーンプロジェクトを選択します (例: istio-system)。

   Location 列には、各ルートのリンク先アドレスが表示されます。

4. 必要に応じて、フィルターを使用して Kiali コンソールのルートを見つけます。ルートの Location をクリックしてコンソールを起動します。

5. Log In With OpenShift をクリックします。

   初回の Kiali コンソールへのログイン時に、表示するパーミッションを持つサービスメッシュ内のすべての namespace を表示する Overview ページが表示されます。概要 ページに複数の namespace が表示されている場合には、Kiali は最初に正常性または検証に問題がある namespace を表示します。

   図1.1 Kiali の概要ページ

   

   各 namespace のタイルには、ラベルの数、Istio Config の状態、アプリケーション の状態と数、namespace の トラフィック が表示されます。コンソールのインストールを検証中で、namespace がまだメッシュに追加されていない場合、istio-system 以外のデータは表示されない可能性があります。

6. Kiali には、Service Mesh コントロールプレーンがインストールされている namespace 専用のダッシュボードが 4 つあります。これらのダッシュボードを表示するには、オプション メニューをクリックします コントロールプレーン namespace のタイル (例: istio-system) で、次のいずれかのオプションを選択します。

   • Istio メッシュダッシュボード
   • Istio コントロールプレーンダッシュボード
   • Istio パフォーマンスダッシュボード

   • Istio Wasm Exetension ダッシュボード

     図1.2 GrafanaIstio コントロールプレーンダッシュボード

     

     Kiali は、Grafana ホームページ から入手できる追加の Grafana ダッシュボード 2 つもインストールします。

   • Istio ワークロードダッシュボード
   • Istio サービスダッシュボード

7. Service Mesh コントロールプレーンノードを表示するには、グラフ ページをクリックし、メニューから ServiceMeshControlPlane をインストールした Namespace を選択します (例 :istio-system)。

   1. 必要に応じて、Display idle nodes をクリックします。
   2. グラフ ページの詳細は、グラフツアー リンクをクリックしてください。
   3. メッシュトポロジーを表示するには、namespace メニューの Service Mesh メンバーロールから追加の namespace を 1 つまたは複数選択します。

8. istio-system namespace 内のアプリケーションのリストを表示するには、アプリケーション ページをクリックします。Kiali は、アプリケーションの状態を表示します。

   1. 情報アイコンの上にマウスをかざすと、詳細 列に記載されている追加情報が表示されます。

9. istio-system namespace のワークロードのリストを表示するには、ワークロード ページをクリックします。Kiali は、ワークロードの状態を表示します。

   1. 情報アイコンの上にマウスをかざすと、詳細 列に記載されている追加情報が表示されます。

10. istio-system namespace のサービスのリストを表示するには、サービス ページをクリックします。Kiali は、サービスと設定の状態を表示します。

    1. 情報アイコンの上にマウスをかざすと、詳細 列に記載されている追加情報が表示されます。

11. istio-system namespace の Istio 設定オブジェクトのリストを表示するには、Istio Config ページをクリックします。Kiali は、設定の正常性を表示します。

    1. 設定エラーがある場合は、行をクリックすると、Kiali が設定ファイルを開き、エラーが強調表示されます。