将MSE接入注册集群

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

前提条件

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

安装ack-onepilot组件

  1. 登录容器服务管理控制台,在集群列表页面单击目标集群名称。

  2. 在左侧导航栏选择运维管理 > 组件管理,然后通过关键字搜索ack-onepilot

  3. ack-onepilot卡片上单击安装

    说明

    ack-onepilot组件默认支持1000pod规模,集群pod每超过1000个,ack-onepilot资源对应的CPU请增加0.5核、内存请增加512 MB。

  4. 在弹出的页面中可以配置相关的参数,建议使用默认值,单击确定

    说明

    安装完成后,您可以在组件管理页面升级、配置或卸载ack-onepilot组件。

接入流程

说明

关于接入方式选择的建议:

  • 如果您的某个命名空间内的全部应用或者大部分应用需要接入MSE治理中心,建议使用场景一:为ACKACS命名空间中的应用开启MSE微服务治理的方式接入。命名空间内不需要接入的应用需要设置标签:spec.template.labels.msePilotAutoEnable: "off"

  • 如果您的某个命名空间内少部分应用需要接入MSE治理中心,建议使用场景二:为单个应用开启MSE微服务治理的方式接入。

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

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

  1. 登录MSE治理中心控制台,并在顶部菜单栏选择地域。

  2. 在左侧导航栏,选择治理中心 > 应用治理

  3. 应用列表页面,单击ACK应用接入

  4. ACK应用接入对话框中,进行配置,配置完成后,单击确定

    image

    配置项

    说明

    集群类型

    选择ACK集群ACK Serverless集群ACS集群

    说明

    如果您尚未授权容器服务调用微服务引擎,则需要单击请授权进行授权。

    集群名称/ID

    选择接入MSE微服务治理的集群名称/ID,可通过关键词搜索。

    ack-onepilot

    显示ack-onepilot接入状态。

    • 如果您未安装ack-onepilot,单击ack-onepilot右侧的点击安装,安装完成后状态会显示为已安装

    • 如果您使用子账号接入,提示没有权限使用时,您可以登录容器服务管理控制台进入目标集群,然后单击运维管理>组件管理,找到ack-onepilot,点击安装。

    说明
    • 该步骤接入的组件为ack-onepilot,您可以登录容器服务管理控制台进入目标集群,然后单击运维管理>组件管理查看详情。

    • ack-onepilot安装后会自动注入探针,可能会导致应用启动耗时增加(10s内)。

    • 通过命名空间方式接入,如果目标集群所在的Region不在以下范围内,请确保集群能够访问公网且能够连通acm.aliyun.com:8080:青岛、杭州、北京、上海、上海-金融云、深圳、中国香港、新加坡、法兰克福、悉尼、硅谷、弗吉尼亚。

    接入类型

    选择命名空间接入

    容器集群命名空间

    选择容器集群命名空间

    治理命名空间

    选择治理命名空间。在对应命名空间下重新部署现有应用或新创建的应用,均会接入到MSE微服务治理中。关于命名空间的相关信息,请参见微服务命名空间管理

补充说明:

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

    spec:
      template:
        metadata:
          labels:
            mseNamespace: default # 您的应用所在的MSE微服务空间,不填默认为default。
            msePilotCreateAppName: "your-deployment-name" # 替换为您实际使用的应用名称。
  • 如果您想单独为某个应用关闭微服务治理,可以将参数msePilotAutoEnable设置为off

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

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

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

  1. 登录MSE治理中心控制台,并在顶部菜单栏选择地域。

  2. 在左侧导航栏,选择治理中心 > 应用治理

  3. 应用列表页面,单击ACK应用接入

  4. ACK应用接入对话框中,进行配置,配置完成后,单击确定

    image

    配置项

    说明

    集群类型

    选择ACK集群ACK Serverless集群ACS集群

    说明

    如果您尚未授权容器服务调用微服务引擎,则需要单击请授权进行授权。

    集群名称/ID

    选择接入MSE微服务治理的集群名称/ID,可通过关键词搜索。

    ack-onepilot

    显示ack-onepilot接入状态。

    • 如果您未安装ack-onepilot,单击ack-onepilot右侧的点击安装,安装完成后状态会显示为已安装

    • 如果您使用子账号接入,提示没有权限使用时,您可以登录容器服务管理控制台进入目标集群,然后单击运维管理>组件管理,找到ack-onepilot,点击安装。

    说明
    • 该步骤接入的组件为ack-onepilot,您可以登录容器服务管理控制台进入目标集群,然后单击运维管理>组件管理查看详情。

    • ack-onepilot安装后会自动注入探针,可能会导致应用启动耗时增加(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微服务治理。

  1. 登录MSE治理中心控制台,并在顶部菜单栏选择地域。

  2. 在左侧导航栏,选择治理中心 > 应用治理

  3. 选择对应的微服务命名空间,即可看到已经成功接入的应用。