更新时间:2024-08-16 GMT+08:00
分享

通过模板管理页面部署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引擎。

相关文档