ServiceComb应用如何接入华为云微服务引擎CSE

ServiceComb应用接入CSE

CSE Java SDK 100% 兼容 ServiceComb Java Chassis,并对其进行更加友好的封装,更加专注于业务逻辑,以简化用户业务开发。将ServiceComb Java Chassis部署到CSE,并使用CSE提供的能力,只需要对microservice.yaml进行适当的配置,以及在pom中添加额外的依赖,不涉及任何代码修改。

  • microservice.yaml

    {project}/src/main/resources/microservice.yaml

     说明:

    microservice.yaml中默认配置服务中心、配置中心、仪表盘地址为公有云地址,其他合营云请根据实际情况配置。

  • pom.xml

    {project}/pom.xml

一键式配置

公有云版本提供了一键式简化配置的方式,让基于开源版本开发的应用快速切换为云上应用,直接使用公有云提供的灰度发布、服务治理等功能。

增加和管理依赖关系(pom.xml) 增加依赖管理

<dependencyManagement>       
    <dependencies>           
        <dependency>               
            <groupId>com.huawei.paas.cse</groupId>               
            <artifactId>cse-dependency</artifactId>               
            <version>2.3.20</version>               
            <type>pom</type>               
            <scope>import</scope>           
        </dependency>       
    </dependencies>   
</dependencyManagement>
并引入依赖
<dependency>
    <groupId>com.huawei.paas.cse</groupId>
    <artifactId>cse-solution-service-engine</artifactId>
</dependency>

开发者只需要配置对cse-solution-service-engine依赖,就完成了公有云的所有配置。这个依赖关系主要给开发者做了如下事情:

  • 引入相关依赖的组件。
  • 增加默认配置项。默认配置包含了处理链、负载均衡策略等。

    可以通过查看pom内容,以及这个jar包里面的microservice.yaml文件查看引入的组件和增加的配置项。在下面的章节中,详细解释上云增加的组件以及他们的作用,使开发者更加深入的了解各种技术细节。

配置应用AK/SK密钥

微服务连接公有云上的CSE服务中心、配置中心、仪表盘时,需要提供AK/SK秘钥信息,否则无法通过认证。

  1. 若应用通过在已有集群内创建应用(创建应用、云上工程)的方式,CSE将自动从应用所在集群获取认证信息,无需配置AKSK密钥信息,请跳过步骤2-3。
  2. 获取AK/SK方式

    1. 注册并登录管理控制台
    2. 单击右上角用户名,进入“基本信息”页面。
    3. 单击“管理我的凭证”。
    4. 进入“管理访问密钥”页签,单击“新增访问密钥”,进入“新增访问密钥”页面。
    5. 输入登录密码、短信或者邮箱验证码,单击“确定”,下载密钥,请妥善保管。

  3. 配置项。

    cse:
      credentials:
        accessKey: ak  #结合用户实际值ak和加解密扩展进行配置
        secretKey: sk  #结合用户实际值sk和加解密扩展进行配置
        akskCustomCipher: default  #用户扩展解密com.huawei.paas.foundation.auth.credentials.AKSKCipher的实现类的name值, 默认default表示明文,无须加解密

    该配置项配置了应用的AK/SK密钥信息,为了信息的安全,请用户对AK/SK密钥加密后进行配置。扩展AK/SK解密方式请参考如何扩展AK/SK解密方式

连接服务中心

  • 功能描述

    服务中心实现注册和发现,在公有云查看微服务目录,都需要微服务连接上服务中心。

  • 配置参考
    • 增加依赖关系(pom.xml)

      如果连接服务中心使用https协议或AK/SK认证,该jar依赖必选。如果是http协议,并不包含token验证,则无需引入。

      <dependency>
          <groupId>com.huawei.paas.cse</groupId>
          <artifactId>foundation-auth</artifactId>
      </dependency>
    • 启用配置(microservice.yaml)
      cse:
        service:
          registry:
            address:  https://cse.cn-north-1.myhwclouds.com:443   #根据实际地址配置服务中心地址

      该配置项配置了服务中心的地址。其中,address可以在公有云“应用开发 > 微服务开发 > 工具下载”页面查到对应的服务中心地址,修改协议(http/https)、主机名(可能使用域名)和端口号。

