动态路由

最近更新时间:2025-06-23 17:50:22

我的收藏

操作场景

本文介绍在本地开发 Java 应用,通过 Spring Cloud 的方式接入 Polaris(北极星),并实现服务路由。

前提条件

1. 在开发前,请确保您已经下载安装了 Java 和 Maven。
2. 已创建 Polaris(北极星)实例,操作步骤详见 引擎管理

操作步骤

步骤1:引入依赖

1.1 引入 spring cloud tencent 依赖

修改应用根目录下的 pom.xml,添加dependencyManagement
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.tencent.cloud</groupId>
<artifactId>spring-cloud-tencent-dependencies</artifactId>
<version>${version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
注意:
请根据项目 Spring Boot 和 Spring Framework 的版本,选择合适的 Spring Cloud Tencent 版本

1.2 引入 spring cloud tencent starter

方式一:通过 spring-cloud-starter-tencent-all 引入 sct 所有 starters。
<dependency>
<groupId>com.tencent.cloud</groupId>
<artifactId>spring-cloud-starter-tencent-all</artifactId>
</dependency>
方式二:同时引入 spring-cloud-starter-tencent-polaris-discoveryspring-cloud-starter-tencent-polaris-router
<dependency>
<groupId>com.tencent.cloud</groupId>
<artifactId>spring-cloud-starter-tencent-polaris-discovery</artifactId>
</dependency>

<dependency>
<groupId>com.tencent.cloud</groupId>
<artifactId>spring-cloud-starter-tencent-polaris-router</artifactId>
</dependency>

步骤2:添加北极星配置文件

1. 在项目的 main/resources 目录下创建 bootstrap.yml 文件。
2. 在 bootstrap.yml 文件中配置应用名、Polaris(北极星)服务端地址等信息。服务端地址查看详见 引擎管理 的客户端访问地址部分。
spring:
application:
name: ${application.name}
cloud:
polaris:
enabled: true
address: grpc://${修改为 Polaris 服务地址}:8091
namespace: default
router:
metadata-router:
enabled: true

步骤3:路由规则下发

启动应用并在 北极星控制台 设置动态路由规则,操作步骤详细参见 服务治理指南 > 服务治理 > 动态路由,相关界面如下: