Alibaba Cloud Service Mesh:メッシュトポロジーを有効化して可観測性を向上させる

方法 1：新規 ASM インスタンスの作成

1. ASM コンソール にログインします。左側のナビゲーションウィンドウで、[サービスメッシュ] > [メッシュ管理] を選択します。

2. Mesh Management ページで、Create ASM Instance をクリックします。

3. Observability セクションで、Enable Prometheus Metrics を選択します。次に、必要に応じて Prometheus タイプを選択し、関連する操作を行います。

   [Prometheus タイプ]	[操作]
   Managed Service for Prometheus	Prometheus によるメトリクス収集 を選択し、次に Kialiを有効にする を選択します。Managed Service for Prometheus の統合と課金情報の詳細については、「メッシュ監視のために Managed Service for Prometheus を統合する」および「課金」をご参照ください。
   セルフマネージド Prometheus	自己作成prometheusを有効にする を選択し、次に Kialiを有効にする を選択します。ASM メッシュトポロジーが使用する Prometheus サービスエンドポイント (つまり、セルフマネージド Prometheus サービスのアクセスエンドポイント) を入力します。セルフマネージド Prometheus の統合の詳細については、「メッシュ監視のためにセルフマネージド Prometheus を統合する」をご参照ください。

   説明

   • Enable Prometheus Metrics を選択すると、お使いの Service Mesh インスタンスのメトリクス収集が有効になります。この操作では、ARMS インスタンスまたはセルフマネージド Prometheus インスタンスは自動的に作成されません。

   • Enable Prometheus Metrics と Kialiを有効にする の両方の選択を解除すると、メッシュトポロジーが無効になります。

4. 必要な情報を設定し、Service Agreement をよく読んで選択します。次に、ページ下部の Create Service Mesh をクリックします。

   設定項目の詳細については、「ASM インスタンスの作成」をご参照ください。

5. 新しく作成した ASM インスタンスに Container Service for Kubernetes (ACK) クラスターを追加します。詳細については、「ASM インスタンスにクラスターを追加する」をご参照ください。

方法 2：既存 ASM インスタンスの使用

ASM インスタンスに ACK クラスターがすでに追加されていることを確認してください。詳細については、「ASM インスタンスにクラスターを追加する」をご参照ください。

ASM バージョン 1.12.4.50 より前

1. ASM コンソール にログインします。左側のナビゲーションウィンドウで、[サービスメッシュ] > [メッシュ管理] を選択します。

2. Mesh Management ページで、対象のインスタンス名をクリックします。左側のナビゲーションペインで、Instance Information > Base Information を選択します。ページの右側で、Settings をクリックします。

3. Settings Update パネルで、Enable Prometheus Metrics を選択します。次に、必要に応じて Prometheus タイプを選択し、関連する操作を行います。

   [Prometheus タイプ]	[操作]
   Managed Service for Prometheus	Prometheus によるメトリクス収集 を選択し、次に Kialiを有効にする を選択します。Managed Service for Prometheus の統合と課金情報の詳細については、「メッシュ監視のために Managed Service for Prometheus を統合する」および「課金」をご参照ください。
   セルフマネージド Prometheus	自己作成prometheusを有効にする を選択し、次に Kialiを有効にする を選択します。ASM メッシュトポロジーが使用する Prometheus サービスエンドポイント (つまり、セルフマネージド Prometheus サービスのアクセスエンドポイント) を入力します。セルフマネージド Prometheus の統合の詳細については、「メッシュ監視のためにセルフマネージド Prometheus を統合する」をご参照ください。

4. 設定が完了したら、Settings Update パネルの下部で OK をクリックします。

ASM バージョン 1.12.4.50 以降

1. ASM コンソール にログインします。左側のナビゲーションウィンドウで、[サービスメッシュ] > [メッシュ管理] を選択します。

