2.2. Red Hat OpenShift Service Mesh のインストール


サービスメッシュのインストールには、Elasticsearch、Jaeger、Kiali、Service Mesh Operator のインストール、コントロールプレーンをデプロイするための ServiceMeshControlPlane リソースの作成および管理、サービスメッシュに関連する namespace を指定するための ServiceMeshMemberRoll リソースの作成が含まれます。

注記

Mixer のポリシーの適用はデフォルトで無効にされています。ポリシータスクを実行するには、これを有効にする必要があります。Mixer ポリシーの適用を有効にする方法については、Mixer ポリシーの適用の更新について参照してください。

注記

マルチテナントコントロールプレーンのインストールは、Red Hat OpenShift Service Mesh 1.0 以降のデフォルト設定です。

前提条件

2.2.1. OperatorHub からの Operator のインストール

サービスメッシュのインストールプロセスでは、OperatorHub を使用して openshift-operators プロジェクト内に ServiceMeshControlPlane カスタムリソース定義をインストールします。Red Hat OpenShift Service Mesh は、コントロールプレーンのデプロイメント、更新、および削除に関連する ServiceMeshControlPlane を定義し、監視します。

Red Hat OpenShift Service Mesh 1.0.10 以降では、Red Hat OpenShift Service Mesh Operator がコントロールプレーンをインストールするには、Elasticsearch Operator、Jaeger Operator、および Kiali Operator をインストールをする必要があります。

2.2.1.1. Elasticsearch Operator のインストール

コントロールプレーンをインストールするには、Red Hat OpenShift Service Mesh Operator の Elasticsearch Operator をインストールする必要があります。

警告

Operator のコミュニティーバージョンはインストールしないでください。コミュニティー Operator はサポートされていません。

前提条件

  • OpenShift Container Platform Web コンソールへのアクセス。

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. Catalog OperatorHub に移動します。
  3. Elasticsearch とフィルターボックスに入力して、Elasticsearch Operator を検索します。
  4. Elasticsearch Operator をクリックし、Operator についての情報を表示します。
  5. Install をクリックします。
  6. Create Operator Subscription ページで、All namespaces on the cluster (default) を選択します。これにより、Operator がデフォルトの openshift-operators プロジェクトにインストールされ、Operator はクラスター内のすべてのプロジェクトで利用可能になります。
  7. preview Update Channel を選択します。
  8. Automatic Approval Strategy を選択します。

    注記

    手動の承認ストラテジーには、Operator のインストールおよびサブスクリプションプロセスを承認するための適切な認証情報を持つユーザーが必要です。

  9. Subscribe をクリックします。
  10. Subscription Overview ページには、Elasticsearch Operator のインストールの進捗状況が表示されます。

2.2.1.2. Jaeger Operator のインストール

コントロールプレーンをインストールするには、Red Hat OpenShift Service Mesh Operator の Jaeger Operator をインストールする必要があります。

警告

Operator のコミュニティーバージョンはインストールしないでください。コミュニティー Operator はサポートされていません。

前提条件

  • OpenShift Container Platform Web コンソールへのアクセス。
  • Elasticsearch Operator がインストールされていること。

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. Catalog OperatorHub に移動します。
  3. Jaeger とフィルターボックスに入力して、Jaeger Operator を検索します。
  4. Red Hat が提供する Jaeger Operator をクリックし、Operator についての情報を表示します。
  5. Install をクリックします。
  6. Create Operator Subscription ページで、All namespaces on the cluster (default) を選択します。これにより、Operator がデフォルトの openshift-operators プロジェクトにインストールされ、Operator はクラスター内のすべてのプロジェクトで利用可能になります。
  7. stable Update Channel を選択します。
  8. Automatic Approval Strategy を選択します。

    注記

    手動の承認ストラテジーには、Operator のインストールおよびサブスクリプションプロセスを承認するための適切な認証情報を持つユーザーが必要です。

  9. Subscribe をクリックします。
  10. Subscription Overview ページには、Jaeger Operator のインストールの進捗状況が表示されます。

2.2.1.3. Kiali Operator のインストール

コントロールプレーンをインストールするには、Red Hat OpenShift Service Mesh Operator の Kiali Operator をインストールする必要があります。

警告

Operator のコミュニティーバージョンはインストールしないでください。コミュニティー Operator はサポートされていません。

