2.5. Service Mesh のインストール

手順

1. cluster-admin ロールを持つユーザーとして OpenShift Container Platform Web コンソールにログインします。

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

   1. Home → Projects に移動します。
   2. Create Project をクリックします。
   3. Name フィールドに istio-system を入力します。
   4. Create をクリックします。
3. Operators → Installed Operators に移動します。
4. 必要な場合は、Project メニューから istio-system を選択します。Operator が新規プロジェクトにコピーされるまでに数分待機する必要がある場合があります。

5. Red Hat OpenShift Service Mesh Operator をクリックします。Provided APIs の下に、Operator は 2 つのリソースタイプを作成するためのリンクを提供します。

   • ServiceMeshControlPlane リソース
   • ServiceMeshMemberRoll リソース
6. Istio Service Mesh Control Plane で Create ServiceMeshControlPlane をクリックします。

7. Create Service Mesh Control Plane ページで、必要に応じてデフォルト ServiceMeshControlPlane テンプレートの YAML を変更します。

   注記

   コントロールプレーンのカスタマイズについての詳細は、Red Hat OpenShift Service Mesh インストールのカスタマイズについて参照してください。実稼働環境の場合は、デフォルトの Jaeger テンプレートを変更する 必要 があります。

8. Create をクリックしてコントロールプレーンを作成します。Operator は、設定パラメーターに基づいて Pod、サービス、Service Mesh コントロールプレーンのコンポーネントを作成します。
9. Istio Service Mesh Control Plane タブをクリックします。
10. 新規コントロールプレーンの名前をクリックします。
11. Resources タブをクリックして、Red Hat OpenShift Service Mesh コントロールプレーンリソース (Operator が作成し、設定したもの) を表示します。

手順

1. cluster-admin ロールを持つユーザーとして OpenShift Container Platform CLI にログインします。

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

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

   $ oc new-project istio-system

3. Customize the Red Hat OpenShift Service Mesh installation にある例を使用して、istio-installation.yaml という名前の ServiceMeshControlPlane ファイルを作成します。必要に応じて値をカスタマイズして、ユースケースに合わせて使用することができます。実稼働デプロイメントの場合は、デフォルトの Jaeger テンプレートを変更する 必要 があります。

4. 以下のコマンドを実行してコントロールプレーンをデプロイします。

   $ oc create -n istio-system -f istio-installation.yaml

5. 以下のコマンドを実行して、コントロールプレーンのインストールのステータスを確認します。

   $ oc get smcp -n istio-system

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

   NAME            READY   STATUS            PROFILES      VERSION   AGE
   basic-install   11/11   ComponentsReady   ["default"]   v1.1.18   4m25s

6. 以下のコマンドを実行して、インストールプロセス時の Pod の進捗を確認します。

   $ oc get pods -n istio-system -w

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

   出力例

   NAME                                     READY   STATUS             RESTARTS   AGE
   grafana-7bf5764d9d-2b2f6                 2/2     Running            0          28h
   istio-citadel-576b9c5bbd-z84z4           1/1     Running            0          28h
   istio-egressgateway-5476bc4656-r4zdv     1/1     Running            0          28h
   istio-galley-7d57b47bb7-lqdxv            1/1     Running            0          28h
   istio-ingressgateway-dbb8f7f46-ct6n5     1/1     Running            0          28h
   istio-pilot-546bf69578-ccg5x             2/2     Running            0          28h
   istio-policy-77fd498655-7pvjw            2/2     Running            0          28h
   istio-sidecar-injector-df45bd899-ctxdt   1/1     Running            0          28h
   istio-telemetry-66f697d6d5-cj28l         2/2     Running            0          28h
   jaeger-896945cbc-7lqrr                   2/2     Running            0          11h
   kiali-78d9c5b87c-snjzh                   1/1     Running            0          22h
   prometheus-6dff867c97-gr2n5              2/2     Running            0          28h

手順

1. OpenShift Container Platform Web コンソールにログインします。

2. メッシュのサービスがない場合や、ゼロから作業を開始する場合は、アプリケーションのプロジェクトを作成します。これは、Service Mesh コントロールプレーンをインストールしたプロジェクトとは異なる必要があります。

   1. Home → Projects に移動します。
   2. Name フィールドに名前を入力します。
   3. Create をクリックします。
3. Operators → Installed Operators に移動します。
4. Project メニューをクリックし、一覧から ServiceMeshControlPlane リソースがデプロイされているプロジェクト (例: istio-system) を選択します。
5. Red Hat OpenShift Service Mesh Operator をクリックします。
6. Istio Service Mesh Member Roll タブをクリックします。
7. Create ServiceMeshMemberRoll をクリックします。
8. Members をクリックし、Value フィールドにプロジェクトの名前を入力します。任意の数のプロジェクトを追加できますが、プロジェクトは 単一 の ServiceMeshMemberRoll リソースしか属することができません。
9. Create をクリックします。

手順

1. OpenShift Container Platform CLI にログインします。

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

2. メッシュのサービスがない場合や、ゼロから作業を開始する場合は、アプリケーションのプロジェクトを作成します。これは、Service Mesh コントロールプレーンをインストールしたプロジェクトとは異なる必要があります。

   $ oc new-project <your-project>

3. プロジェクトをメンバーとして追加するには、以下の YAML の例を変更します。任意の数のプロジェクトを追加できますが、プロジェクトは 単一 の ServiceMeshMemberRoll リソースしか属することができません。この例では、istio-system が Service Mesh コントロールプレーンプロジェクトの名前です。

   servicemeshmemberroll-default.yaml の例

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system
   spec:
     members:
       # a list of projects joined into the service mesh
       - your-project-name
       - another-project-name

4. 以下のコマンドを実行して、istio-system namespace に ServiceMeshMemberRoll リソースをアップロードおよび作成します。

   $ oc create -n istio-system -f servicemeshmemberroll-default.yaml

5. 以下のコマンドを実行して、ServiceMeshMemberRoll が正常に作成されていることを確認します。

   $ oc get smmr -n istio-system default

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

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Operators → Installed Operators に移動します。
3. Project メニューをクリックし、一覧から ServiceMeshControlPlane リソースがデプロイされているプロジェクト (例: istio-system) を選択します。
4. Red Hat OpenShift Service Mesh Operator をクリックします。
5. Istio Service Mesh Member Roll タブをクリックします。
6. default リンクをクリックします。
7. YAML タブをクリックします。
8. YAML を変更して、プロジェクトをメンバーとして追加または削除します。任意の数のプロジェクトを追加できますが、プロジェクトは 単一 の ServiceMeshMemberRoll リソースしか属することができません。
9. Save をクリックします。
10. Reload をクリックします。

手順

1. OpenShift Container Platform CLI にログインします。

2. ServiceMeshMemberRoll リソースを編集します。

   $ oc edit smmr -n <controlplane-namespace>

3. YAML を変更して、プロジェクトをメンバーとして追加または削除します。任意の数のプロジェクトを追加できますが、プロジェクトは 単一 の ServiceMeshMemberRoll リソースしか属することができません。

   servicemeshmemberroll-default.yaml の例

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system #control plane project
   spec:
     members:
       # a list of projects joined into the service mesh
       - your-project-name
       - another-project-name