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

シナリオ 1: 新しい ASM インスタンスのメッシュトポロジーを有効にする

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

2. [メッシュ管理] ページで、[ASM インスタンスの作成] をクリックします。

3. [可観測性] セクションで、[managed Service For Prometheus を有効にする] を選択し、Prometheus インスタンスタイプに基づいて操作を選択します。

   Prometheus インスタンスタイプ	操作
   Managed Service for Prometheus インスタンス	[managed Service For Prometheus を使用してメトリクスを収集する] を選択し、[ASM メッシュトポロジーを有効にする] を選択します。 Managed Service for Prometheus を統合してサービスメッシュを監視する方法、および Managed Service for Prometheus の課金については、Managed Service for Prometheus を統合してサービスメッシュを監視する および 課金モード を参照してください。
   セルフマネージド Prometheus インスタンス	[セルフビルド Prometheus を統合してメトリクス監視を実現する] および [ASM メッシュトポロジーを有効にする] を選択し、メッシュトポロジーが使用するセルフマネージド Prometheus インスタンスの HTTP API アドレスを入力します。 セルフマネージド Prometheus インスタンスを統合する方法については、セルフマネージド Prometheus インスタンスを使用して ASM インスタンスを監視する を参照してください。

   説明

   • [managed Service For Prometheus を有効にする] を選択すると、Service Mesh インスタンスのメトリクスのみが収集されます。 Application Real-Time Monitoring Service (ARMS) インスタンスまたはセルフマネージド Prometheus インスタンスは自動的に作成されません。

   • [managed Service For Prometheus を有効にする] と [ASM メッシュトポロジーを有効にする] の両方を選択解除すると、メッシュトポロジーは無効になります。

4. 関連パラメータを構成し、[サービス規約] を読んで同意し、ページ下部にある [サービスメッシュの作成] をクリックします。

   構成項目の説明については、ASMインスタンスの作成をご参照ください。

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

シナリオ 2: 既存の ASM インスタンスのメッシュトポロジーを有効にする

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

バージョンが 1.12.4.50 より前の ASM インスタンスの場合

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

2. [メッシュ管理] ページで、管理する ASM インスタンスの名前をクリックします。 左側のナビゲーションペインで、[ASM インスタンス] > [基本情報] を選択します。 ページの右上で、[設定] をクリックします。

3. [設定の更新] パネルで、[managed Service For Prometheus を有効にする] を選択し、Prometheus インスタンスタイプに基づいて操作を選択します。

   Prometheus インスタンスタイプ	操作
   Managed Service for Prometheus インスタンス	[managed Service For Prometheus を使用してメトリクスを収集する] を選択し、[ASM メッシュトポロジーを有効にする] を選択します。 Managed Service for Prometheus を統合してサービスメッシュを監視する方法、および Managed Service for Prometheus の課金については、Managed Service for Prometheus を統合してサービスメッシュを監視する および 課金モード を参照してください。
   セルフマネージド Prometheus インスタンス	[セルフビルド Prometheus を統合してメトリクス監視を実現する] および [ASM メッシュトポロジーを有効にする] を選択し、メッシュトポロジーが使用するセルフマネージド Prometheus インスタンスの HTTP API アドレスを入力します。 セルフマネージド Prometheus インスタンスを統合する方法については、セルフマネージド Prometheus インスタンスを使用して ASM インスタンスを監視する を参照してください。

4. 構成が完了したら、[設定の更新] パネルの下部にある [OK] をクリックします。

バージョンが 1.12.4.50 以降の ASM インスタンスの場合

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

2. [メッシュ管理] ページで、管理する ASM インスタンスの名前をクリックします。 左側のナビゲーションペインで、[可観測性管理センター] > [メッシュトポロジー] を選択します。 [ASM メッシュトポロジーを有効にする] セクションで、ASM インスタンスのバージョンに基づいて操作を実行します。

   • ASM インスタンスのバージョンが 1.18.2.112 より前の場合は、[有効にする] をクリックします。

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

     • [kubernetes クラスタ内モード] をクリックし、ASM メッシュトポロジーが使用する Prometheus インスタンスの HTTP API URL を入力して、[有効にする] をクリックします。

     • [マネージドモード] をクリックし、[有効にする] をクリックします。 表示されるダイアログボックスで、必要なパラメータを構成し、[OK] をクリックします。

方法 1: メッシュトポロジーに直接アクセスする

ASM インスタンスのバージョンが 1.12.4.50 以降の場合は、Classic Load Balancer (CLB) インスタンスを作成して ASM メッシュトポロジーにアクセスできます。

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

2. [メッシュ管理] ページで、管理する ASM インスタンスの名前をクリックします。 左側のナビゲーションペインで、[可観測性管理センター] > [メッシュトポロジー] を選択します。

3. [アクセス] セクションで、ASM インスタンスのバージョンに基づいて次のいずれかの操作を実行します。

   • ASM インスタンスのバージョンが 1.15.3.120 より前の場合は、[インターネット向け CLB インスタンスを自動的に作成して ASM メッシュトポロジーにアクセスする] を選択します。

   • ASM インスタンスのバージョンが 1.15.3.120 以降 1.17.2.19 より前の場合は、[インターネット向け CLB インスタンスを自動的に作成して ASM メッシュトポロジーにアクセスする] をオンにします。 表示されるダイアログボックスで、[OK] をクリックします。

   • ASM インスタンスのバージョンが 1.17.2.19 以降の場合は、[CLB インスタンスを作成して ASM メッシュトポロジーにアクセスする] をオンにします。 表示されるダイアログボックスで、必要なパラメータを構成し、[OK] をクリックします。

   メッシュトポロジーアクセスが有効になると、ASM インスタンスは短時間更新状態になります。

