Container Service for Kubernetes および Container Compute Service にデプロイされた Spring Cloud や Dubbo アプリケーションなどのマイクロサービスアプリケーションを Microservices Engine (MSE) ガバナンスセンターに接続できます。MSE が提供するサービスガバナンス機能を使用すると、オンラインマイクロサービスの安定性と開発効率を大幅に向上させることができます。このトピックでは、ACK および ACS のマイクロサービスアプリケーションを MSE ガバナンスセンターに接続する方法について説明します。
前提条件
ACK/ACS クラスターと MSE ガバナンスセンターが同じリージョンにある。
プロジェクトでオープンソースの Sentinel コンポーネントと
com.alibaba.cloud.sentinel.feign.SentinelFeignAutoConfigurationを同時に使用している場合、MSE ガバナンスセンターへの接続は失敗します。MSE Java エージェントをマウントする場合、JVM ヒープメモリは 256 MB を超えている必要があります。
ACK クラスターに MSE リソースへのアクセス権限があることを確認してください。
クラスターに ARMS アドオントークンがある場合、MSE はパスワードなしの権限付与を許可します。デフォルトでは、ACK マネージドクラスターには ARMS アドオントークンがあります。ただし、一部の初期の ACK マネージドクラスターにはこのトークンがない場合があります。これらのクラスターについては、ARMS アドオントークンが存在するかどうかを確認してください。
ACK マネージドクラスターで ARMS アドオントークン を確認するには、次の手順に従います。
Container Service for Kubernetes コンソールにログインします。[クラスター] ページで、ターゲットクラスターの名前をクリックして詳細ページを開きます。
左側のナビゲーションウィンドウで、 を選択します。ページの上部で、[名前空間] を [kube-system] に設定し、[addon.arms.token] が存在するかどうかを確認します。存在しない場合は、手動で必要な権限を付与する必要があります。
RAM ユーザーを使用してクイック統合を完了する場合は、「クイック統合を実行するための RAM ユーザーの権限」をご参照ください。
手順
接続タイプの選択に関する推奨事項:
名前空間内のすべてまたはほとんどのアプリケーションを MSE ガバナンスセンターに接続する必要がある場合は、シナリオ 1: ACK または ACS 名前空間のアプリケーションに対して MSE マイクロサービスガバナンスを有効にする を使用します。接続する必要のない名前空間内のアプリケーションについては、ラベル
spec.template.labels.msePilotAutoEnable: "off"を設定します。名前空間内の一部のアプリケーションのみを MSE ガバナンスセンターに接続する必要がある場合は、シナリオ 2: 単一のアプリケーションに対して MSE マイクロサービスガバナンスを有効にする を使用します。
シナリオ 1: ACK または ACS 名前空間のアプリケーションに対して MSE マイクロサービスガバナンスを有効にする
名前空間に対して MSE マイクロサービスガバナンスを有効にすると、その名前空間内の新しいアプリケーションおよび再デプロイされた既存のアプリケーションのすべての Pod が自動的に MSE マイクロサービスガバナンスに接続されます。1 つずつ接続する必要はありません。アプリケーションの作成方法の詳細については、「ステートレスワークロード (Deployment) の作成」をご参照ください。
MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、Microservices Governance > Application Governance を選択します。
Application list ページで、ACK Application Access をクリックします。
ACK Application Access ダイアログボックスで、パラメーターを設定し、OK をクリックします。

パラメーター
説明
Cluster type
ACK Cluster、ACK Serverless Cluster、または ACS Cluster を選択します。
説明Container Service for Kubernetes に Microservices Engine を呼び出す権限を付与していない場合は、[権限を付与してください] をクリックして権限を付与します。
Cluster Name/ID
MSE マイクロサービスガバナンスに接続する Cluster Name/ID の名前または ID を選択します。キーワードでクラスターを検索できます。
ack-onepilot
ack-onepilot コンポーネントのステータス。ack-onepilot コンポーネントとそのアップグレード方法の詳細については、「ack-onepilot コンポーネント」および「MSE マイクロサービスガバナンスコンポーネントのインストールとアップグレード」をご参照ください。
ack-onepilot がインストールされていない場合、クラスターを選択するとシステムによって自動的にインストールされます。「インストールには約 1 分かかります。しばらくお待ちください。」というメッセージが表示されます。
RAM ユーザーを使用していて必要な権限がない場合は、Container Service for Kubernetes コンソールにログインします。ターゲットクラスターの詳細ページに移動します。[コンポーネント管理] をクリックし、[ack-onepilot] を見つけて、[インストール] をクリックします。
ack-onepilot がインストールされている場合、コンソールには「インストール済み」とバージョン番号が表示されます (例: インストール済み 4.2.0)。
説明このステップでインストールされるコンポーネントは ack-onepilot です。Container Service for Kubernetes コンソールにログインし、ターゲットクラスターの詳細ページに移動して、[運用管理] >[コンポーネント管理] を選択して詳細を表示できます。
ack-onepilot がインストールされると、エージェントが自動的に挿入されます。これにより、アプリケーションの起動時間が最大 10 秒増加する可能性があります。
名前空間で接続し、ターゲットクラスターが次のリージョンのいずれにもない場合は、クラスターがインターネットにアクセスして acm.aliyun.com:8080 に接続できることを確認してください: 青島、杭州、北京、上海、上海金融クラウド、深セン、香港 (中国)、シンガポール、フランクフルト、シドニー、シリコンバレー、バージニア。
Access Type
Namespace Access を選択します。
Cluster Namespace
Cluster Namespace を選択します。
Microservices Governance Namespace
Microservices Governance Namespace を選択します。
追加情報:
デフォルトでは、ACK/ACS クラスター内のアプリケーションを MSE ガバナンスセンターに接続すると、コンソールはアプリケーションのデプロイメント名をその表示名として使用します。アプリケーション名をカスタマイズするには、デプロイされたアプリケーションの YAML 構成を変更できます。
spec: template: metadata: labels: # アプリケーションが存在する MSE microservices namespace。デフォルト値は default です。 mseNamespace: default # これを実際のアプリケーション名に置き換えます。 msePilotCreateAppName: "your-deployment-name"特定のアプリケーションのマイクロサービスガバナンスを無効にする場合は、デプロイされたアプリケーションの YAML 構成に
msePilotAutoEnableラベルを追加し、値をoffに設定します。spec: template: metadata: labels: # このフィールドの値 "off" は、二重引用符または一重引用符で囲む必要があります。 msePilotAutoEnable: "off"
シナリオ 2: 単一のアプリケーションに対して MSE マイクロサービスガバナンスを有効にする
名前空間内の一部のアプリケーションのみを MSE マイクロサービスガバナンスに接続する必要がある場合は、1 つずつ接続できます。
MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、Microservices Governance > Application Governance を選択します。
Application list ページで、ACK Application Access をクリックします。
ACK Application Access ダイアログボックスで、パラメーターを設定し、OK をクリックします。

