SpringCloud-微服务配置统一管理SpringCloud Config(七)

前言：对于应用，配制文件一般是放在项目中管理的，它可能有spring、mybatis、log等等各类各样的配置文件和属性文件，另外你还可能有开发环境、测试环境、生产环境等，这样的话就得一式三份，如果传统应用还好说，若是是微服务呢，这样不光配置文件有可能冗余并且量大，繁重复杂，很差维护，这样的话就须要一个配置文件的统一管理了。

1、SpringCloud Config简介

　　SpringCloud Config为分布式系统外部化配置提供了服务器端和客户端的支持，它包括ConfigServer和ConfigClient两部分。

　　　　

　　Server:

• 实例通常多于两个，以实现HA；
• 配置以文件形式存储，快速支持目前以SpringBoot的开发方式的配置文件；
• 支持GIt，码云，SVN，本地文件等多种形式；
• 支持属性加密；

　　Client：即各自的微服务应用；

　　使用SpringCloud BUS配置和借助Git仓库的WebHooks自动刷新；

2、SpringCloud Config基本使用

建立服务端：

　　一、前面简单介绍了一下Config，那么首先要作的准备是先到Git仓库或者码云中建立一个项目并新建一些配置文件 spring-cloud-repo：

　　

　　二、建立Maven工程 config-server，添加依赖：

    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-config-server</artifactId>
    </dependency>

 　　三、建立启动类，并加上开启Config服务端注解@EnableConfigServer:

@SpringBootApplication
@EnableConfigServer
public class ConfigApplication {

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

}

　　四、添加application属性文件：

server.port=9000
spring.application.name=config-server-9000
spring.cloud.config.server.git.uri=https://gitee.com/lfalex/spring-cloud-repo

　　五、启动项目，简单测试，访问：localhost:9000/application/dev，localhost:9000/application-dev.properties:

　　　　访问规则：

　　　　　　/{appication}/{profile}/[{label}]

　　　　　　/{application}-{profile}.yml

　　　　　　/{application}-{profile}.properties

　　　　　　/{label}/{application}-{profile}.properties

　　　　　　/{label}/{application}-{profile}.yml

　　　　它们均可以映射到对应的配置文件{application}-{profile}.properties，其中{label}为具体的分支，默认为master；

　　

　　

建立客户端（通常为具体的微服务）：

　　一、建立Maven项目 config-client，添加依赖：

    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 实现Config的客户端配置 -->
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-config</artifactId>
    </dependency>
    <!-- 实现经过端点refresh手动刷新 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>

　　二、建立通常启动类便可，无需添加注解，建立Controller，为测试作准备：

    @Value("${version}")
    private String version;

    @RequestMapping("/getVersion")
    public String getVersion() {
        return this.version;
    }

 　　三、为了更明显的测试Config是否生效，在application配置文件中添加：

server.port=9001

　　四、添加bootstrap.properties配置文件，bootstrap.properties为默认文件名，在springcloud中配置文件有个优先级的概念，当本地application.properties文件和bootstrap.properties文件中配置了一样的属性不一样的值，因为bootstrap的优先级高，则在bootstrap中的属性不会被application中的覆盖，反而会覆盖掉application中的配置：

#对应着config server所获取配置文件的{application}和URL
spring.application.name=application
spring.cloud.config.uri=http://localhost:9000/
#对应着文件后面的后缀{profile}
spring.cloud.config.profile=dev
#分支
spring.cloud.config.label=master

　　五、先启动服务器，再启动客户端，观察端口和页面，因为前面在application中添加了端口为9001，而远程仓库的配置文件中也添加了端口9999：

　　

　　

 这样就实现了基本的远程配置仓库了，可是一旦有文件更改还得从新启动项目，这样就颇有问题了，因此须要刷新，使用/refresh端点刷新：

　　一、在application或远程文件中添加：

#因为要使用actuator，因此必需要将安全权限关闭
management.security.enabled=false

　　二、在controller上添加注解@RefreshScope注解：

@RestController
@RefreshScope       //非重启项目手动刷新配置注解
public class ConfigController {
      。。。。      
}

　　三、启动测试，打开，修改version=dev-3.0.0为version=dev-4.0.0，并发送刷新请求http://localhost:9999/refresh，刷新测试页面查看:

　　

　　

　　

3、SpringCloud Bus自动刷新配置

　　前面的基于端点刷新，只针对一个服务，若为多个微服务，这样就很繁琐，因此须要一个能够集体刷新或指定刷新的组件=》SpringCloud Bus；

　　一、使用SpringCloud Bus须要使用RabbitMQ，未安装的请安装，基于以前的端点刷新的项目，添加依赖：

    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-bus-amqp</artifactId>
    </dependency>

　　二、在bootstrap中增长RabbitMQ的配置：

spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
spring.rabbitmq.username=guest
spring.rabbitmq.password=guest

　　三、启动 config-bus-client测试，打开，修改version=dev-3.0.0为version=dev-4.0.0，并发送刷新请求http://localhost:9999/bus/refresh，刷新测试页面查看:

　　

　　

　　

　　

　　还能够经过Git或者码云的WebHooks来发送修改刷新配置请求：

　　

 

 

 

 

参考书籍：《SpringCloud与Docker微服务架构实战》周力著

代码示例：https://gitee.com/lfalex/springcloud-example（ config-server、 config-client、 config-bus-client）