更新时间:2025-08-26 GMT+08:00

管理Sermant Injector插件

容器部署的Spring Cloud应用可通过Sermant Injector插件自动挂载Sermant Agent,通过Sermant Agent接入未开启安全认证的ServiceComb引擎或者注册配置中心。关于Sermant Agent,请参考Sermant-agent使用手册

Spring Cloud Huawei接入方式相比,Sermant Agent接入方式无需修改应用代码即可接入引擎并使用应用注册发现、全链路灰度发布、优雅上下线、标签路由等功能,但是不支持使用微服务治理功能。

请根据您的实际业务需要选择使用Sermant Agent、Spring Cloud Huawei接入方式中的一种将Spring Cloud应用接入ServiceComb引擎专享版或者注册配置中心。但不可同时使用,以免导致冲突。

在使用Sermant Agent接入方式将Spring Cloud应用接入ServiceComb引擎专享版或者注册配置中心前,您需要先安装Sermant Injector插件插件。

前提条件

  • 待操作环境中已绑定1.15以上版本的CCE集群,请参考绑定集群
  • 已绑定的CCE集群如果已存在cse命名空间,则该命名空间不能存在名为sermant-injector的配置项、名为sermant-injector-secret的密钥、名为sermant-injector的工作负载或者名为sermant-injector的服务(Service),否则会导致插件安装失败。
  • 环境中已纳管未开启安全认证的注册配置中心或者2.4.0及以上版本的ServiceComb引擎专享版,请参考纳管基础资源

安装Sermant Injector插件

  1. 登录ServiceStage控制台
  2. 选择“环境管理”,进入“环境管理”页面。
  3. 单击待操作环境名称,进入环境“概览”页面。
  4. 选择“插件管理”
  5. 选择“插件”下的“Sermant Injector”插件。

    • 非高可用环境,单击“立即安装”,然后执行6
    • 高可用环境,请先选择待安装Sermant Injector插件的CCE集群所在的可用区,单击“立即安装”,然后执行6

  6. 参考下表设置安装参数。

    参数

    参数说明

    选择CCE集群

    默认选择当前环境下已绑定的CCE集群。

    机器类型

    选择和已选择的CCE集群master节点相同的CPU架构。

    • x86_64
    • AArch64

    选择关联的微服务引擎

    选择待安装插件的ServiceComb引擎专享版或者注册配置中心。

  7. 单击“确定”

    • Sermant Injector插件安装成功后,会创建如下表所示内容。

      名称

      说明

      命名空间

      6选择的CCE集群,创建名为cse的命名空间。

      说明:

      如果6选择的CCE集群已存在名为cse命名空间,安装Sermant Injector插件时,会复用该命名空间。

      配置项

      6选择的CCE集群的cse命名空间下,创建名为sermant-injector的配置项。

      密钥

      6选择的CCE集群的cse命名空间下,创建名为sermant-injector-secret的密钥。

      工作负载

      6选择的CCE集群的cse命名空间下,创建名为sermant-injector的工作负载。

      服务

      6选择的CCE集群的cse命名空间下,创建名为sermant-injector的服务(Service)。

    • Sermant Injector插件安装失败,请参考重新安装Sermant Injector插件重试。
    • 已安装了Sermant Injector插件的CCE集群,如果被其他环境绑定,则其他环境下需同时纳管该Sermant Injector插件所关联的ServiceComb引擎专享版或者注册配置中心。否则,会导致其他环境下Sermant Injector插件不可用。

      纳管ServiceComb引擎专享版,请参考纳管基础资源

升级Sermant Injector插件版本

已安装的Sermant Injector插件版本低于当前最新版本时,您可以升级插件到当前最新版本。

升级Sermant Injector负载过程中无法挂载Sermant Agent,可能会导致在此期间重启的服务实例接入ServiceComb引擎或者注册配置中心失败。

  1. 登录ServiceStage控制台
  2. 选择“环境管理”,进入“环境管理”页面。
  3. 单击待操作环境名称,进入环境“概览”页面。
  4. 选择“插件管理”
  5. 选择“插件”下的“Sermant Injector”插件。

    • 非高可用环境:单击“升级”
    • 高可用环境:选择待升级Sermant Injector插件的CCE集群所在的可用区页签,单击“升级”

  6. 在弹出对话框,单击“确定”

重启Sermant Injector负载

您可以根据实际业务需要,重新启动Sermant Injector负载。

重新启动Sermant Injector负载过程中无法挂载Sermant Agent,可能会导致在此期间重启的服务实例接入ServiceComb引擎或者注册配置中心失败。

  1. 登录ServiceStage控制台
  2. 选择“环境管理”,进入“环境管理”页面。
  3. 单击待操作环境名称,进入环境“概览”页面。
  4. 选择“插件管理”
  5. 选择“插件”下的“Sermant Injector”插件。

    • 非高可用环境,单击“重启”
    • 高可用环境,选择待重启Sermant Injector插件的CCE集群所在的可用区页签,单击“重启”

  6. 在弹出对话框,单击“确定”

重新安装Sermant Injector插件

安装Sermant Injector失败后,可以执行本操作重新安装。

  1. 登录ServiceStage控制台
  2. 选择“环境管理”,进入“环境管理”页面。
  3. 单击待操作环境名称,进入环境“概览”页面。
  4. 选择“插件管理”
  5. 选择“插件”下的“Sermant Injector”插件。

    • 非高可用环境:单击“重新安装”
    • 高可用环境:选择Sermant Injector插件安装失败的CCE集群所在的可用区页签,单击“重新安装”

删除Sermant Injector插件

删除已安装的Sermant Injector插件后,会导致无法使用Sermant Agent将微服务实例接入ServiceComb引擎或者注册配置中心。

删除Sermant Injector插件,会删除如下表所示的内容。

名称

说明

配置项

安装Sermant Injector插件时选择的CCE集群cse命名空间下创建的名为sermant-injector的配置项。关于配置项,请参考管理配置项

密钥

安装Sermant Injector插件时选择的CCE集群cse命名空间下创建的名为sermant-injector-secret的密钥。关于密钥,请参考管理密钥

工作负载

安装Sermant Injector插件时选择的CCE集群cse命名空间下创建的sermant-injector插件工作负载。关于工作负载,请参考。

服务

安装Sermant Injector插件时选择的CCE集群cse命名空间下创建的sermant-injector服务(Service)。关于Service,请参考。

  1. 登录ServiceStage控制台
  2. 选择“环境管理”,进入“环境管理”页面。
  3. 单击待操作环境名称,进入环境“概览”页面。
  4. 选择“插件管理”
  5. 选择“插件”下的“Sermant Injector”插件。

    • 非高可用环境:单击“删除”
    • 高可用环境:选择待删除Sermant Injector插件的CCE集群所在的可用区页签,单击“删除”

  6. 单击“确定”,完成删除。