2. Mesh Management ページで、対象のインスタンス名をクリックします。左側のナビゲーションペインで、Observability Management Center > Mesh Topology を選択します。Activate ASM mesh topology セクションで、ASM バージョンに基づいて次の操作を行います。

   • ASM バージョン 1.18.2.112 より前：Activate をクリックします。

   • ASM バージョン 1.18.2.112 以降：次のいずれかのデプロイメントモードを選択します。2 つのモードの違いとマネージドモードの設定方法については、「マネージドモードでメッシュトポロジーを有効化する」をご参照ください。

     • In-Kubernetes-cluster Mode をクリックし、ASM メッシュトポロジーが使用する Prometheus サービスエンドポイントを入力して、Activate をクリックします。

     • Managed Mode をクリックし、Activate をクリックして、表示されるダイアログボックスで必要な情報を設定し、OK をクリックします。

方法 1：メッシュトポロジーへの直接アクセス

ASM バージョンが 1.12.4.50 以降の場合、Classic Load Balancer (CLB) を自動的に作成して ASM メッシュトポロジーにアクセスし、メッシュトポロジー サービスに直接アクセスすることを選択できます。

1. ASM コンソール にログインします。左側のナビゲーションウィンドウで、[サービスメッシュ] > [メッシュ管理] を選択します。

2. Mesh Management ページで、対象のインスタンス名をクリックします。左側のナビゲーションペインで、Observability Management Center > Mesh Topology を選択します。

3. Access セクションで、ASM インスタンスのバージョンに基づいて次の操作を行います。

   • ASM バージョン 1.15.3.120 より前：Automatically Create Internet-facing CLB Instance to Access ASM Mesh Topology を選択します。

   • ASM バージョン 1.15.3.120 以降、1.17.2.19 より前：Automatically Create Internet-facing CLB Instance to Access ASM Mesh Topology の横にあるスイッチをオンにします。表示されるダイアログボックスで、OK をクリックします。

   • ASM バージョン 1.17.2.19 以降：Create CLB Instance to Access ASM Mesh Topology の横にあるスイッチをオンにします。表示されるダイアログボックスで、必要に応じて必要な設定を行い、OK をクリックします。

   メッシュトポロジーアクセスを有効にすると、お使いの Service Mesh は一時的な更新状態になります。

4. お使いの Service Mesh の更新が完了したかどうかを確認してください。

   1. 左側のナビゲーションペインで、Instance Information > Base Information を選択します。

   2. Basic Information セクションで、Service Mesh の Status を確認します。

      Status が Updating の場合、更新が進行中です。Status が Running の場合、更新が完了しています。

5. Mesh Topology ページの Access セクションで、Click here to access ASM Mesh Topology または Copy token and open in new window をクリックして、メッシュトポロジーログインページに移動します。

方法 2：ASM ゲートウェイを使用したメッシュトポロジーへのアクセス

1. イングレスゲートウェイを作成し、メッシュトポロジーアクセスをサポートするポート設定をイングレスゲートウェイに追加します。詳細については、「イングレスゲートウェイサービスの作成」または「KubeAPI を使用したイングレスゲートウェイの管理」をご参照ください。

   次の YAML は、サンプルポート設定を示しています。

   - name: http-kiali
     port: 20001
     protocol: TCP
     targetPort: 20001

   spec:
     clusterIds:
       - c729bdf9ef09b4a259e693f76axxx
     cpu: {}
     externalTrafficPolicy: Local
     maxReplicas: 5
     minReplicas: 2
     ports:
       - name: status-port
         port: 15020
         targetPort: 15020
       - name: http2
         port: 80
         targetPort: 80
       - name: https
         port: 443
         targetPort: 443
       - name: tls
         port: 15443
         targetPort: 15443
       - name: http-kiali
         port: 20001
         protocol: TCP
         targetPort: 20001

2. 次の YAML を使用して Gateway を作成します。詳細については、「Gateway の管理」をご参照ください。

   apiVersion: networking.istio.io/v1alpha3
   kind: Gateway
   metadata:
     name: kiali-gateway
     namespace: istio-system
   spec:
     selector:
       istio: ingressgateway
     servers:
       - hosts:
           - '*'
         port:
           name: http
           number: 20001
           protocol: HTTP

3. 次の YAML を使用して VirtualService を作成します。詳細については、「VirtualService の管理」をご参照ください。

   apiVersion: networking.istio.io/v1alpha3
   kind: VirtualService
   metadata:
     name: kiali-vs
     namespace: istio-system
   spec:
     gateways:
       - kiali-gateway
     hosts:
       - '*'
     http:
       - route:
           - destination:
               host: kiali
               port:
                 number: 20001

