动态配置

基于 Spring 开发的服务，将通过 application.yml 或 application.properties 进行服务配置，其配置项来源通常是环境变量。由于环境变量无法动态变更生效，配置修改后需重新部署服务以获取最新配置，进而导致业务中断，造成不利影响。

为此，配置中心提供了动态配置更新的解决方案，无需重新部署服务，即可秒级动态生效配置。

tip 提示

基于配置中心的动态配置更新能力，除支持 Java 语言和 Spring 框架外，也支持其他语言和框架通过配置中心的 API 或 SDK 接入使用。

配置中心底层基于 Nacos 实现。Nacos 是阿里巴巴的一款开源中间件，具体使用方法请见下文。

dice.yml 中引用配置中心 Addon

  1. addons:
  2.   config:
  3.     plan: config-center:basic

修改 Maven 的 pom.xml 文件

  • Spring-Boot 1.x 版本

    1.         <dependency>
    2.             <groupId>io.terminus.common</groupId>
    3.             <artifactId>terminus-spring-boot-starter-configcenter</artifactId>
    4.             <version>1.4.5.RELEASE</version>
    5.         </dependency>

  • Spring-Boot 2.0.x 版本

    1.         <dependency>
    2.             <groupId>io.terminus.common</groupId>
    3.             <artifactId>terminus-spring-boot-starter-configcenter</artifactId>
    4.             <version>2.0.5.RELEASE</version>
    5.         </dependency>

  • Spring-Boot 2.1.x版本

    1.         <dependency>
    2.             <groupId>io.terminus.common</groupId>
    3.             <artifactId>terminus-spring-boot-starter-configcenter</artifactId>
    4.             <version>2.1.0.RELEASE</version>
    5.         </dependency>

使用 Spring Cloud Config 的 @RefreshScope 注解

可使用 @Value 或者 @ConfigurationProperties 获取配置。

  1. package io.terminus.erda.trial.demo.helloconfigcenter.controller;
  3. import org.springframework.beans.factory.annotation.Value;
  4. import org.springframework.cloud.context.config.annotation.RefreshScope;
  5. import org.springframework.web.bind.annotation.GetMapping;
  6. import org.springframework.web.bind.annotation.RestController;
  8. @RefreshScope
  9. @RestController
  10. public class HelloConfigCenterController {
  12.     @Value("${demo.name:Bob}")
  13.     private String name;
  15.     @GetMapping("/hello")
  16.     public String hello() {
  17.         return "Hello! " + name;
  18.     }
  19. }

配置中心控制台中修改动态配置

若 dice.yml 引用了配置中心，服务部署成功后，服务插件中将出现配置中心的控制台入口。

动态配置 - 图1

进入配置中心控制台，即可对配置项进行修改、删除等操作。

动态配置 - 图2

本地连线上配置中心

请配置以下环境变量：

  • CONFIGCENTER_TENANT_NAME
  • CONFIGCENTER_TENANT_ID
  • CONFIGCENTER_ADDRESS
  • CONFIGCENTER_GROUP_NAME