前提条件

  • OpenShift Container Platform Web コンソールへのアクセス。

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. Catalog OperatorHub に移動します。
  3. Kiali とフィルターボックスに入力して、Kiali Operator を検索します。
  4. Red Hat が提供する Kiali Operator をクリックし、Operator についての情報を表示します。
  5. Install をクリックします。
  6. Create Operator Subscription ページで、All namespaces on the cluster (default) を選択します。これにより、Operator がデフォルトの openshift-operators プロジェクトにインストールされ、Operator はクラスター内のすべてのプロジェクトで利用可能になります。
  7. stable Update Channel を選択します。
  8. Automatic Approval Strategy を選択します。

    注記

    手動の承認ストラテジーには、Operator のインストールおよびサブスクリプションプロセスを承認するための適切な認証情報を持つユーザーが必要です。

  9. Subscribe をクリックします。
  10. Subscription Overview ページには、Kiali Operator のインストールの進捗状況が表示されます。

2.2.1.4. Red Hat OpenShift Service Mesh Operator のインストール

前提条件

  • OpenShift Container Platform Web コンソールへのアクセス。
  • Elasticsearch Operator がインストールされていること。
  • Jaeger Operator がインストールされていること。
  • Kiali Operator がインストールされていること。

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. Catalog OperatorHub に移動します。
  3. Red Hat OpenShift Service Mesh とフィルターボックスに入力して、Red Hat OpenShift Service Mesh Operator を検索します。
  4. Red Hat OpenShift Service Mesh Operator をクリックし、Operator についての情報を表示します。
  5. Create Operator Subscription ページで、All namespaces on the cluster (default) を選択します。これにより、Operator がデフォルトの openshift-operators プロジェクトにインストールされ、Operator はクラスター内のすべてのプロジェクトで利用可能になります。
  6. Install をクリックします。
  7. 1.0 Update Channel を選択します。
  8. Automatic Approval Strategy を選択します。

    注記

    手動の承認ストラテジーには、Operator のインストールおよびサブスクリプションプロセスを承認するための適切な認証情報を持つユーザーが必要です。

  9. Subscribe をクリックします。
  10. Subscription Overview ページには、Red Hat OpenShift Service Mesh Operator のインストールの進捗状況が表示されます。

2.2.2. Red Hat OpenShift Service Mesh コントロールプレーンのデプロイ

OpenShift Container Platform Web コンソールまたは CLI を使用してサービスメッシュコントロールプレーンをデプロイすることができます。

2.2.2.1. Web コンソールを使用したコントロールプレーンのデプロイ

以下の手順に従って、Web コンソールを使用して Red Hat OpenShift Service Mesh コントロールプレーンをデプロイします。

前提条件

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. istio-system という名前のプロジェクトを作成します。
  3. Catalogs Installed Operators に移動します。
  4. Red Hat OpenShift Service Mesh Operator をクリックします。
  5. Provided APIs で、Operator は 2 つのリソースタイプを作成できます。

    • ServiceMeshControlPlane リソース
    • ServiceMeshMemberRoll リソース
  6. Istio Service Mesh PlaneCreate New をクリックします。
  7. 最小の ServiceMeshControlPlane テンプレートを変更します。

    注記

    コントロールプレーンおよびコントロールプレーンパラメーターをカスタマイズする詳細については、Red Hat OpenShift Service Mesh のインストールのカスタマイズを参照してください。

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

2.2.2.2. CLI からのコントロールプレーンのデプロイ

以下の手順に従って、CLI を使用して Red Hat OpenShift Service Mesh コントロールプレーンをデプロイします。

前提条件

注記

コントロールプレーンおよびコントロールプレーンパラメーターをカスタマイズする詳細については、Red Hat OpenShift Service Mesh のインストールのカスタマイズを参照してください。

手順

  1. OpenShift Container Platform CLI にログインします。
  2. istio-installation.yaml という名前の ServiceMeshControlPlane ファイルを作成します。
  3. 以下のコマンドを実行してコントロールプレーンをデプロイします。

    $ oc create -n istio-system -f istio-installation.yaml
  4. 以下のコマンドを実行して、インストールプロセス時に Pod の進捗を確認します。

    $ oc get pods -n istio-system -w

2.2.3. アプリケーション Pod の更新

