开源K8s环境中的应用接入MSE治理中心

步骤一：安装mse-pilot

MSE微服务治理目前仅支持无状态（Deployment）的应用接入。

1. 执行以下wget命令下载mse-pilot安装包。

    wget 'https://edas-public.oss-cn-hangzhou.aliyuncs.com/mse/mse-pilot-unmanaged.zip' -O mse-pilot-unmanaged.zip

2. 执行以下命令解压mse-pilot安装包。

   unzip mse-pilot-unmanaged.zip                        

3. 执行以下命令安装mse-pilot。
   注意 请确保执行命令之前，您已经将~/.kube/config文件内容替换成需要接入MSE微服务治理的K8s集群的配置。

   kubectl create namespace mse-pilot
   helm install mse-pilot ./mse-pilot-unmanaged --namespace mse-pilot                        

步骤二：获取Licensekey

1. 登录MSE治理中心控制台。
2. 在左侧导航栏选择微服务治理中心 > 应用列表。
3. 在应用列表页面顶部选择华东1（杭州）地域，单击应用接入。
   注意 开源K8s环境中的应用默认接入华东1（杭州）地域，因此您需在华东1（杭州）地域获取License Key。
4. 在接入方式页面的环境类型区域单击ECS集群，然后在第2步 安装 MSE Agent区域复制LicenseKey。
   

步骤三：修改应用的YAML文件

1. 执行以下命令查看目标无状态（Deployment）应用的配置。

   ### 查看指定无状态（Deployment）类型应用的配置
   kubectl get deployment {deployment名称} -o yaml                            

   说明 若您不清楚{deployment名称}，请先执行以下命令查看所有无状态（Deployment）应用，在执行结果中找到目标无状态（Deployment）应用，再查看目标无状态（Deployment）应用的配置。

   ### 查看所有无状态（Deployment）类型应用的配置
   kubectl get deployments --all-namespace                

2. 启动编辑目标无状态（Deployment）应用的YAML文件。

   kubectl edit deployment {Deployment名称} -o yaml                        

3. 在YAML文件中的spec -> template -> metadata -> annotations层级下加入以下内容。

   msePilotAutoEnable: "on"
   msePilotLicenseKey: xxx
   msePilotCreateAppName: xxx                           

   注意 请将xxx分别替换成您的LicenseKey和应用名称，应用名暂不支持中文。
4. 保存配置后，应用将自动重启，以上配置生效。

   2~5分钟后，若您的应用出现在MSE控制台的MSE治理中心 > 应用列表中，包含应用实例，且有数据上报，则说明接入成功。

后续步骤

完成上述步骤后，您就为部署在开源K8s环境中的应用开启了MSE微服务治理。登录MSE治理中心控制台，即可使用MSE微服务治理对您的Spring Cloud和Dubbo应用进行服务治理，详情请参见使用指引。

卸载mse-pilot

当您不再需要治理开源K8s环境中的应用及服务时，可以卸载mse-pilot。

1. 执行以下命令卸载mse-pilot。

   helm del --purge mse-pilot

2. 重启您的应用Pod。