从零学SpringCloud系列（八）：分布式配置中心Spring Cloud Config

爱被打了一巴掌 2023-03-12 10:52 23阅读 0赞

# 一、快速入门 #

## 1.1 项目版本 ##

spring boot：2.2.5.RELEASE

spring cloud：Hoxton.SR3

## 1.2 项目地址 ##

[https://github.com/zhenghaoxiao/spring-cloud-in-action/tree/dev][https_github.com_zhenghaoxiao_spring-cloud-in-action_tree_dev]

在搭建配置中心的时候，我们需要注意的一个地方就是，在配置客户端的时候，我们需要使用bootstrap.properties，这样config-server中的配置信息才能被正确的加载。具体搭建过程可以参考下面文章：

[https://blog.csdn.net/hao134838/article/details/105339907][https_blog.csdn.net_hao134838_article_details_105339907]

# 二、配置详解 #

/\{application\}/\{profile\}\[/\{label\}\]  
/\{application\}-\{profile\}.yml  
/\{label\}/\{application\}-\{profile\}.yml  
/\{application\}-\{profile\}.properties  
/\{label\}/\{application\}-\{profile\}.properties

上面的url会映射\{application\}-\{profile\}.properties对应的配置文件，\{label\}对应git上不同的分支，默认为master。

所以在上面项目中，我们启动config-server工程后，我们可以访问：

[http://localhost:7071/config-client/dev][http_localhost_7071_config-client_dev] 地址得到下面内容

{
        "name":"config-client",
        "profiles":[
            "dev"
        ],
        "label":null,
        "version":"40af4c2ef1ad8ac9a394b8a244396fa303c3e665",
        "state":null,
        "propertySources":[
            {
                "name":"https://github.com/zhenghaoxiao/springcloudconfig/rpo/config-client-dev.properties",
                "source":{
                    "from":"jack-cloud"
                }
            }
        ]
    }

客户端配置详和git中存储文件中各个部分的对应关系

spring.application.name：对应配置文件规则中的{application}部分
    spring.cloud.config.label：对应配置文件规则中{profile}部分
    spring.cloud.config.profile：对应配置文件规则中{label}部分
    spring.cloud.config.uri=http：对应配置文件规则中config-server的地址

# 三、服务端详解 #

## 3.1 基础架构 ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTMwNDU0Mzc_size_16_color_FFFFFF_t_70][]

## 3.2 执行流程 ##

1、应用启动时，根据bootstrap.properties中配置的应用名\{application\}、环境名\{profile\}、分支名\{label\}，向Config Server请求获取配置信息。

2、Config Server根据自己维护的Git仓库信息和客户端传递过来的配置定位信息去查找配置信息

3、通过 git clone命令将找到的配置信息下载到Config Server的文件系统中。

4、Config Server创建Spring 的ApplicationContext实例，并从Git本地仓库中加载配置文件，最后将这些配置内容读取出来返回给客户端应用。

5、客户端应用在获得外部配置文件后加载到客户端的ApplicationContext实例，该配置内容的优先级高于客户端jar包内部的配置内容，所以在jar中重复内容将不再被加载。

Config Server巧妙的通过 git clone将配置信息存于本地，起到了缓存的作用，即使当git服务端无法访问的时候，依然可以读取C onfig Server中缓存内容进行使用。

## 3.3 仓库 配置 ##

对于仓库配置config默认采用了git。git非常使用存储配置内容，他可以非常方法的利用各种第三方工具对配置内容进行修改，并且它的Hook功能还可以帮助我们实时监控配置内容的修改。同时，它也支持SVN、本地文件系统等方式进行存储配置内容。

下面我们主要介绍一下使用git作为配置仓库的内容

spring.cloud.config.server.git.uri=https://github.com/zhenghaoxiao/springcloudconfig
    spring.cloud.config.server.git.searchPaths=rpo
    spring.cloud.config.server.git.username=jack
    spring.cloud.config.server.git.password=******

如果我们将uri的值通过file://前缀来设置为一个文件地址，那么它将以本地 仓库的方式运行，这样我们就可以脱离git服务端来快速进行调试与开发，比如：

spring.cloud.config.server.git.uri=file://$\{user.home\}/config-repo

其中\{user.home\}代表当前用户所属目录。

### 3.3.1 占位符配置URI ###

\{application\}、\{profile\}、\{label\}这些 占位符除了用于标识配置文件的规则之外，还可以用于Config Server中对git 仓库地址的URI配置，比如，我们可以通过\{application\}占位符来实现一个 应用对一个一个git仓库目录的配置效果，具体配置如下：

spring.cloud.config.server.git.uri=https://github.com/zhenghaoxiao/springcloudconfig/{application}
    spring.cloud.config.server.git.searchPaths=rpo
    spring.cloud.config.server.git.username=jack
    spring.cloud.config.server.git.password=******

其中，\{application\}代表了应用名，所以当客户端应用向Config Server发起获取配置的要求时，Config Server会根据客户端的spring.application.name信息来填充\{application\}占位符以定位配置 资源的存储位置，从而实现根据微服务应用的属性动态获取不同位置的配置。另外，在这些占位符中，\{label\}参数较为特别，如果git的分支和标签名包含了“/”,那么\{label\}参数在http的URL中应该使用“（\_）”来代替，以避免改变了uri含义，指向到其他的URI资源。

### 3.3.2 子目录存储 ###

除了支持占位符配置外，config server还可以将配置文件定位到git仓库的子目录中，我们在快速入门项目中的的配置中有一个配置是

spring.cloud.config.server.git.searchPaths=rpo

对于这个参数的配置也支持使用\{application\}、\{profile\}、\{label\}占位符

### 3.4 属性覆盖 ###

config server还有一个“属性覆盖”的 特性，他可以让开发人员为所有的应用提供配置属性，只需要通过spring.cloud.config.server.overrides.name属性来设置键值对的参数，这些参数会以map的方式 加载到客户端。

spring.cloud.config.server.overrides.name=didi

通过 该属性配置的参数，不会被spring cloud的客户端修改，并且spring cloud中获取配置的信息时，都会取得这些配置信息。

### 3.5  服务化配置 ###

服务化配置就是将config server作为一个服务单元纳入到服务中心管理之中，然后通过服务发现来访问config server。这样我们服务端和客户端都需要依赖eureka，加入到eurka服务治理体系，在上面项目中应配置了，大家可以参考一下项目中的配置。

spring.cloud.config.discovery.enabled=true
    spring.cloud.config.discovery.service-id=config-server

# 四、动态刷新配置 #

## 4.1 手动刷新配置 ##

手动刷新是指，我们修改了git仓库中的配置内容以后， 客户端获取到的内容并不是最新的， 需要我们手动调用一个接口来触发 刷新。我们需要修改客户端项目：

pom 依赖：

<dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-actuator</artifactId>
            </dependency>

配置文件增加：

management.endpoints.web.exposure.include= health,info,refresh

在需要获得配置文件的类上增加注解：@RefreshScope

@RestController
    @RefreshScope
    public class TestController {
    
        @Value("${from}")
        private String from;
    
        @GetMapping("/test")
        public String getFrom() {
            return from;
        }
    }

这样我们修改完远程仓库中的内容手动调用接口：[http://localhost:7072/actuator/refresh][http_localhost_7072_actuator_refresh] 即可

## 4.2 利用git 的webhooks实现自动刷新 ##

1、进入 github 仓库配置页面，选择 Webhooks ，并点击 add webhook；  
![format_png][]

2、之后填上回调的地址，也就是上面提到的 actuator/refresh 这个地址，但是必须保证这个地址是可以被 github 访问到的。如果是内网就没办法了。这也仅仅是个演示，一般公司内的项目都会有自己的代码管理工具，例如自建的 gitlab，gitlab 也有 webhook 的功能，这样就可以调用到内网的地址了。

![format_png 1][]

# 五、小结 #

对于一些简单的项目来说，我们一般都是直接把相关配置放在单独的配置文件中，以 properties 或者 yml 的格式出现，更省事儿的方式是直接放到 application.properties 或 application.yml 中。但是这样的方式有个明显的问题，那就是，当修改了配置之后，必须重启服务，否则配置无法生效。

目前有一些用的比较多的开源的配置中心，比如携程的 Apollo、蚂蚁金服的 disconf 等，对比 Spring Cloud Config，这些配置中心功能更加强大。有兴趣的可以拿来试一试。

在spring cloud 家族中 config也是 足够好用了。。

后续。。。。。

续我们会利用消息总线 Spring Cloud Bus 来实现动态刷新。

[https_github.com_zhenghaoxiao_spring-cloud-in-action_tree_dev]: https://github.com/zhenghaoxiao/spring-cloud-in-action/tree/dev
[https_blog.csdn.net_hao134838_article_details_105339907]: https://blog.csdn.net/hao134838/article/details/105339907
[http_localhost_7071_config-client_dev]: http://localhost:7071/config-client/dev
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTMwNDU0Mzc_size_16_color_FFFFFF_t_70]: /images/20230312/b0bac2c1079f4a538369fcc62b538b70.png
[http_localhost_7072_actuator_refresh]: http://localhost:7072/actuator/refresh
[format_png]: /images/20230312/07b35a2e1a2c44dea2ec54d90e15ad98.png
[format_png 1]: /images/20230312/9239679c60b54b5782a6d740520815af.png