如何将MSE接入注册集群应用中_容器服务 Kubernetes 版 ACK(ACK)-阿里云帮助中心

微服务引擎MSE（Microservice Engine）是一个面向业界主流开源微服务框架Spring Cloud和Dubbo一站式微服务平台，提供治理中心、托管的注册中心和托管的配置中心。本文介绍如何将MSE接入注册集群应用中。

前提条件

您已通过容器服务Kubernetes版接入一个Kubernetes集群。具体操作，请参见通过控制台创建注册集群。

安装ack-onepilot组件

登录容器服务管理控制台。
在左侧导航栏单击集群，然后在集群列表页面单击目标集群名称。
在左侧导航栏选择运维管理 > 组件管理，然后在右上角通过关键字搜索ack-onepilot。
在ack-onepilot卡片上单击安装。
说明
ack-onepilot组件默认支持1000个pod规模，集群pod每超过1000个，ack-onepilot资源对应的CPU请增加0.5核、内存请增加512 M。
在弹出的页面中可以配置相关的参数，建议使用默认值，单击确定。
说明
安装完成后，您可以在组件管理页面升级、配置或卸载ack-onepilot组件。

参数	说明
image	ack-onepilot组件镜像地址。如果您是通过公网注册的外部集群，需要删除镜像参数中的VPC。例如，镜像参数为`registry-vpc.cn-beijing.aliyuncs.com/ack-onepilot/ack-onepilot`，删除VPC后的镜像参数为`registry.cn-beijing.aliyuncs.com/ack-onepilot/ack-onepilot`。
AccessKey	您的阿里云AccessKeyId。AccessKey需要包含MSE访问权限。具体操作，请参见为集群授予MSE治理中心的访问权限。
AccessKeySecret	您的阿里云AccessKeySecret。

安装ack-onepilot组件大约需要2分钟，请耐心等待。

创建成功后，会自动跳转到目标集群的Helm页面，检查安装结果。若所有资源创建成功，则说明组件安装成功。

接入流程

场景一：为ACK命名空间中的应用开启MSE微服务治理

为命名空间下开启MSE微服务治理后，该命名空间下的Pod都会接入到MSE微服务治理中，您无需再手动逐个接入。

登录MSE治理中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择治理中心 > 应用治理。
在应用列表页面，单击ACK应用接入。

在ACK应用接入对话框中，进行配置，配置完成后，单击确定。

配置项	说明
集群类型	选择ACK集群或者ACK Serverless集群。说明如果您尚未授权容器服务调用微服务引擎，则需要单击请授权进行授权。
集群名称/ID	选择接入MSE微服务治理的集群名称/ID，可通过关键词搜索。
ack-onepilot	显示ack-onepilot接入状态。如果您未安装ack-onepilot，单击ack-onepilot右侧的点击安装，安装完成后状态会显示为已安装。说明该步骤接入的组件为ack-onepilot，您可以登录容器服务管理控制台进入目标集群，然后单击运维管理>组件管理查看详情。 ack-onepilot安装后会自动注入Agent，可能会导致应用启动耗时增加（10s内）。
接入类型	选择命名空间接入。
容器集群命名空间	选择容器集群命名空间。
治理命名空间	选择治理命名空间。在对应命名空间下重新部署现有应用或新创建的应用，均会接入到MSE微服务治理中。关于命名空间的相关信息，请参见微服务命名空间管理。

补充说明：

默认接入的应用名称为Deployment名字，如果您需要修改接入MSE的应用名称，可通过编辑应用的YAML文件进行修改。

spec:
  template:
    metadata:
      labels:
        mseNamespace: default # 您的应用所在的MSE微服务空间，不填默认为default。
        msePilotCreateAppName: "<yourAppName>" # 替换为您实际使用的应用名称。

如果您想单独为某个应用关闭微服务治理，可以将参数msePilotAutoEnable设置为off。

spec:
  template:
    metadata:
      labels:
        msePilotAutoEnable: "off" # 这个字段的"off"必须加上双引号或者单引号。

场景二：为单个应用开启MSE微服务治理

如果您的命名空间下只有少量应用需要接入MSE微服务治理，您可以逐个应用接入MSE微服务治理。

登录MSE治理中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择治理中心 > 应用治理。
在应用列表页面，单击ACK应用接入。

在ACK应用接入对话框中，进行配置，配置完成后，单击确定。

配置项	说明
集群类型	选择ACK集群或者ACK Serverless集群。说明如果您尚未授权容器服务调用微服务引擎，则需要单击请授权进行授权。
集群名称/ID	选择接入MSE微服务治理的集群名称/ID，可通过关键词搜索。
ack-onepilot	显示ack-onepilot接入状态。如果您未安装ack-onepilot，单击ack-onepilot右侧的点击安装，安装完成后状态会显示为已安装。说明该步骤接入的组件为ack-onepilot，您可以登录容器服务管理控制台进入目标集群，然后单击运维管理>组件管理查看详情。 ack-onepilot安装后会自动注入Agent，可能会导致应用启动耗时增加（10s内）。
接入类型	选择单个应用接入。
接入步骤	按照接入步骤进行操作。 Step 1:进入集群工作负载-无状态应用页面，切换到应用的命名空间下。 Step 2:找到所接入的应用，点击「查看Yaml」。 Step 3:按以下格式编辑Labels，完成后点击「更新」。 `spec: template: metadata: labels: # 填写“on”表示开启接入，需加上双引号 msePilotAutoEnable: "on" # 填写接入到的治理命名空间，值不存在可自动新建 mseNamespace: 202401 # 填写接入MSE的实际应用名称，需加上双引号 msePilotCreateAppName: "your-deployment-name"`

结果验证

完成上述步骤并重启应用后，部署在容器服务 Kubernetes 版中的应用就成功开启了MSE微服务治理。

登录MSE治理中心控制台，并在顶部菜单栏选择地域。
在左侧导航栏，选择治理中心 > 应用治理。
选择对应的微服务命名空间，即可看到已经成功接入的应用。