连接配置中心

  • 功能描述

    配置中心实现配置下发,连接配置中心是使用治理、灰度发布等功能的前提。

  • 配置参考
    • 增加依赖关系(pom.xml)

      如果连接配置中心使用https协议或AK/SK认证,该jar依赖必选。如果是http协议,并不包含token验证,则无需引入。

      <dependency>
          <groupId>com.huawei.paas.cse</groupId>
          <artifactId>foundation-auth</artifactId>
      </dependency>

      连接配置中心该jar必选

      <dependency>
          <groupId>org.apache.servicecomb</groupId>
          <artifactId>config-cc</artifactId>
      </dependency>
    • 启用配置(microservice.yaml)
      cse:
        config:
          client:
            serverUri:  https://cse.cn-north-1.myhwclouds.com:443

      该配置项配置了配置中心的地址。其中,serverUri可以在公有云“应用开发 > 微服务开发 > 工具下载”页面查到对应配置中心地址,修改协议(http/https)、主机名(可能使用域名)和端口号。

使用服务治理

  • 功能描述

    服务治理主要涉及熔断、容错、限流、负载均衡等。

  • 配置参考

    配置项(microservice.yaml)

    需要增加下面治理相关的handler。

    cse:
      handler:
        chain:
          Provider:
            default: bizkeeper-provider,qps-flowcontrol-provider
          Consumer:
            default: bizkeeper-consumer,loadbalance,qps-flowcontrol-consumer

使用故障注入

  • 功能描述

    故障注入主要提供了延时、错误两种类型故障。

  • 配置参考

    配置项(microservice.yaml)

    需要增加下面治理相关的handler。

    cse:
     handler:
      chain:
       Consumer:
        default: loadbalance,fault-injection-consumer

使用灰度发布

  • 功能描述

    该功能对应于微服务目录灰度发布功能。管理员可以通过下发规则,对服务进行灰度发布管理。

  • 配置参考
    • 增加依赖关系(pom.xml)
      引入jar包。
      <dependency>
          <groupId>com.huawei.paas.cse</groupId>
          <artifactId>cse-handler-cloud-extension</artifactId>
      </dependency>
    • 在Consumer端配置负载均衡(microservice.yaml)
      在负载均衡模块启用灰度发布的filter。
      cse: 
        loadbalance:
          serverListFilters: darklaunch
          serverListFilter:
            darklaunch:
              className: com.huawei.paas.darklaunch.DarklaunchServerListFilter

使用调用链

  • 功能描述

    公有云提供了业务无侵入的埋点功能APM。只需要通过公有云部署容器应用,并选择启用调用链监控功能,即可使用调用链服务。

使用仪表盘

  • 功能描述

    微服务可以将自己的运行数据上报给Dashboard服务,在公有云上查看仪表盘数据、分布式事务数据等。该章节是描述如何启用微服务数据上报功能。

  • 配置参考
    • 增加依赖关系(pom.xml)
      引入jar包。
      <dependency>
          <groupId>com.huawei.paas.cse</groupId>
          <artifactId>cse-handler-cloud-extension</artifactId>
      </dependency>
    • 配置handler

      仪表盘数据依赖于两个handler,一个bizkeeper-provider(客户端为bizkeeper-consumer),一个perf-stats,所以对应的pom依赖需要先引入。

      cse:  
        handler:
          chain:
            Provider:
              default: bizkeeper-provider,perf-stats,tracing-provider,sla-provider
            Consumer:
              default: bizkeeper-consumer,loadbalance,perf-stats,tracing-consumer,sla-consumer
    • 配置上报monitor地址
      TenantLB_ADDRESS为公有云接入地址,默认是100.125.1.34。
      cse:
        monitor:
          client:
            serverUri:  https://cse.cn-north-1.myhwclouds.com:443

      该配置项配置了仪表盘上报地址。其中,serverUri可以在公有云“应用开发 > 微服务开发 > 工具下载”页面查到对应的仪表盘上报地址,修改协议(http/https)、主机名(可能使用域名)和端口号。

使用分布式事务TCC

  • 功能描述

    主要实现基于TCC协议的分布式服务间的最终一致性方案,保障一般场景下的应用一致性需求,并可以在CSE分布式事务界面查看事务详细信息。

  • 配置参考

    增加依赖关系(pom.xml)

    引入jar包。

    <dependency>
        <groupId>com.huawei.paas.cse</groupId>
        <artifactId>cse-handler-tcc</artifactId>
    </dependency>

    需要增加下面事务相关的handler,才能实时上报分布式事务数据。

    cse:
      handler:
        chain:
          Provider:
            default: tcc-server,bizkeeper-provider
          Consumer:
            default: tcc-client,bizkeeper-consumer,loadbalance
阅读更多
文章标签: servicecomb cse
个人分类: 技术剖析
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