パラメーター
説明
Cluster type
ACK Cluster、ACK Serverless Cluster、または ACS Cluster を選択します。
説明Container Service for Kubernetes に Microservices Engine を呼び出す権限を付与していない場合は、[権限を付与してください] をクリックして権限を付与します。
Cluster Name/ID
MSE マイクロサービスガバナンスに接続する Cluster Name/ID の名前または ID を選択します。キーワードでクラスターを検索できます。
ack-onepilot
ack-onepilot コンポーネントのステータス。ack-onepilot コンポーネントとそのアップグレード方法の詳細については、「ack-onepilot コンポーネント」および「MSE マイクロサービスガバナンスコンポーネントのインストールとアップグレード」をご参照ください。
ack-onepilot がインストールされていない場合、クラスターを選択するとシステムによって自動的にインストールされます。「インストールには約 1 分かかります。しばらくお待ちください。」というメッセージが表示されます。
RAM ユーザーを使用していて必要な権限がない場合は、Container Service for Kubernetes コンソールにログインします。ターゲットクラスターの詳細ページに移動します。[コンポーネント管理] をクリックし、[ack-onepilot] を見つけて、[インストール] をクリックします。
ack-onepilot がインストールされている場合、コンソールには「インストール済み」とバージョン番号が表示されます (例: インストール済み 4.2.0)。
説明このステップでインストールされるコンポーネントは ack-onepilot です。Container Service for Kubernetes コンソールにログインし、ターゲットクラスターの詳細ページに移動して、[運用管理] >[コンポーネント管理] を選択して詳細を表示できます。
ack-onepilot がインストールされると、エージェントが自動的に挿入されます。これにより、アプリケーションの起動時間が最大 10 秒増加する可能性があります。
名前空間で接続し、ターゲットクラスターが次のリージョンのいずれにもない場合は、クラスターがインターネットにアクセスして acm.aliyun.com:8080 に接続できることを確認してください: 青島、杭州、北京、上海、上海金融クラウド、深セン、香港 (中国)、シンガポール、フランクフルト、シドニー、シリコンバレー、バージニア。
Access Type
Single Application Access を選択します。
Access Procedure
手順に従います。
ステップ 1: クラスターの [ワークロード] > [デプロイメント] ページに移動し、アプリケーションの名前空間に切り替えます。
ステップ 2: 接続するアプリケーションを見つけて、[YAML で表示] をクリックします。
ステップ 3: 次のフォーマットでラベルを編集し、[更新] をクリックします。
spec: template: metadata: labels: # 接続を有効にするには、値を "on" に設定します。値は二重引用符で囲む必要があります。 msePilotAutoEnable: "on" # 接続先のガバナンス名前空間を指定します。名前空間が存在しない場合は、自動的に作成されます。 mseNamespace: default # MSE に接続するアプリケーションの実際の名前を指定します。名前は二重引用符で囲む必要があります。 msePilotCreateAppName: "your-deployment-name"
結果の検証
上記の手順を完了してアプリケーションを再起動すると、Container Service for Kubernetes および Container Compute Service にデプロイされたアプリケーションに対して MSE マイクロサービスガバナンスが有効になります。
MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、Microservices Governance > Application Governance を選択します。
対応する microservices namespace を選択します。正常に接続されたアプリケーションが表示されます。
次のステップ
アプリケーションが MSE ガバナンスセンターに接続されると、エンドツーエンドカナリアリリース、グレースフル起動とシャットダウン、トラフィックスロットリングなどの機能を使用できます。詳細については、「15 分でサービスガバナンス機能を体験する (Java)」をご参照ください。