4. ASM インスタンスの更新が完了したかどうかを確認します。

   1. 左側のナビゲーションペインで、[ASM インスタンス] > [基本情報] を選択します。

   2. [基本情報] セクションで、ASM インスタンスの [ステータス] を確認します。

      [ステータス] が [更新中] の場合は、ASM インスタンスの更新が進行中です。 [ステータス] が [実行中] の場合は、更新は完了しています。

5. [メッシュトポロジー] ページの [アクセス] セクションで、[ここをクリックして ASM メッシュトポロジーにアクセスする] または [トークンをコピーして新しいウィンドウで開く] をクリックして、メッシュトポロジーのログオンページを開きます。

方法 2: ASM ゲートウェイを使用してメッシュトポロジーにアクセスする

1. イングレスゲートウェイを作成し、メッシュトポロジーにアクセスするためのポートを構成します。 詳細については、イングレスゲートウェイを作成する または Kubernetes API を使用してイングレスゲートウェイを作成および管理するを参照してください。

   ポート構成の YAML 例:

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

   

2. 次の YAML テンプレートを使用して、Istio ゲートウェイを作成します。 詳細については、Istio ゲートウェイを管理する を参照してください。

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

3. 次の YAML テンプレートを使用して、仮想サービスを作成します。 詳細については、仮想サービスを管理する を参照してください。

   apiVersion: networking.istio.io/v1alpha3
   kind: VirtualService // 仮想サービス
   metadata:
     name: kiali-vs // kiali-vs
     namespace: istio-system
   spec:
     gateways:
       - kiali-gateway // kiali-ゲートウェイ
     hosts:
       - '*'
     http:
       - route:
           - destination:
               host: kiali
               port:
                 number: 20001

4. メッシュトポロジーのログオンページを開きます。

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

   2. [メッシュ管理] ページで、管理する ASM インスタンスの名前をクリックします。 左側のナビゲーションペインで、[ASM インスタンス] > [基本情報] を選択します。

   3. [構成情報] セクションで、[ASM メッシュトポロジーを有効にする] の右側にある [イングレスゲートウェイからアクセス] をクリックして、メッシュトポロジーのログオンページを開きます。

方法 1: トークンを使用してメッシュトポロジーにログオンする

バージョンが 1.12.4.50 より前の ASM インスタンスの場合

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

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

2. [クラスター] ページで、管理するクラスターを見つけ、その名前をクリックします。左側のペインで、[構成] > [シークレット] を選択します。

3. [シークレット] ページで、istio-system[名前空間] ドロップダウンリストから kiali-service-account-token-****トークン を選択します。[名前] 列の をクリックします。表示されたページで、 行の アイコンをクリックしてトークンをコピーします。

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

バージョンが 1.12.4.50 以降の ASM インスタンスの場合

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

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

2. [メッシュ管理] ページで、管理する ASM インスタンスの名前をクリックします。左側のナビゲーションペインで、[可観測性管理センター] > [メッシュトポロジー] を選択します。

3. [メッシュトポロジー] ページの [アクセス] セクションで、[トークンをコピーして新しいウィンドウで開く] をクリックします。

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

方法 2: OIDC を使用してメッシュトポロジーにログオンする

OIDC は、シングルサインオン (SSO) の実装によく使用される ID 認証および認可プロトコルです。 OIDC プロトコルを介して ID プロバイダー (IdP) に接続し、メッシュトポロジーにログオンできます。 OIDC を使用する場合は、ASM インスタンスのバージョンが 1.15.3.120 以降である必要があります。 ASM インスタンスの更新方法の詳細については、「ASM インスタンスの更新」をご参照ください。

1. IdP を構成します。詳細については、「Alibaba Cloud IDaaS と ASM を統合してシングルサインオンを実装する」の手順 1 と手順 2 をご参照ください。

   CLB インスタンスを使用してメッシュトポロジーにアクセスする場合は、[リダイレクト URI] を CLB インスタンスの IP アドレスに設定します。または、ASM ゲートウェイを使用してメッシュトポロジーにアクセスする場合は、このパラメーターを ASM ゲートウェイの IP アドレスに設定します。構成例:

   • CLB インスタンスを使用してメッシュトポロジーにアクセスし、CLB インスタンスの IP アドレスが xxx.xxx.xxx.xxx の場合、[リダイレクト URI] パラメーターを http://xxx.xxx.xxx.xxx:20001 に設定します。 20001 の後にスラッシュ (/) を付けないでください。たとえば、20001/xxx、20001/、20001/xxx/、および 20001/xxx/yyy は許可されていません。

   • ASM ゲートウェイを使用してメッシュトポロジーにアクセスし、ASM ゲートウェイの IP アドレスが yyy.yyy.yyy.yyy の場合、[リダイレクト URI] パラメーターを http://yyy.yyy.yyy.yyy:20001 に設定します。 20001 の後にスラッシュ (/) を付けないでください。たとえば、20001/xxx、20001/、20001/xxx/、および 20001/xxx/yyy は許可されていません。

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

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

   2. [メッシュ管理] ページで、管理する ASM インスタンスの名前をクリックします。左側のナビゲーションペインで、[可観測性管理センター] > [メッシュトポロジー] を選択します。

   3. [認証] セクションで、[OIDC でログイン] を選択し、関連パラメーターを構成します。 [メッシュトポロジーの構成を保存] をクリックします。次に、[ここをクリックして ASM メッシュトポロジーにアクセス] をクリックします。

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