2.8. Operator のインストール
Red Hat OpenShift Service Mesh をインストールするには、まず OpenShift Container Platform に Red Hat OpenShift Service Mesh Operator とオプションの Operators をインストールします。次に、コントロールプレーンをデプロイするための ServiceMeshControlPlane
リソースを作成します。
この基本的なインストールはデフォルトの OpenShift 設定に基づいて設定され、実稼働環境での使用を目的としていません。 このデフォルトインストールを使用してインストールを確認し、お使いの環境に Service Mesh を設定します。
前提条件
- Red Hat OpenShift Service Mesh のインストールの準備 のプロセスを確認している。
-
cluster-admin
ロールを持つアカウントがある。(Red Hat OpenShift Dedicated を使用する場合)dedicated-admin
ロールがあるアカウント。
以下の手順では、OpenShift Container Platform に Red Hat OpenShift Service Mesh の基本的なインスタンスをインストールする方法を説明します。
Red Hat OpenShift Service Mesh 2.5 以降、Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) と OpenShift Elasticsearch Operator が非推奨になりました。これらは今後のリリースで削除される予定です。Red Hat は、現行リリースのライフサイクル中はこれらの機能のバグ修正とサポートを提供しますが、今後これらの機能に対する機能強化は行われません。Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) の代わりに、Red Hat OpenShift 分散トレーシングプラットフォーム (Tempo) を使用できます。
2.8.1. Service Mesh Operator の概要
Red Hat OpenShift Service Mesh では、Red Hat OpenShift Service Mesh Operator を使用する必要があります。この Operator により、アプリケーションを構成するマイクロサービスの接続、保護、制御、監視が可能になります。他の Operator をインストールして、Service Mesh のエクスペリエンスを強化することもできます。
Operator のコミュニティーバージョンはインストールしないでください。コミュニティー Operator はサポートされていません。
次の Operator が必要です。
- Red Hat OpenShift Service Mesh Operator
-
アプリケーションを構成するマイクロサービスの接続、保護、制御、監視を可能にします。また、Service Mesh コンポーネントのデプロイ、更新、削除を管理する
ServiceMeshControlPlane
リソースを定義および監視します。これはオープンソースの Istio プロジェクトに基づいています。
次の Operator はオプションです。
- Red Hat が提供する Kiali Operator
- Service Mesh の可観測性を提供します。これにより、単一のコンソールで設定を表示し、トラフィックを監視し、トレースの分析を実行できます。これはオープンソースの Kiali プロジェクトに基づいています。
- Red Hat OpenShift distributed tracing platform (Tempo)
- 複雑な分散システム内のトランザクションを監視およびトラブルシューティングするための分散トレーシングを提供します。これはオープンソースの Grafana Tempo プロジェクトに基づいています。
次のオプションの Operators は非推奨です。
Red Hat OpenShift Service Mesh 2.5 以降、Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) と OpenShift Elasticsearch Operator が非推奨になりました。これらは今後のリリースで削除される予定です。Red Hat は、現行リリースのライフサイクル中はこれらの機能のバグ修正とサポートを提供しますが、今後これらの機能に対する機能強化は行われません。Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) の代わりに、Red Hat OpenShift 分散トレーシングプラットフォーム (Tempo) を使用できます。
- Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger)
- 複雑な分散システム内のトランザクションを監視およびトラブルシューティングするための分散トレーシングを提供します。これはオープンソースの Jaeger プロジェクトに基づいています。
- OpenShift Elasticsearch Operator
- 分散トレーシングプラットフォーム (Jaeger) でのトレーシングおよびロギング用のデータベースストレージを提供します。これはオープンソースの Elasticsearch プロジェクトに基づいています。
2.8.2. Operator のインストール
Red Hat OpenShift Service Mesh をインストールするには、Red Hat OpenShift Service Mesh Operator をインストールする必要があります。この手順を、インストールする追加の Operator ごとに繰り返し行ってください。
追加の Operators には以下のものがあります。
- Red Hat が提供する Kiali Operator
- Tempo Operator
非推奨となった追加の Operators は次のとおりです。
Red Hat OpenShift Service Mesh 2.5 以降、Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) と OpenShift Elasticsearch Operator が非推奨になりました。これらは今後のリリースで削除される予定です。Red Hat は、現行リリースのライフサイクル中はこれらの機能のバグ修正とサポートを提供しますが、今後これらの機能に対する機能強化は行われません。Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) の代わりに、Red Hat OpenShift 分散トレーシングプラットフォーム (Tempo) を使用できます。
- Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger)
- OpenShift Elasticsearch Operator
OpenShift Logging の一部として OpenShift Elasticsearch Operator がすでにインストールされている場合は、OpenShift Elasticsearch Operator を再びインストールする必要はありません。Red Hat OpenShift 分散トレースプラットフォーム (Jaeger) Operator はインストールされた OpenShift Elasticsearch Operator を使用して Elasticsearch インスタンスを作成します。
手順
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform Web コンソールにログインします。 -
OpenShift Container Platform Web コンソールで、Operators
OperatorHub をクリックします。 - Operator のフィルターボックスに名前を入力し、Red Hat バージョンの Operator を選択します。Operator のコミュニティーバージョンはサポートされていません。
- Install をクリックします。
- 各 Operator の Install Operator ページで、デフォルト設定を受け入れます。
Install をクリックします。Operator がインストールされるまで待機してから、同じ手順を繰り返して、次の Operator をインストールします。
-
Red Hat OpenShift Service Mesh Operator は、
openshift-operators
namespace にインストールされ、クラスター内のすべての namespace で使用できます。 -
Red Hat が提供する Kiali Operator は、
openshift-operators
namespace にインストールされ、クラスター内のすべての namespace で使用できます。 -
Tempo Operator は、
openshift-tempo-operator
namespace にインストールされ、クラスター内のすべての namespace で使用できます。 Red Hat OpenShift 分散トレースプラットフォーム (Jaeger) は、
openshift-distributed-tracing
namespace にインストールされ、クラスター内のすべての namespace で使用できます。重要Red Hat OpenShift Service Mesh 2.5 以降、Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) が非推奨になりました。これは今後のリリースで削除される予定です。Red Hat は、現在のリリースのライフサイクル中にこの機能のバグ修正とサポートを提供しますが、この機能は今後、機能拡張を受け取らず、削除されます。Red Hat OpenShift 分散トレーシングプラットフォーム (Jaeger) の代わりに、Red Hat OpenShift 分散トレーシングプラットフォーム (Tempo) を使用できます。
OpenShift Elasticsearch Operator は、
openshift-operators-redhat
namespace にインストールされ、クラスター内のすべての namespace で使用できます。重要Red Hat OpenShift Service Mesh 2.5 以降、OpenShift Elasticsearch Operator が非推奨になりました。これは今後のリリースで削除される予定です。Red Hat は、現在のリリースのライフサイクル中にこの機能のバグ修正とサポートを提供しますが、この機能は今後、機能拡張を受け取らず、削除されます。
-
Red Hat OpenShift Service Mesh Operator は、
検証
-
4 つの Operator をすべてインストールしたら、Operators
Installed Operators をクリックして Operator がインストールされていることを確認します。
2.8.3. インフラストラクチャーノード上で実行する Service Mesh Operator の設定
このタスクは、Service Mesh Operator がインフラストラクチャーノードで実行されている場合にのみ実行する必要があります。
Operator をワーカーノード上で実行する場合は、このタスクを省略してください。
前提条件
- Service Mesh Operator がインストールされている。
- デプロイメントを構成するノードのいずれかが、インフラストラクチャーノードである。詳細は、「インフラストラクチャーマシンセットの作成」を参照してください。
手順
namespace にインストールされている Operator を一覧表示します。
$ oc -n openshift-operators get subscriptions
Service Mesh Operator
Subscription
リソースを編集して、Operator を実行する場所を指定します。$ oc -n openshift-operators edit subscription <name> 1
- 1
<name>
は、Subscription
リソースの名前です。Subscription
リソースのデフォルト名はservicemeshoperator
です。
Subscription
リソースのspec.config
に、nodeSelector
とtolerations
を追加します。apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: labels: operators.coreos.com/servicemeshoperator.openshift-operators: "" name: servicemeshoperator namespace: openshift-operators # ... spec: config: 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
2.8.4. Service Mesh Operator のインフラストラクチャーノードでの実行を検証
手順
Operator Pod に関連付けられたノードがインフラストラクチャーノードであることを確認します。
$ oc -n openshift-operators get po -l name=istio-operator -owide
2.8.5. 次のステップ
-
Red Hat OpenShift Service Mesh Operator は、Service Mesh コントロールプレーンをデプロイするまで、Service Mesh カスタムリソース定義 (CRD) を作成しません。
ServiceMeshControlPlane
リソースを使用して、Service Mesh コンポーネントをインストールおよび設定できます。詳細は、ServiceMeshControlPlane の作成 を参照してください。