ACK クラスタ内のマイクロサービスアプリケーションのマイクロサービスガバナンスを有効にする - Microservices Engine

マイクロサービスエンジン（MSE）のマイクロサービスガバナンスは、Container Service for Kubernetes クラスタまたは Container Compute Service クラスタにデプロイされている Spring Cloud や Dubbo アプリケーションなどのマイクロサービスアプリケーションに対して有効にすることができます。これにより、MSE が提供する一連のサービスガバナンス機能を使用して、マイクロサービスアプリケーションを管理できます。これは、オンラインマイクロサービスアプリケーションの安定性と開発効率の向上に役立ちます。このトピックでは、ACK または ACS クラスタ内のマイクロサービスアプリケーションのマイクロサービスガバナンスを有効にする方法について説明します。

前提条件

ACK または ACS クラスタが作成されていること。詳細については、「ACK 専用クラスターを作成する」、「ACK マネージドクラスターを作成する」、または「ACK Serverless クラスターを作成する」をご参照ください。
マイクロサービスガバナンスがアクティブ化されていること。マイクロサービスガバナンスをアクティブ化していない場合は、マイクロサービスガバナンスタブに移動します。

重要

オープンソースの Sentinel と com.alibaba.cloud.sentinel.feign.SentinelFeignAutoConfiguration の両方がプロジェクトで使用されている場合、Java アプリケーションでマイクロサービスガバナンスを有効にできない場合があります。
MSE Java エージェントをマウントするには、Java 仮想マシン（JVM）ヒープメモリのサイズが 256 MB より大きいことを確認する必要があります。

手順

説明

アプリケーションのマイクロサービスガバナンスを有効にするには、次のルールに従うことをお勧めします。

名前空間内のすべてまたはほとんどのアプリケーションに対してマイクロサービスガバナンスを有効にする必要がある場合は、「シナリオ 1：ACK または ACS クラスタ名前空間内のすべてのアプリケーションに対してマイクロサービスガバナンスを有効にする」の手順に従うことをお勧めします。名前空間内でマイクロサービスガバナンスを有効にする必要のない他のアプリケーションの場合は、アプリケーションに spec.template.labels.msePilotAutoEnable: "off" フラグを追加します。
名前空間内の少数のアプリケーションに対してマイクロサービスガバナンスを有効にする必要がある場合は、「シナリオ 2：単一アプリケーションに対してマイクロサービスガバナンスを有効にする」の手順に従うことをお勧めします。

シナリオ 1：ACK または ACS クラスタ名前空間内のすべてのアプリケーションに対してマイクロサービスガバナンスを有効にする

名前空間内のアプリケーションに対してマイクロサービスガバナンスを有効にすると、名前空間内のすべてのポッドがマイクロサービスガバナンスに接続されます。各ポッドをマイクロサービスガバナンスに手動で接続する必要はありません。

MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、Microservices Governance > Application Governance を選択します。
Application list ページで、ACK Application Access をクリックします。

ACK Application Access ダイアログボックスで、パラメータを設定し、OK をクリックします。

パラメータ	説明
Cluster type	ACK Cluster、ACK Serverless Cluster、または ACS Cluster を選択します。説明クラスタに MSE を呼び出す権限を付与していない場合は、リンクをクリックして権限付与を実行する必要があります。
Cluster Name/ID	マイクロサービスガバナンスを有効にするクラスタの名前または ID を選択します。キーワードを使用して、クラスタ名または ID を検索できます。
ack-onepilot	ack-onepilot コンポーネントのステータスを表示します。 ack-onepilot コンポーネントがインストールされていない場合は、ack-onepilot の右側にある Click Install をクリックします。インストールが完了すると、ack-onepilot コンポーネントのステータスはインストール済みと表示されます。 RAM ユーザーとして操作を実行し、操作を実行する権限がないことを示すメッセージが表示された場合は、ACK コンソールにログインして目的のクラスタにアクセスし、[操作] > [アドオン] を選択します。次に、ack-onepilot を見つけて [インストール] をクリックします。説明この手順では、ack-onepilot コンポーネントが関係しています。 ACK コンソールにログインしてデスティネーションクラスタにアクセスし、[操作] > [アドオン] を選択して、コンポーネントの詳細を表示できます。 ack-onepilot コンポーネントがインストールされると、エージェントが自動的に挿入されます。この場合、アプリケーションの起動時間が最大 10 秒長くなる可能性があります。 ACK または ACS クラスタ名前空間内のアプリケーションに対してマイクロサービスガバナンスを有効にする必要があるが、クラスタがサポートされているリージョンにデプロイされていない場合は、クラスタがインターネットにアクセスでき、acm.aliyun.com:8080 に接続できることを確認する必要があります。サポートされているリージョンには、中国 (青島)、中国 (杭州)、中国 (北京)、中国 (上海)、中国東部 2 金融、中国 (深セン)、中国 (香港)、シンガポール、ドイツ (フランクフルト)、オーストラリア (シドニー)、米国 (シリコンバレー)、米国 (バージニア) が含まれます。
Access Type	[名前空間アクセス] を選択します。
Cluster Namespace	ACK クラスタ名前空間を選択します。
Microservices Governance Namespace	マイクロサービスガバナンス名前空間を選択します。次に、既存のアプリケーションを再デプロイするか、関連付けられたマイクロサービス名前空間にアプリケーションを作成します。これにより、アプリケーションに対してマイクロサービスガバナンスが有効になります。

