通过模板管理页面部署Sermant Injector将应用接入ServiceComb引擎

接入流程

通过模板管理页面部署Sermant Injector将应用接入ServiceComb引擎流程如下：

通过模板管理页面部署Sermant Injector将应用接入ServiceComb引擎

1. 上传Sermant Injector模板。
   1. 下载模板。

      Sermant Injector模板版本及下载地址如下表所示：

      Sermant Injector版本	Sermant Agent镜像版本	Sermant Agent开源版本	发行时间	获取路径
      1.0.11	1.0.9	1.0.6	2023.10.31	sermant-injector-1.0.11.tgz

   2. 上传模板。

      登录CCE的控制台，进入集群，在左侧导航栏中选择“模板管理”，单击右上角的“上传模板”，单击“添加文件”，选择已下载的模板包。具体操作请参考上传模板。

   

   如果您的Sermant Injector版本低于1.0.11，您还需要在上传Sermant Injector模板之前进行以下准备工作：

   第一次启动Sermant Injector应用之前，需申请Sermant Injector https证书。

   1. 登录已安装kubectl命令的CCE节点。

      请参考Linux弹性云服务器登录方式概述选择相应方式登录CCE节点。

   2. 登录后，请在已安装kubectl命令的CCE节点中执行以下命令申请Sermant Injector https证书：

      wget -O- https://cse-bucket-cn-east-3.obs.cn-east-3.myhuaweicloud.com/javaagent/certificate.sh | sh

      • 该步骤会把证书挂载到cse命名空间中，如果不存在cse命名空间，则会自动创建。
      • 该步骤会向k8s集群申请名为sermant-injector.cse.svc的CertificateSigningRequest，如果之前存在，则会被覆盖。
      • 该步骤会在cse命名空间中创建名为sermant-injector-secret的Secret，如果之前存在，则会被覆盖。
      • 使用Sermant Injector时，如果提示证书失效等证书相关的错误，请重新申请证书并重新安装Sermant Injector实例。

2. 安装Sermant Injector实例。

   登录CCE控制台，进入集群，在左侧导航栏中选择“模板管理”，在已上传的Sermant Injector模板中，单击“安装”，具体操作请参考创建模板实例。关于模板的更多操作请参考通过模板部署应用 。

   安装时，按需修改配置文件，配置说明如下：

   agent:
     image:
       # 选填配置，Sermant Agent镜像版本，默认为最新版本。
       version: ${agent.version}
   cse:
     config:
       # 必填配置，ServiceComb引擎配置中心地址，获取方式可参考获取ServiceComb引擎配置中心地址。
       endpoints: https://localhost:30110
     registry:
       # 必填配置，注册中心类型，当前支持SERVICE_COMB/NACOS
       type: SERVICE_COMB
       # 必填配置，ServiceComb引擎注册中心地址，获取方式可参考获取ServiceComb引擎注册发现地址。
       endpoints: https://localhost:30100
   image:
     # 选填配置，镜像拉取策略：Always(总是拉取)/IfNotPresent(本地有则使用本地镜像,不拉取)/Never(只使用本地镜像，从不拉取)
     pullPolicy: IfNotPresent
     # 必填配置，CCE所在的region，默认为cn-east-3（华东-上海一），具体请参考地区和终端节点。
     region: cn-east-3
   injector:
     image:
       # 选填配置，injector镜像版本，默认为最新版本。
       version: ${injector.version}
       # 选填配置，拉取镜像的密钥。
       pullSecrets: default-secret
       # 选填配置，injector实例数，若CCE集群只有一个节点，则需配置为1。
       replicas: 2

   

   如果您的Sermant Injector版本低于1.0.11，还需在”injector”节点下，配置“webhooks > caBundle”的值，该值需要在已安装kubectl命令的CCE节点中使用以下命令获取：

   kubectl config view --raw --minify --flatten -o jsonpath='{.clusters[].cluster.certificate-authority-data}'

3. 修改需要接入ServiceComb引擎的应用部署文件。
   • 若是新建的应用需要在“创建无状态工作负载”高级设置页面单击界面右侧的“YAML创建”，具体请参考通过控制台创建无状态负载。
   • 若是已经部署的应用需要在左侧导航栏中选择“工作负载 > 无状态负载 Deployment”，然后单击应用所属工作负载后的“更多 > 编辑YAML”，具体请参考编辑YAML。

   在YAML文件中的“spec > template > metadata > labels”层级下加入内容：sermant-injection: enabled。

   

   

   • 新建的应用在启动时会自动挂载Sermant Agent。
   • 已经部署的应用在修改YAML后会自动重启并挂载Sermant Agent。

4. 验证应用接入ServiceComb引擎。

   参考查看微服务列表查看您的应用（服务名为spring.application.name配置的值）是否已接入ServiceComb引擎。