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

文档中心 > 聚石塔

前言

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

1、创建集群

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

image

2、开通服务网格

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

image

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

image

  • 填写注册信息

image

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

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

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

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

3、创建应用

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

image

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

image

4、服务网格注册中心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.2.10</version>
</dependency>

5、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”);

6、常见接入问题错误

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)能力注意事项:
1. 分组和版本名称不能是特殊值 * 和 0.0.0 。一般用户不会使用特殊值。
2. 同一个接口服务提供方发布,分组名和版本名称不能相同。
二、dubbo 2.7.0及以上版本,强依赖zookeeper配置中心连接问题
1. 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"/>

7、应用发布

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

image

查看发布成功的微服务

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

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

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

FAQ

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