注：

デフォルトでは、マイクロサービスガバナンスが有効になっているアプリケーションの名前は、デプロイメントの名前です。アプリケーション名を変更するには、アプリケーションの YAML ファイルを編集します。

spec:
  template:
    metadata:
      labels:
        mseNamespace: default # アプリケーションが存在する MSE マイクロサービス名前空間の名前。 このパラメータを指定しない場合、マイクロサービス名前空間 default が使用されます。
        msePilotCreateAppName: "your-deployment-name" # your-deployment-name をアプリケーションの名前に置き換えます。

アプリケーションに対してマイクロサービスガバナンスを無効にするには、アプリケーションの msePilotAutoEnable を off に設定します。

spec:
  template:
    metadata:
      labels:
        msePilotAutoEnable: "off" # off 値は二重引用符（"）または単一引用符（'）で囲む必要があります。

シナリオ 2：単一アプリケーションに対してマイクロサービスガバナンスを有効にする

名前空間内の少数のアプリケーションに対してのみマイクロサービスガバナンスを有効にする必要がある場合は、これらのアプリケーションごとに MSE マイクロサービスガバナンスを個別に有効にすることができます。

MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、Microservices Governance > Application Governance を選択します。
Application list ページで、ACK Application Access をクリックします。

ACK Application Access ダイアログボックスで、パラメータを設定し、OK をクリックします。

パラメータ	説明
Cluster type	ACK Cluster、ACK Serverless Cluster、または ACS Cluster を選択します。説明クラスタに MSE を呼び出す権限を付与していない場合は、リンクをクリックして権限付与を実行する必要があります。
Cluster Name/ID	マイクロサービスガバナンスを有効にするクラスタの名前または ID を選択します。キーワードを使用して、クラスタ名または ID を検索できます。
ack-onepilot	ack-onepilot コンポーネントのステータスを表示します。 ack-onepilot コンポーネントがインストールされていない場合は、ack-onepilot の右側にある Click Install をクリックします。インストールが完了すると、ack-onepilot コンポーネントのステータスはインストール済みと表示されます。 RAM ユーザーとして操作を実行し、操作を実行する権限がないことを示すメッセージが表示された場合は、ACK コンソールにログインして目的のクラスタにアクセスし、[操作] > [アドオン] を選択します。次に、ack-onepilot を見つけて [インストール] をクリックします。説明この手順では、ack-onepilot コンポーネントが関係しています。 ACK コンソールにログインしてデスティネーションクラスタにアクセスし、[操作] > [アドオン] を選択して、コンポーネントの詳細を表示できます。 ack-onepilot コンポーネントがインストールされると、エージェントが自動的に挿入されます。この場合、アプリケーションの起動時間が最大 10 秒長くなる可能性があります。
Access Type	Single Application Access を選択します。
Access Procedure	次の手順を実行します。 Step 1: Go to the ACK console, and click the cluster name. In the left-side navigation pane of the page that appears, choose Workloads > Deployments. Then, select the namespace to which the application belongs. Step 2: Click the name of the connected application. On the page that appears, click View in YAML. Step 3: Edit the labels field in the following format and click Update. spec: template: metadata: labels: # on 値は、マイクロサービスガバナンスが有効になっていることを示します。 on 値は二重引用符（"）で囲む必要があります。 msePilotAutoEnable: "on" # アプリケーションが存在する MSE マイクロサービス名前空間。指定した名前空間が存在しない場合は、指定した名前の名前空間が自動的に作成されます。 mseNamespace: 202401 # マイクロサービスガバナンスが有効になっているアプリケーションの実際の名前。名前は二重引用符（"）で囲む必要があります。 msePilotCreateAppName: "your-deployment-name"

結果の確認

上記の手順を実行し、アプリケーションを再起動すると、Container Service for Kubernetes または Container Compute Service クラスタにデプロイされているアプリケーションに対してマイクロサービスガバナンスが有効になります。

MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、Microservices Governance > Application Governance を選択します。
マイクロサービス名前空間を選択して、マイクロサービスガバナンスが有効になっているアプリケーションを表示します。