Operator をインストールする際に Automatic Approval Strategy を選択した場合には、Operator はコントロールプレーンを自動的に更新しますが、アプリケーションを更新しません。既存のアプリケーションは、引き続きメッシュの一部になり、それに応じて機能します。アプリケーション管理者は、サイドカーコンテナーをアップグレードするためにアプリケーションを再起動する必要があります。

デプロイメントで自動のサイドカーコンテナー挿入を使用する場合、アノテーションを追加または変更してデプロイメントの Pod テンプレートを更新することができます。以下のコマンドを実行して Pod を再デプロイします。

$ oc patch deployment/<deployment> -p '{"spec":{"template":{"metadata":{"annotations":{"kubectl.kubernetes.io/restartedAt": "'`date -Iseconds`'"}}}}}'

デプロイメントで自動のサイドカーコンテナー挿入を使用しない場合、デプロイメントまたは Pod で指定されたサイドカーコンテナーイメージを変更してサイドカーコンテナーを手動で更新する必要があります。

2.2.4. Red Hat OpenShift Service Mesh メンバーロールの設定

ServiceMeshControlPlane と同じプロジェクトに、サービスメッシュに関連付けられた default という名前の ServiceMeshMemberRoll リソースを作成する必要があります。

警告

Container Network Interface (CNI) プラグインを有効にすると、手動のサイドカーコンテナー挿入が機能しますが、Pod が ServiceMeshMemberRoll リソースで指定されていない限り、Pod はコントロールプレーンと通信できません。

注記

メンバープロジェクトは、サービスメッシュコントロールプレーンのインストールが成功した場合にのみ更新されます。

  • 任意の数のプロジェクトを追加できますが、プロジェクトは単一ServiceMeshMemberRoll リソースしか属することができません。

ServiceMeshMemberRoll リソースは、対応する ServiceMeshControlPlane リソースが削除されると削除されます。

2.2.4.1. OpenShift Container Platform Web コンソールからのメンバーロールの設定

以下の手順に従って、Web コンソールを使用して Bookinfo プロジェクトをサービスメッシュメンバーロールに追加します。

前提条件

  • Red Hat OpenShift Service Mesh Operator がインストールされ、検証されていること。

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. Home Projects をクリックします。
  3. Create Project をクリックします。
  4. Project Name (例: bookinfo)、Display NameDescription を入力し、Create をクリックします。
  5. Catalog Installed Operators をクリックします。
  6. Project メニューをクリックし、一覧から istio-system を選択します。
  7. Red Hat OpenShift Service Mesh Operator の Provided API で、Istio Service Mesh Member Roll リンクをクリックします。
  8. All Instances をクリックし、Create New をクリックしてから Create Istio Service Mesh Member Roll をクリックします。

    注記

    Operator がプロジェクトの作成を終了するまでに少し時間がかかる場合があります。そのため、Web コンソールに Create Istio Service Mesh Member Roll ボタンが表示されるように画面を更新する必要がある場合があります。

  9. デフォルトの Service Mesh Member Roll YAML を編集し、bookinfomembers 一覧に追加します。
  10. Create をクリックして、更新した Service Mesh Member Roll を保存します。

2.2.4.2. CLI からのメンバーロールの設定

この例では、CLI から Bookinfo プロジェクトをサービスメッシュに追加しています。

前提条件

  • Service Mesh Operator がインストールされ、検証されていること。
  • ServiceMeshMemberRoll リソースを持つプロジェクトの名前。
  • oc として知られる OpenShift Container Platform コマンドラインインターフェース (CLI) へのアクセス。

手順

  1. OpenShift Container Platform CLI にログインします。
  2. ServiceMeshControlPlane リソースと同じプロジェクトに ServiceMeshMemberRoll リソースを作成します。
  3. リソースに default という名前を付けます。
  4. Bookinfo プロジェクトを ServiceMeshMemberRoll のメンバー一覧に追加します。この例では、bookinfo プロジェクトは ServiceMeshMembereRoll リソースと同じプロジェクトにデプロイされているサービスメッシュに参加しています。

      apiVersion: maistra.io/v1
      kind: ServiceMeshMemberRoll
      metadata:
        name: default
      spec:
        members:
        # a list of projects joined into the service mesh
        - bookinfo

次のステップ

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.