2.0.0 新特性介绍: 多配置中心支持
很多热心的开发者给 2.0.0 贡献了很多新的特性, @GuoYL123 贡献了 servicecomb-kie 的支持, @160731liupf 贡献了 nacos 的支持, 本文介绍开发者如何在自己的项目中使用这些配置中心。
Java Chassis 配置源介绍和使用指南
配置中心是微服务架构下一个非常重要的中间件,通过配置中心用户可以增加和删除配置信息,配置信息会通过不同的通知机制(通常包括 PULL 和 PUSH), 将配置的变化推送到微服务实例。 java-chassis 允许用户使用不同的配置中心, 目前支持用户使用如下几种配置中心:
- 华为云配置中心
华为云配置中心是华为云CSE产品的一个部件,java-chassis 最早使用它作为配置中心。 对接这个配置中心的代码在 config-cc 模块实现。 可以从轻量化微服务引擎下载本地使用的版本。也可以 直接访问华为云 ServiceStage 产品,使用在线的版本。
使用华为云配置中心,需要在项目中引入如下依赖:
<dependency>
<groupId>org.apache.servicecomb</groupId>
<artifactId>config-cc</artifactId>
</dependency>
然后在配置文件 microservice.yaml 中增加如下配置项:
servicecomb:
config:
client:
serverUri: http://127.0.0.1:30113
refreshMode: 0
refresh_interval: 5000
refreshPort: 30114
华为云配置中心的其他配置项含义如下:
配置项名 | 描述 |
---|---|
servicecomb.config.client.refreshMode | 应用配置的刷新方式,0 为config-center主动push,1 为client周期pull,默认为0 |
servicecomb.config.client.refreshPort | config-center推送配置的端口 |
servicecomb.config.client.tenantName | 应用的租户名称 |
servicecomb.config.client.serverUri | config-center访问地址,格式为http(s)://{ip}:{port} ,以, 分隔多个地址 |
servicecomb.config.client.refresh_interval | pull模式下刷新配置项的时间间隔,单位为毫秒,默认值为30000 |
- 使用 servicecomb-kie
servicecomb-kie 是全新设计的配置中心。 从 2.0.0 版本开始, java-chassis 支持使用 servicecomb-kie。 从 2.0.1 版本开始, java-chassis 默认使用long polling 拉取 servicecomb-kie 配置,来节省间隔轮询带来的网络消耗。 servicecomb-kie 的安装指导可以参考官网文档。 在 java-chassis 中使用 servicecomb-kie, 需要引入下面的依赖:
<dependency>
<groupId>org.apache.servicecomb</groupId>
<artifactId>config-kie</artifactId>
</dependency>
然后在配置文件 microservice.yaml 中增加如下配置项:
servicecomb:
kie:
serverUri: http://127.0.0.1:30110
refresh_interval: 5000
firstRefreshInterval: 5000
domainName: default
servicecomb-kie 的配置项及其含义如下:
配置项名 | 描述 |
---|---|
servicecomb.kie.domainName | 区域名称,默认为default |
servicecomb.kie.serverUri | servicecomb-kie访问地址,格式为http(s)://{ip}:{port} ,以, 分隔多个地址 |
servicecomb.kie.refresh_interval | pull模式下刷新配置项的时间间隔,单位为毫秒,默认值为3000 |
servicecomb.kie.firstRefreshInterval | pull模式下启动过程中首次刷新时间间隔,单位为毫秒,默认值为3000 |
- 使用 nacos
nacos 是 alibaba 提供的配置中心。 java-chassis 从 2.0.0 版本支持 nacos。 nacos的下载安装请参考官网介绍。
使用nacos,需要在项目中引入如下依赖:
<dependency>
<groupId>org.apache.servicecomb</groupId>
<artifactId>config-nacos</artifactId>
</dependency>
然后在配置文件 microservice.yaml 中增加如下配置项:
servicecomb:
nacos:
serverUri: http://127.0.0.1:8848
group: DEFAULT_GROUP
dataId: example
- 使用 Apollo
Apollo 是携程框架部门研发的分布式配置中心。 Apollo的下载安装请参考官网介绍。
<dependency>
<groupId>org.apache.servicecomb</groupId>
<artifactId>config-apollo</artifactId>
</dependency>
然后在配置文件 microservice.yaml 中增加如下配置项:
apollo:
config:
serverUri: http://127.0.0.1:8070
serviceName: apollo-test
env: DEV
clusters: test-cluster
namespace: application
token: xxx
refreshInterval: 30
firstRefreshInterval: 0
参与配置源的开发和贡献
2.0.0 版本提供了4种配置源的支持, 如果采用 Spring Boot 运行模式, 由于 Java Chassis 继承和适配了 Spring Boot 的 配置源, 因此 Spring Boot 采用的配置源也可以平滑的被 Java Chassis 应用程序使用。 比如 Java Chassis 在 Spring Boot 集成模式下使用 application.yml 作为配置文件, 可以使用 git 作为动态配置源。
因此, Java Chassis 已经支持大部分开发者能够使用的配置源。 然而,目前的支持仍然是不够的, 每一个不同的配置中心 都提供了非常独特的功能, Java Chassis 只是集成了它们极少的核心功能, 维护一个配置中心的支持,需要长期大量的应用 验证,才能够把功能做的稳定和强大。 因此,配置中心的支持还需要开发者帮助持续的贡献代码。
Java Chassis 的配置扩展是基于 archaius, 开发者只需要实现 ConfigCenterConfigurationSource
, 即可以接入其他配置中心。 Java Chassis 的源码目录 config-cc, config-apollo, config-kie, config-nacos 分别实现了 这个接口。