动态路由

服务提供者

项目初始化

使用 jetbrain idea 等工具初始化一个 maven 项目

引入依赖

在上一步初始化好一个 maven 项目之后，我们在 pom.xml 中引入 Spring Cloud Tencent 相关依赖。

引入 spring-cloud-tencent-dependencies 进行管理 Spring Cloud Tencent 相关组件的依赖版本。
引入 spring-cloud-starter-tencent-polaris-discovery 实现 Spring Cloud 服务注册到北极星中。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.9</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    ...

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.tencent.cloud</groupId>
                <artifactId>spring-cloud-tencent-dependencies</artifactId>
                <version>1.7.0-2021.0.3</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>2021.0.3</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <!-- 简单的 Spring Cloud Web 依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- 引入 Spring Cloud Tencent 的服务注册发现依赖 -->
        <dependency>
            <groupId>com.tencent.cloud</groupId>
            <artifactId>spring-cloud-starter-tencent-polaris-discovery</artifactId>
        </dependency>
    </dependencies>

    ...

</project>

配置 application.yml

在 resources 目录下创建 application.yml 文件，并按照如下进行配置

.
├── java
│   └── com
│       └── example
│           └── springcloudpolarisquickstart
│               └── SpringCloudProviderApplication.java
└── resources
    └── application.yml

配置 application.yml

server:
  port: 28888
spring:
  application:
    name: RouterEchoServer

  cloud:
    tencent:
      metadata:
        content:
          env: dev1

    polaris:
      namespace: default # 设置注册中心命名空间
      discovery:
        enabled: true
      stat:
        enabled: true
        port: 28082
      address: grpc://127.0.0.1:8091

示例代码

@SpringBootApplication
public class SpringCloudProviderApplication {

    @RestController
    static class EchoController {

        private final PolarisDiscoveryProperties properties;

        EchoController(PolarisDiscoveryProperties properties) {
            this.properties = properties;
        }

        @GetMapping(value = "/echo/{string}")
        public String echo(@PathVariable String string) {
            return "Hello PolarisMesh " + string + ", I'm " + properties.getService() + ":" + properties.getPort();
        }
    }

    public static void main(String[] args) {
        SpringApplication.run(SpringCloudProviderApplication.class, args);
    }
}

运行

执行 mvn clean install 构建出 jar 运行包
按照以下命令启动两个服务提供者进程

启动第一个服务提供者

java  -Dspring.cloud.tencent.metadata.content.env=dev1 -Dserver.port=20001 -Dspring.cloud.polaris.stat.port=21001 -jar xxx.jar

启动第二个服务提供者

java  -Dspring.cloud.tencent.metadata.content.env=dev2 -Dserver.port=20002 -Dspring.cloud.polaris.stat.port=21002 -jar xxx.jar

确认实例注册情况

执行以下命令，查看该服务下的实例信息

curl --location --request POST '127.0.0.1:8090/v1/Discover' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": 1,
    "service": {
        "name": "RouterEchoServer",
        "namespace": "default"
    }
}'

服务调用者

项目初始化

使用 jetbrain idea 等工具初始化一个 maven 项目

引入依赖

在上一步初始化好一个 maven 项目之后，我们在 pom.xml 中引入 Spring Cloud Tencent 相关依赖。

引入 spring-cloud-tencent-dependencies 进行管理 Spring Cloud Tencent 相关组件的依赖版本。
引入 spring-cloud-starter-tencent-polaris-discovery 实现 Spring Cloud 服务注册到北极星中。
引入 spring-cloud-starter-tencent-polaris-router 实现 Spring Cloud 的服务路由。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.9</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    ...
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.tencent.cloud</groupId>
                <artifactId>spring-cloud-tencent-dependencies</artifactId>
                <version>1.7.0-2021.0.3</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>2021.0.3</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <!-- 简单的 Spring Cloud Web 依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- 引入 Spring Cloud Tencent 的服务注册发现依赖 -->
        <dependency>
            <groupId>com.tencent.cloud</groupId>
            <artifactId>spring-cloud-starter-tencent-polaris-discovery</artifactId>
        </dependency>
        <!-- 引入 Spring Cloud Tencent 的服务路由依赖 -->
        <dependency>
            <groupId>com.tencent.cloud</groupId>
            <artifactId>spring-cloud-starter-tencent-polaris-router</artifactId>
        </dependency>
    </dependencies>
    ...
</project>

配置 application.yml

在 resources 目录下创建 application.yml 文件，并按照如下进行配置

.
├── java
│   └── com
│       └── example
│           └── springcloudpolarisquickstart
│               └── SpringCloudConsumerApplication.java
└── resources
    └── application.yml

配置 application.yml

server:
  port: 38888
spring:
  application:
    name: RouterEchoConsumer
  cloud:
    polaris:
      namespace: default # 设置注册中心命名空间
      address: grpc://127.0.0.1:8091
      discovery:
        enabled: true
      stat:
        enabled: true
        port: 38082

示例代码

@SpringBootApplication
public class SpringCloudConsumerApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringCloudConsumerApplication.class, args);
    }

    @LoadBalanced
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }

    @RestController
    static class EchoController {

        private final RestTemplate restTemplate;

        EchoController(RestTemplate restTemplate) {
            this.restTemplate = restTemplate;
        }

        @GetMapping(value = "/echo")
        public String echo(@RequestHeader HttpHeaders headers, @RequestParam(name = "value") String val) {
            HttpEntity<String> entity = new HttpEntity<>(headers);
            ResponseEntity<String> response = restTemplate.exchange("http://RouterEchoServer/echo/" + val, HttpMethod.GET, entity, String.class);
            return response.getBody();
        }
    }
}

设置 RouterEchoServer 的被调路由规则

验证

携带 http header 信息为 ’env: dev1’，可以观察到所有的请求只可被端口为20001的服务进程进行响应

➜  ~ curl -H 'env: dev1' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20001%
➜  ~ curl -H 'env: dev1' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20001%
➜  ~ curl -H 'env: dev1' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20001%
➜  ~ curl -H 'env: dev1' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20001%

携带 http header 信息为 ’env: dev2’，可以观察到所有的请求可被任意一个服务提供者进程进行响应

➜  ~ curl -H 'env: dev2' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20001%
➜  ~ curl -H 'env: dev2' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20002%
➜  ~ curl -H 'env: dev2' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20001%
➜  ~ curl -H 'env: dev2' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20002%
➜  ~ curl -H 'env: dev2' http://127.0.0.1:38888/echo\?value\=hello
Hello PolarisMesh hello, I'm RouterEchoServer:20001%