1.7. Red Hat OpenShift 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、サービス、サービスメッシュコントロールプレーンのコンポーネントを作成します。
9. Istio Service Mesh Control Plane タブをクリックします。
10. 新規コントロールプレーンの名前をクリックします。
11. Resources タブをクリックして、Red Hat OpenShift Service Mesh コントロールプレーンリソース (Operator が作成し、設定したもの) を表示します。

手順

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

   $ oc login 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

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

   NAME           READY
   basic-install   True

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. メッシュのプロジェクトがない場合や、ゼロから作業を開始する場合は、プロジェクトを作成します。これは istio-system とは異なるものである必要があります。

   1. Home Projects に移動します。
   2. Name フィールドに名前を入力します。
   3. Create をクリックします。
2. OpenShift Container Platform Web コンソールにログインします。
3. Operators Installed Operators に移動します。
4. Project メニューをクリックし、一覧から ServiceMeshControlPlane がデプロイされているプロジェクト (例: istio-system) を選択します。
5. Red Hat OpenShift Service Mesh Operator をクリックします。
6. All Instances タブをクリックします。

7. Create New をクリックしてから Create Istio Service Mesh Member Roll を選択します。

   注記

   Operator がリソースのコピーを終了するまでに少し時間がかかる場合があります。そのため、Create Istio Service Mesh Member Roll ボタンが表示されるように画面を更新する必要がある場合があります。

8. Create Service Mesh Member Roll ページで、YAML を変更してプロジェクトをメンバーとして追加します。任意の数のプロジェクトを追加できますが、プロジェクトは 単一 の ServiceMeshMemberRoll リソースしか属することができません。
9. Create をクリックして、Service Mesh Member Roll を保存します。

手順

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

   $ oc login

2. istio-system の例では、ServiceMeshMemberRoll リソースを ServiceMeshControlPlane リソースと同じプロジェクトに作成します。リソースの名前は default にする必要があります。

   $ oc create -n istio-system -f 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

3. デフォルトの YAML を変更して、プロジェクトを membersとして追加します。任意の数のプロジェクトを追加できますが、プロジェクトは 単一 の ServiceMeshMemberRoll リソースしか属することができません。

手順

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 リソースしか属することができません。

   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