注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 聚石塔

一、前言


集群开通服务网格,总共包含以下几个部分:1)创建集群;2)开通服务网格;3)创建应用;4)应用引入服务网格注册中心jar包; 5)应用发布。


二、创建集群


路径:运维中心-容器集群。


image.png


三、开通服务网格


路径:中间件-服务网格 寻找开通状态为未开通的集群。


image.png


如果用户已有自建注册中心情况,请选择“已有注册中心”,服务网格注册中心会自动同步自建注册中心服务信息。


image.png


填写注册信息。


image.png


注册中心类型:目前支持eureka、zookeeper。

注册中心入口地址:请从应用的配置文件里直接拷贝注册中心配置地址信息即可。

鉴权方式:eureka支持httpbase鉴权方式、zookeeper支持digset鉴权方式。

用户也可以直接选择使用“服务网格注册中心”,无需填写注册中心信息,直接开通即可。


四、创建应用


路径:应用管理-创建应用。


image.png


填写应用基本信息,并勾选服务网格。


image.png


五、服务网格注册中心sdk接入


1)在项目根pom.xml加入注册中心商业版maven中央仓库地址。


<repositories>
  <repository>
    <id>alipay-cloud-server@public</id>
    <url>http://mvn.cloud.alipay.com/nexus/content/groups/open</url>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
</repositories>


2) 引入注册中心sdk


<dependency>
     <groupId>com.alipay.sofa</groupId>
     <artifactId>sofa-registry-cloud-all</artifactId>
     <version>1.3.0</version>
</dependency>


六、tracer sdk接入


描述:接入tracer sdk,可以提供应用服务的实时监控(服务耗时、调用量、错误率、CPU、内存监控等)、服务拓扑能力。


1. Spring cloud应用


Spring Cloud 1.X 版本


<!-- 支持服务调用tracer日志记录能力 -->
<!-- for Spring Boot 1.X -->
<dependency>
  <groupId>com.alipay.sofa</groupId>
  <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
  <version>2.3.7.JST.1</version>
  <exclusions>
    <exclusion>
      <groupId>com.alipay.sofa.common</groupId>
      <artifactId>sofa-common-tools</artifactId>
    </exclusion>
    <exclusion>
      <groupId>com.alipay.sofa</groupId>
      <artifactId>tracer-enterprise-dst-plugin</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>com.alipay.sofa.common</groupId>
  <artifactId>sofa-common-tools</artifactId>
  <version>1.0.17</version>
</dependency>


Spring Cloud 2.X 版本


<!-- 接入tracer -->
<!-- for Spring Boot 1.X -->
<dependency>
  <groupId>com.alipay.sofa</groupId>
  <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
  <version>3.2.3.JST.1</version>
  <exclusions>
    <exclusion>
      <artifactId>sofa-common-tools</artifactId>
      <groupId>com.alipay.sofa.common</groupId>
    </exclusion>
    <exclusion>
      <groupId>com.alipay.sofa</groupId>
      <artifactId>tracer-enterprise-dst-plugin</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>com.alipay.sofa.common</groupId>
  <artifactId>sofa-common-tools</artifactId>
  <version>1.0.17</version>
</dependency>


2. Dubbo应用


Spring Boot 1.X + Dubbo 应用


<!-- for Spring Boot 1.X -->
<dependency>
  <groupId>com.alipay.sofa</groupId>
  <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
  <version>2.3.7.JST.1</version>
  <exclusions>
    <exclusion>
      <groupId>com.alipay.sofa.common</groupId>
      <artifactId>sofa-common-tools</artifactId>
    </exclusion>
    <exclusion>
      <groupId>com.alipay.sofa</groupId>
      <artifactId>tracer-enterprise-dst-plugin</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>com.alipay.sofa.common</groupId>
  <artifactId>sofa-common-tools</artifactId>
  <version>1.0.17</version>
</dependency>


Spring Boot 2.x + Dubbo 应用


<!-- for Spring Boot 2.X -->
<dependency>
  <groupId>com.alipay.sofa</groupId>
  <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
  <version>3.2.3.JST.1</version>
  <exclusions>
    <exclusion>
      <artifactId>sofa-common-tools</artifactId>
      <groupId>com.alipay.sofa.common</groupId>
    </exclusion>
    <exclusion>
      <groupId>com.alipay.sofa</groupId>
      <artifactId>tracer-enterprise-dst-plugin</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>com.alipay.sofa.common</groupId>
  <artifactId>sofa-common-tools</artifactId>
  <version>1.0.17</version>
</dependency>


非 Spring Boot 的 Dubbo 应用


<dependency>
  <groupId>com.alipay.sofa</groupId>
  <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
  <version>3.2.3.JST.1</version>
  <exclusions>
    <exclusion>
      <artifactId>sofa-common-tools</artifactId>
      <groupId>com.alipay.sofa.common</groupId>
    </exclusion>
    <exclusion>
      <groupId>com.alipay.sofa</groupId>
      <artifactId>tracer-enterprise-dst-plugin</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>com.alipay.sofa.common</groupId>
  <artifactId>sofa-common-tools</artifactId>
  <version>1.0.17</version>
</dependency>


需要手动初始化, 在main方法第一行

SofaTracerConfiguration.setProperty(SofaTracerConfiguration.JSON_FORMAT_OUTPUT, “false”);


七、常见接入问题错误


1. 更新开发环境mirror配置

如果本地maven settings.xml(默认路径 ~/.m2/settings.xml )配置了mirror为 * , 需要排除 alipay-cloud-server@public 仓库托管:


<mirror>
    <id>nexus-aliyun</id>
    <!-- <mirrorOf>*</mirrorOf> -->
    <mirrorOf>*,!alipay-cloud-server@public</mirrorOf>
    <name>Nexus aliyun</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>


2. 如果遇到meshReigstry override冲突报错,请在项目配置文件加入以下配置:


spring.main.allow-bean-definition-overriding=true


3. eureka配置问题


eureka应用云原生化后,服务注册默认获取到的是hostname,可能导致消费方调用失败,建议应用增加配置:


eureka.instance.preferIpAddress=true


4. dubbo应用注意事项


① 如果使用了dubbo框架服务分组(group)和版本(version)能力注意事项:

i)分组和版本名称不能是特殊值 * 和 0.0.0 。一般用户不会使用特殊值。

ii)同一个接口服务提供方发布,分组名和版本名称不能相同。


② dubbo 2.7.0及以上版本,强依赖zookeeper配置中心连接问题

2.7.0 =< dubbo版本 <= 2.7.4, 强依赖了zk配置中心。接入了mesh后,dubbo依然会和用户配置zk建立tcp连接,如果不期望依赖zk,建议升级dubbo版本>= 2.7.5, 该版本提供了关闭配置中心开关(use-as-config-center),使用示例:


<dubbo:registry address="zookeeper://127.0.0.1:2181" use-as-config-center="false"/>


八、应用发布


路径:应用发布-测试/正式环境-新建发布单。


image.png


查看发布成功的微服务

路径:中间件-服务网格。


九、服务网格应用退回到普通应用


路径:应用-设置-编辑-取消勾选【服务网格】,然后重新发布应用。


FAQ

关于此文档暂时还没有FAQ
返回
顶部