4. メッシュトポロジーにログインします。

   1. ASM コンソール にログインします。左側のナビゲーションウィンドウで、[サービスメッシュ] > [メッシュ管理] を選択します。

   2. Mesh Management ページで、対象のインスタンス名をクリックします。左側のナビゲーションペインで、Instance Information > Base Information を選択します。

   3. Config Info セクションで、Activate ASM mesh topology の横にある Ingressゲートウェイを介したアクセス をクリックして、メッシュトポロジーログインページに移動します。

方法 1：トークンを使用したメッシュトポロジーへのログオン

ASM バージョン 1.12.4.50 より前

ACK コンソールからトークンを取得し、それを使用してメッシュトポロジーにログオンします。

1. ACK コンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のウィンドウで、[設定] > [秘密] を選択します。

3. シークレット ページで、Namespaces に [istio-system] を選択し、[kiali-service-account-token-****] をクリックしてから、[token] 行の横にある アイコンをクリックしてトークンをコピーします。

4. メッシュトポロジーログインページで、トークンを貼り付け、[ログイン] をクリックしてメッシュトポロジーコンソールにアクセスします。

ASM バージョン 1.12.4.50 以降

ASM コンソールからトークンを取得し、それを使用してメッシュトポロジーにログオンします。

1. ASM コンソール にログインします。左側のナビゲーションウィンドウで、[サービスメッシュ] > [メッシュ管理] を選択します。

2. Mesh Management ページで、対象のインスタンス名をクリックします。左側のナビゲーションペインで、Observability Management Center > Mesh Topology を選択します。

3. Mesh Topology ページの Access セクションで、Copy token and open in new window をクリックします。

4. メッシュトポロジーログインページで、トークンを貼り付け、[ログイン] をクリックしてメッシュトポロジーコンソールにアクセスします。

方法 2：OIDC を使用したメッシュトポロジーへのログオン

OIDC (OpenID Connect) は、シングルサインオン (SSO) を実装するために一般的に使用される ID 認証および承認プロトコルです。OIDC プロトコルを使用して ID プロバイダー (IdP) と統合し、メッシュトポロジーにログオンできます。この方法には ASM バージョン 1.15.3.120 以降が必要です。ASM バージョンのアップグレードの詳細については、「ASM インスタンスのアップグレード」をご参照ください。

1. ID プロバイダー (IdP) を設定します。詳細については、「メッシュアプリケーションで SSO を実現するために ASM を Alibaba Cloud IDaaS と統合する」のステップ 1 およびステップ 2 をご参照ください。

   [ログインリダイレクト URI] を、メッシュトポロジーの CLB の IP アドレス (CLB 経由の直接アクセスの場合) または ASM ゲートウェイアドレス (ASM ゲートウェイ経由のアクセスの場合) に設定します。例：

   • CLB 経由でメッシュトпоロジーにアクセスし、CLB IP が xxx.xxx.xxx.xxx の場合、[ログインリダイレクト URI] を http://xxx.xxx.xxx.xxx:20001 に設定します。20001 の後に / や /xxx などのパスを追加しないでください。

   • ASM ゲートウェイ経由でメッシュトポロジーにアクセスし、ゲートウェイ IP が yyy.yyy.yyy.yyy の場合、[ログインリダイレクト URI] を http://yyy.yyy.yyy.yyy:20001 に設定します。20001 の後に / や /xxx などのパスを追加しないでください。

2. OIDC を使用してメッシュトポロジーにログオンします。

   1. ASM コンソール にログインします。左側のナビゲーションウィンドウで、[サービスメッシュ] > [メッシュ管理] を選択します。

   2. Mesh Management ページで、対象のインスタンス名をクリックします。左側のナビゲーションペインで、Observability Management Center > Mesh Topology を選択します。

   3. Authentication セクションで、Login with OIDC を選択します。必要な情報を設定し、Save configuration of Mesh Topology をクリックしてから、[新しいページで ASM メッシュトポロジーを開く] をクリックします。

   4. メッシュトポロジーログインページで、[OpenID でログイン] をクリックして、OIDC アプリケーションログインページに移動します。