Bootstrap

微服务实战——高可用的SpringCloudConfig

管理微服务配置

对于单体应用架构来说,会使用配置文件管理我们的配置,这就是之前项目中的application.properties或application.yml。如果需要在多环境下使用,传统的做法是复制这些文件命名为application-xxx.properties,并且在启动时配置spring.profiles.active={profile}来指定环境。

在微服务架构下我们可能会有很多的微服务,所以要求的不只是在各自微服务中进行配置,我们需要将所有的配置放在统一平台上进行操作,不同的环境进行不同的配置,运行期间动态调整参数等等。总之一句话,使用集中管理配置是很有必要的。

Spring Cloud Config

  • 官方地址
  • 为分布式系统外部配置提供了服务器端和客户端的支持,它包括config server端和 config client端两部分
  • Config server端是一个可以横向扩展、集中式的配置服务器,它用于集中管理应用程序各个环境下的配置,默认 使用Git存储配置内容
  • Config client 是config server的客户端,用于操作存储在server中的配置属性
  • 优势
    • 集中管理配置
    • 不同环境不同配置
    • 运行期间可以动态调整
    • 配置修改后可以自动更新

本章源码

源码

全部SpringCloud教程

架构图

spring cloud config架构图

引入spring cloud config步骤

可基于之前SpringCloudDemo项目改造,也可以创建为新的项目

一、在GitHub创建一个git仓库用来存放git配置

  • 创建仓库名字为spring-cloud-config-repo的私有仓库
  • 增加其他模块(后面config client会详细说,可先跳过)的配置文件,格式为
      {application}-{profile}.properties
    并将配置项粘贴到新建的文件中,如:创建zuul-dev.properties,并将原来的zuul模块中的application.properties全部配置粘贴进来
  • {application}-{profile}.properties,{application}表示微服务的名称,{label}表示Git对应的分支,默认为master,{profile}表示配置文件的profile 访问时就 /{application}/{profile}[/{label}]或/{label}/{application}-{profile}.properties

二、 创建config server端

  • 创建maven项目,可在原项目中创建Module

    config server module

  • 引入pom依赖

      <dependency>
          <groupId>org.springframework.cloud</groupId>
          <artifactId>spring-cloud-config-server</artifactId>
      </dependency>
  • 创建启动类

      package cn.kxtop.blog.configserver;
    
      import org.springframework.boot.SpringApplication;
      import org.springframework.boot.autoconfigure.SpringBootApplication;
      import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
      import org.springframework.cloud.config.server.EnableConfigServer;
      // 注入到Eureka中,使高可用
      @EnableDiscoveryClient 
      @SpringBootApplication
      @EnableConfigServer
      public class ConfigServerApplication {
    
          public static void main(String[] args) {
              SpringApplication.run(ConfigServerApplication.class);
          }
    
      }
  • 配置配置文件application.properties

      server.port=9999
      # 配置git仓库的地址(修改为你自己的git仓库地址)
      spring.cloud.config.server.git.uri=https://github.com/qupengkun/spring-cloud-config-repo.git
      # git仓库账号
      spring.cloud.config.server.git.username=YOU_NAME
      # git仓库秘密
      spring.cloud.config.server.git.password=YOU_PASSWORD
      #eureka,确保Spring cloud config 高可用
      eureka.client.serviceUrl.defaultZone = http://localhost:8761/eureka/
  • 启动项目并访问测试 http请求localhost:9999/zuul/dev config-server

三、创建config client端

  • 引入依赖
      <dependency>
          <groupId>org.springframework.cloud</groupId>
          <artifactId>spring-cloud-config-client</artifactId>
      </dependency>
  • 创建bootstrap.properties
      #对应之前git仓库的文件名,如zuul-dev.properties
      spring.application.name=zuul
      #config server 地址
      spring.cloud.config.uri=http://localhost:9999
      #{profile}名(环境)
      spring.cloud.config.profile=dev
      #{label}名,git仓库分支
      spring.cloud.config.label=master
  • 删除原来的application.properties,如没有,则不用操作直接下一步
  • 启动client端可见连接到了config-server端 config client
  • 查看eureka发现已经注册到eureka中 基于spring cloud config的eureka
  • 测试在线参数修改 可在Controller上加注解 @RefreshScope 请求server:port/refresh手动刷新

总结及后续

以上基本演示了Spring Cloud Config的用法,还是比较简单的,我们引入了Eureka使Config Server能保证高可用,还可以增加@RefreshScope手动刷新配置文件,如果配置对安全要求较高,也可以引入JCE(Java Cryptography Extension)进行加解密操作。

其实每次都去手动刷新配置还是比较麻烦且有很大的局限性的,那么如何修改配置后自动感知并刷新呢?请关注下一章基于Spring Cloud Bus实现自动刷新配置。

持续学习,记录点滴。更多文章请访问 文章首发

;