SpringCloud Config Server和Client的配置使用

亦凉 2022-05-19 07:25 212阅读 0赞

对于配置的重要性，我想我不用进行任何强调，大家都可以明白其重要性。在普通单体应用，我们常使用配置文件(application(\*).properties(yml))管理应用的所有配置。这些配置文件在单体应用中非常胜任其角色，并没有让我们感觉到有头疼的地方。但随着微服务框架的引入，微服务数量就会在我们产品中不断增加，之前我们重点考虑的是系统的可伸缩、可扩展性好，但随之就是配置管理的问题就会一一暴露出来。起初微服务器各自管各自的配置，在开发阶段并没什么问题，但到了生产环境管理就会很头疼，如果要大规模更新某项配置，困难就可想而知。

为此，在分布式系统中，Spring Cloud提供一个Config子项目，该项目核心就是配置中心，通过一个服务端和多个客户端实现配置服务。我们可使用配置服务器集中的管理所有服务的各种环境配置文件。配置服务中心默认采用Git的方式进行存储，因此我们很容易部署修改，并可以对环境配置进行版本管理。

Spring Cloud Config具有中心化、版本控制、支持动态更新和语言独立等特性。其特点是:

*  提供服务端和客户端支持(Spring Cloud Config Server和Spring Cloud Config Client);
 *  集中式管理分布式环境下的应用配置;
 *  基于Spring环境，实现了与Spring应用无缝集成;
 *  可用于任何语言开发的程序;
 *  默认实现基于Git仓库(也支持SVN)，从而可以进行配置的版本管理;

Spring Cloud Config的结构图如下:

[![9866e2210fab3260af081dafa8fb5ed0.png][]][9866e2210fab3260af081dafa8fb5ed0.png]

Config-结构图

从图中可以看出Spring Cloud Config有两个角色(类似Eureka): Server和Client。Spring Cloud Config Server作为配置中心的服务端承担如下作用:

*  拉取配置时更新Git仓库副本，保证是配置为最新;
 *  支持从yml、json、properties等文件加载配置;
 *  配合Eureke可实现服务发现，配合Cloud Bus(这个后面我们在详细说明)可实现配置推送更新;
 *  默认配置存储基于Git仓库(可以切换为SVN)，从而支持配置的版本管理.

而对于，Spring Cloud Config Client则非常方便，只需要在启动配置文件中增加使用Config Server上哪个配置文件即可。

## 1. 示例代码 ##

### 1.1 构建Config-Server ###

编写POM.XML文件

`Config-Server` 是一个标准的Spring Boot应用，所以 `pom.xml` 也是继承之前的Parent：

twostepsfromjava.cloud
        twostepsfromjava-cloud-parent
        1.0.0-SNAPSHOT
        ../parent
    
    
    config-server
    Spring Cloud Sample Projects: Config Server
    
    
        
            org.springframework.cloud
            spring-cloud-config-server

编写启动类

/**
     * TwoStepsFromJava Cloud -- Config Server
     *
     * @author CD826(CD826Dong@gmail.com)
     * @since 1.0.0
     */
    @SpringBootApplication
    @EnableConfigServer
    public class Application {
    
        public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
        }
    
    }

这里最重要的就是增加 `@EnableConfigServer` ，其它与之前的应用一致。

编写配置文件

server.port=8280
    
    spring.application.name=config-server
    
    spring.cloud.config.server.git.uri=https://github.com/cd826/SpringcloudSamplesConfig
    spring.cloud.config.server.git.username=your git username
    spring.cloud.config.server.git.password=your git password

这里最重要的是需要配置Git仓库的地址及登录用户名和口令。

创建测试配置文件

我们在 **SpringcloudSamplesConfig** 仓库中增加量个配置文件。

`mallWeb.properties` ，文件内容如下:

foo = bar

`mallWeb-dev.properties` ，文件内容如下:

bar = cd826

注意：这里编写文件后记得提交，否则会测试失败。

启动测试

启动 `config-server` . 在终端中我们输入以下命令(或者使用postman):

curl localhost:8280/mallWeb/dev

在终端中会输出以下内容:

{"name":"mallWeb","profiles":["dev"],"label":null,"version":null,"state":null,"propertySources":[
        {"name":"https://github.com/cd826/SpringcloudSamplesConfig/mallWeb-dev.properties","source":{"bar":"cd826"}},  
        {"name":"https://github.com/cd826/SpringcloudSamplesConfig/mallWeb.properties","source":{"foo":"bar"}}
    ]}

这里可以看到，我们提交到Git中的配置文件已经能够被 `config-server` 正确的读取到。

CONFIG-SERVER默认配置

当我们查看源码会发现在 **spring-cloud-config-server.jar** 包中有一个默认配置文件`configserver.yml` 配置文件，也就是说当我们设置 `spring.application.name=configserver` 时，就会默认加载该配置文件，该配置文件内容如下:

info:
      component: Config Server
    spring:
      application:
        name: configserver
      jmx:
        default_domain: cloud.config.server
      cloud:
        config:
          server:
            git:
              uri: https://github.com/spring-cloud-samples/config-repo
              repos:
                - patterns: multi-repo-demo-*
                  uri: https://github.com/spring-cloud-samples/config-repo
    server:
      port: 8888
    management:
      context_path: /admin

默认使用 `8888` 端口，并且从 `https://github.com/spring-cloud-samples/config-repo` 这个Git仓库中查找配置文件。

因为，在上面的示例中我们重新定义了应用名称和服务端口。

### 1.2 构建config-client ###

config-client可以是任何一个基于Spring boot的应用，这里为了讲解方便，我们构建一个非常简单的web工程。

编写POM.XML文件

我们的 `config-client` 项目需要引入对 `spring-cloud-starter-config` 的依赖，如下：

twostepsfromjava.cloud
        twostepsfromjava-cloud-parent
        1.0.0-SNAPSHOT
        ../parent
    config-client
    Spring Cloud Sample Projects: Config Client
            org.springframework.cloud
            spring-cloud-starter-config
            org.springframework.boot
            spring-boot-starter-web

编写启动类

一个标准的Spring Boot启动类:

/**
     * TwoStepsFromJava Cloud -- Config Client Project
     *
     * @author CD826(CD826Dong@gmail.com)
     * @since 1.0.0
     */
    @SpringBootApplication
    public class Application {
    
        public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
        }
    
    }

编写测试CONTROLLER

这个测试Controller主要就是验证我们可以从Git仓库中获取配置内容。

/**
     * Config Client Test Controller
     *
     * @author CD826(CD826Dong@gmail.com)
     * @since 1.0.0
     */
    @RestController
    @RequestMapping("/cfg")
    public class ConfigController {
        @Value("${foo}")
        String foo;
    
        @Value("${bar}")
        String bar;
    
        @RequestMapping(value = "/foo")
        public String foo(){
            return foo + "——" + bar;
        }
    }

编写配置文件

这里编写的配置文件名称为: `bootstrap.properties` ，内容如下:

server.port=8080
    
    spring.application.name=mallWeb
    spring.cloud.config.profile=dev
    spring.cloud.config.uri= http://localhost:8280/

定义了微服务的名称和profile以及配置服务器的地址。

注意: 这些配置不能够配置在 `application.properties` 文件中，因为在Spring Boot启动时有引导上下文和应用上下文的概念，只有将配置服务器信息定义在引导上下文中，才能够从配置服务器中获取到配置信息。否则，服务启动时会报找不到foo变量定义的错误。

### 1.3 启动测试 ###

启动后我们可以访问： [http://localhost:8080/cfg/foo][http_localhost_8080_cfg_foo] ，可以看到如下界面：

[![e7fe9a8bf03f0fb4c15ac76d85668194.png][]][e7fe9a8bf03f0fb4c15ac76d85668194.png]

Config-010

说明，我们的 **config-client** 已经成功从 **config-server** 上获取到配置的数据了。

### 1.4 Spring项目配置加载顺序 ###

*  这里是列表文本命令行参数
 *  SPRING\_APPLICATION\_JSON 参数
 *  从java:comp/env 加载 JNDI 属性
 *  Java系统属性 （System.getProperties()）
 *  操作系统环境变量
 *  如果有使用 random.\* 属性配置，则使用 RandomValuePropertySource 产生
 *  外部特定应用配置文件 例如：application-\{profile\}.properties 或者 YAML variants
 *  内部特定应用配置文件 例如：application-\{profile\}.properties 或者 YAML variants
 *  外部应用配置文件 例如：application.properties 或者 YAML variants
 *  内部应用配置文件 例如：application.properties 或者 YAML variants
 *  加载@Configuration类的 @PropertySource 或者 @ConfigurationProperties 指向的配置文件
 *  默认配置，通过SpringApplication.setDefaultProperties 设置

## 2. 配置规则详解 ##

下面我们来看一看Config Client从Config Server中获取配置数据的流程:

*  1.  **Config Client** 启动时，根据 `bootstrap.properties` 中配置的应用名称(application)、环境名(profile)和分支名(label)，向 **Config Server** 请求获取配置数据;
 *  1.  **Config Server** 根据 **Config Client** 的请求及配置，从Git仓库(这里以Git为例)中查找符合的配置文件;
 *  1.  **Config Server** 将匹配到的Git仓库拉取到本地，并建立本地缓存;
 *  1.  **Config Server** 创建Spring的 `ApplicationContext` 实例，并根据拉取的配置文件，填充配置信息，然后将该配置信息返回给 **Config Client** ;
 *  1.  **Config Client** 获取到 **Config Server** 返回的配置数据后，将这些配置数据加载到自己的上下文中。同时，因为这些配置数据的优先级高于本地Jar包中的配置，因此将不再加载本地的配置。

那么， **Config Server** 又是如何与Git仓库中的配置文件进行匹配的呢？通常，我们会为一个项目建立类似如下的配置文件:

*  **mallweb.properties** : 基础配置文件;
 *  **mallweb-dev.properties** : 开发使用的配置文件;
 *  **mallweb-test.properties** : 测试使用的配置文件;
 *  **mallweb-prod.properties** : 生产环境使用的配置文件;

当我们访问 **Config Server** 的端点时，就会按照如下映射关系来匹配相应的配置文件：

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

上面的Url将会映射为格式为:\{application\}-\{profile\}.properties(yml)的配置文件。另外， **label** 则对应Git上分支名称，是一个可选参数，如果没有则为默认的 **master** 分支。

而 **Config-Client** 的 `bootstrap.properties` 配置对应如下:

*  spring.application.name application;
 *  spring.cloud.config.profile profile;
 *  spring.cloud.config.label label.

### 2.1 Git仓库配置 ###

Config Server默认使用的就是Git，所以配置也非常简单，如上面的配置(application.properties):

spring.cloud.config.server.git.uri=http://
    spring.cloud.config.server.git.username=username
    spring.cloud.config.server.git.password=password

那么客户端在请求时服务端就会到该仓库中进行查找。

2.1.1 使用占位符

在服务端配置中我们也可以使用 **\{application\}** 、 **\{profile\}** 和 **\{label\}** 占位符，如下:

spring.cloud.config.server.git.uri=http://github.com/cd826/{application}
    spring.cloud.config.server.git.username=username
    spring.cloud.config.server.git.password=password

这样，我们就可以为每一个应用客户端创建一个单独的仓库。

这里需要注意的是，如果Git的分支或标签中包含"/"时，在\{label\}参数中需要使用"(\_)"替代，这个主要是避免与Http URL转义符处理的冲突。

2.1.2 使用模式匹配

我们也可以使用 **\{application\}** / **\{profile\}** 进行模式匹配，以便获取到相应的配置文件。配置示例如下:

spring.cloud.config.server.git.uri=https://github.com/spring-cloud-samples/config-repo
    
    spring.cloud.config.server.git.repos.simple=https://github.com/simple/config-repo
    
    spring.cloud.config.server.git.repos.special.pattern=special*/dev*,*special*/dev*
    spring.cloud.config.server.git.repos.special.uri=https://github.com/special/config-repo
    
    spring.cloud.config.server.git.repos.local.pattern=local*
    spring.cloud.config.server.git.repos.local.uri=file:/home/configsvc/config-repo

如果模式中需要配置多个值，那么可以使用逗号分隔。

如果 **\{application\}** / **\{profile\}** 没有匹配到任何资源，则使用`spring.cloud.config.server.git.uri` 配置的默认URI。

当我们使用yml类型的文件进行配置时，如果模式属性是一个YAML数组，也可以使用YAML数组格式来定义。这样可以设置成多个配个配置文件，如:

spring:
      cloud:
        config:
          server:
            git:
              uri: https://github.com/spring-cloud-samples/config-repo
              repos:
                development:
                  pattern:
                    - */development
                    - */staging
                  uri: https://github.com/development/config-repo
                staging:
                  pattern:
                    - */qa
                    - */production
                  uri: https://github.com/staging/config-repo

2.1.3 搜索目录

当我们把配置文件存放在Git仓库中子目录中时，可以通过设置 `serch-path` 来指定该目录。同样，`serch-path` 也支持上面的占位符。示例如下:

spring.cloud.config.server.git.uri=https://github.com/spring-cloud-samples/config-repo
    spring.cloud.config.server.git.searchPaths=foo,bar*

这样系统就会自动搜索foo的子目录，以及以bar开头的文件夹中的子目录。

2.1.4 SSH配置

如果你不想使用HTTPS和用户认证，也可以直接使用SSH，这时候我们只需要将ssh需要的keys存储在`～/.ssh` 目录即可，并将所配置的uri指向SSH地址即可，如：`git@github.com:cd826/SpringcloudSamplesConfig` 。

如果你清楚的知道你的 `~/.git` 目录，那么你可以使用 `git config --global` 来配置。否则可以使用全局配置，比如： `git config --global http.sslVerify false` 。

2.1.4 代理

Config-Server会使用JGit访问配置库，因此我们可以在 `~/.git/config` 下配置HTTPS所使用的代理，也可以使用JVM系统属性 `-Dhttps.proxyHost` 和 `-Dhttps.proxyPort` 来配置。

2.1.5 本地缓存

当Config-Server从Git(或SVN)中获取了配置信息后，将会在本地的文件系统中存储一份。默认将存储在系统临时目录下，并且以 `config-repo-` 作为开头，在Linux系统中默认存储的目录为 `/tmp/config-repo-` 。Config-Server将配置信息存储在本地可以有效的防止当Git仓库出现故障而无法访问的问题，当Config-Server无法访问到Git仓库时就会读取之前存储在本地文件中的配置，然后将这些配置信息返回给Config-Client。比如，当我们断开网络进行测试，当我们启动Config-Server时会在控制台中看到以下输出：

17:18:01 285 [http-nio-8280-exec-1] WARN  o.s.c.c.s.e.MultipleJGitEnvironmentRepository - Could not fetch remote for master remote: https://github.com/cd826/SpringcloudSamplesConfig
    17:18:01 660 [http-nio-8280-exec-1] INFO  o.s.c.a.AnnotationConfigApplicationContext - Refreshing 
    17:18:01 710 [http-nio-8280-exec-1] INFO  o.s.b.f.a.AutowiredAnnotationBeanPostProcessor - JSR-330 'javax.inject.Inject' annotation found and supported for autowiring
    17:18:01 782 [http-nio-8280-exec-1] INFO  o.s.c.c.s.e.NativeEnvironmentRepository - Adding property source: file:/Users/cd826/MyWork/springcloud-sample-projects/config/config-server/tmp/mallWeb-dev.properties
    17:18:01 782 [http-nio-8280-exec-1] INFO  o.s.c.c.s.e.NativeEnvironmentRepository - Adding property source: file:/Users/cd826/MyWork/springcloud-sample-projects/config/config-server/tmp/mallWeb.properties

Spring Cloud 官方文档建议我们在Config-Server中指定本地文件路径，以避免出现不可预知的错误。可以使用下面的属性配置来指定本地文件路径:

## Git仓库
    spring.cloud.config.server.git.basedir=tmp/
    
    ## SVN仓库
    spring.cloud.config.server.svn.basedir=tmp/

### 2.2 SVN配置 ###

如果你的项目中使用的是SVN而不是Git，那么只需要在Config-Server中进行如下修改就可以支持SVN仓库。

2.2.1 修改POM.XML

在pom文件中增加以下依赖:

org.tmatesoft.svnkit
        svnkit

2.2.2 修改APPLIACTION.PROPERTIES

spring.cloud.config.server.svn.uri={your svn server}
    spring.cloud.config.server.svn.username=username
    spring.cloud.config.server.svn.password=password

### 2.3 文件系统 ###

如果你的Config-Server中不想使用Git或SVN，那么我们也可以直接从当前classpath或文件系统中加载相应的配置文件，只需在配置文件中设置如下：

spring.profiles.active=native

注意Config-Server默认会从classpath下加载，我们可以使用`spring.cloud.config.server.native.searchLocations` 属性来设置配置文件的目录。对于文件路径，我们的配置必须以 `file:` 开头，如果是Windows系统对于绝对路径我们还得对/进行转义，比如，在Windows下我们需要配置如下： `file:///${user.home}/config-repo` 。

此外，当我们使用文件系统作为配置文件仓库时，`spring.cloud.config.server.native.searchLocations` 的配置也是支持\{application\} 、\{profile\} 和 \{label\} 占位符的。

Spring Cloud 官方还是推荐在测试和开发的时候可以使用文件系统，但是在正式环境中尽量还是使用Git或者SVN。

另，Spring Cloud Config中还支持另外一种配置文件方式：Vault Server，这个后面有空我们再探讨。

## 3. 安全保护 ##

### 3.1 Config-Server访问安全 ###

对于我们存储在配置中心的一些配置内容，总会有一些是敏感信息，比如数据库连接的用户名和密码，你总不能直接裸奔吧，所以我们还是需要对Config-Server做一些安全控制。当然，对于Config-Server的安全控制有很多种，比如：物理网络限制、OAuth2授权等。但是，在这里因为我们使用的是SpringBoot，所以使用SpringSecurity会更容易也更简单。这时候，我们只需要在Config-Server中增加如下依赖:

org.springframework.boot
        spring-boot-starter-security

此时，当我们启动Config-Server时，SpringSecurity会默认为我们生产一个访问密码，这种方式常常不是我们需要的，所以一般我们还需要在配置文件中配置用户名和密码，比如：

security.user.name=cd826
    security.user.password=pwd

这样，当我们需要访问Config-Server时就会弹出用户认证对话框。此时，对于Config-Client我们需要在配置文件中增加用户和访问口令的配置，如下：

spring.cloud.config.username=cd826
    spring.cloud.config.password=pwd

### 3.2 加密与解密 ###

访问安全是对整体的控制，多数情况下我们还需要对敏感内容加密后存储，比如之前所说的数据库访问的用户名称和登录口令。很幸运，Spring Cloud Config为我们提供相应的支持。

Spring Cloud Config提供了两种加解密方式: 1)对称加密; 2)非对称加密。在描述如何使用之前，我们先看看一些使用前提。

3.2.1 安装JCE(JAVA CRYPTOGRAPHY EXTENSION)

Spring Cloud Config所提供的加解密依赖JCE，因为，JDK中没有默认提供，所以我们需要先安装JCE。安装方法也比较简单，就是下载相应的Jar包，然后把这些包替换 `$JDK_HOME/jar/lib/security` 相应的文件，对于JDK8下载地址为:JCE for JDK8.

3.2.2 加解密端点

另外，Spring Cloud Config还提供了两个端点进行加密和解密，如下：

*  **/encrypt** : 加密端点，使用格式如下: `curl $CONFIG_SERVER/encrypt -d 所要加密的内容`
 *  **/decrypt** : 解密端点，使用格式如下: `curl $CONFIG_SERVER/decrypt -d 所要解密的内容`

注意：当你测试中所加解密中包含特殊字符时，需要进行URL编码，这时候你需要使用 `--data-urlencode` 而不是 `-d` .

3.2.3 对称加密

对称加解密的配置非常简单。我们只需要在配置文件中增加加解密所使用的密钥即可，如:

encrypt.key=cd826_key

配置好之后，你可以启动Config-Server，并使用上面所说的端点进行加解密测试。

对于，配置文件我们需要为加密的内容增加一个 `{cipher}` 前导符。如：

spring.datasource.username=dbuser
    spring.datasource.password={cipher}FKSAJDFGYOS8F7GLHAKERGFHLSAJ

但是，如果你使用的配置文件是yml格式，那么需要使用单引号把加密内容引起来，如下：

spring:
        datasource:
            username:dbuser
            password:'{cipher}FKSAJDFGYOS8F7GLHAKERGFHLSAJ'

3.2.4 非对称加密

非对称加密相对于对称加密来说复杂了一些，首先我们需要借助Java的keytool生成密钥对，然后创建Key Store并复制到服务器目录下。对于keytool的使用可以参考这里: [《Spring Cloud入门教程(番外篇四): Keytool证书工具》][Spring Cloud_ Keytool] 。

1.  使用keytool生成Key Store，命令如下:

$ keytool -genkeypair -alias tsfjckey -keyalg RSA 
      -dname "CN=Mall Web,OU=TwoStepsFromJava,O=Organization,L=city,S=province,C=china"  
      -keypass javatwostepsfrom -keystore server.jks -storepass twostepsfromjava

1.  将所生成 `server.jks` 拷贝到项目的 `resources` 目录下(Config-Server)。
2.  修改配置文件:

encrypt.key-store.location=server.jks
    encrypt.key-store.alias=tsfjckey
    encrypt.key-store.password=twostepsfromjava
    encrypt.key-store.secret=javatwostepsfrom

非对称加密相对于对称加密来说配置也复杂，但安全性也会高很多。

3.2.5 使用多个加密KEY

也许，我们需要对不同的敏感信息使用不同的加密key，这时候我们的配置文件只需要按如下进行编写:

foo.bar={cipher}{key:testkey}...

Config-Server在解密的时候就会尝试从配置文件中获取 `testkey` 的做为密钥。

## 4. 高可用配置 ##

### 4.1 整合Eureka ###

看到这里，可能有些童鞋已经发现，我们在Config-Client中配置 `config.uri` 时使用的具体的地址，那么是否可以使用之前的Eureka呢？答案是肯定，我们可以把Config-Server和其它微服务一样作为一个服务基本单元。我们只需要进行如下修改即可。

4.1.1 CONFIG-SERVER改造

在pom.xml中增加如下依赖:

org.springframework.cloud
        spring-cloud-starter-eureka

在配置文件中配置我们服务的名称，及之前我们所编写Eureka服务器的地址:

spring.application.name=config-server
    
    eureka.client.service-url.defaultZone=http://localhost:8260/eureka

启动类:

/**
     * TwoStepsFromJava Cloud -- Config Server
     *
     * @author CD826(CD826Dong@gmail.com)
     * @since 1.0.0
     */
    @SpringBootApplication
    @EnableConfigServer
    @EnableDiscoveryClient
    public class Application {
    
        public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
        }
    
    }

增加 `@EnableDiscoveryClient` 注解。

Ok，到这里为止，Config-Server修改已经完成。如果我们启动Config-Server就会在Eureka服务器上看到相应的服务注册。

4.1.2 CONFIG-CLIENT改造

在pom.xml中增加如下依赖:

org.springframework.cloud
        spring-cloud-starter-eureka

配置文件修改，注意这里的配置文件为: `bootstrap.properties` :

spring.application.name=mallWeb
    spring.cloud.config.profile=dev
    
    eureka.client.service-url.defaultZone=http://localhost:8260/eureka
    
    spring.cloud.config.discovery.enabled=true
    spring.cloud.config.discovery.service-id=config-server

修改启动类:

/**
     * TwoStepsFromJava Cloud -- Config Client Project
     *
     * @author CD826(CD826Dong@gmail.com)
     * @since 1.0.0
     */
    @EnableDiscoveryClient
    @SpringBootApplication
    public class Application {
    
        public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
        }
    
    }

这样就完成了从Eureka中获取Config-Server的服务信息。

这里最重要的就是在配置中增加: `spring.cloud.config.discovery.enabled=true` ，并将原来所配置的 `spring.cloud.config.uri` ，修改为 `spring.cloud.config.discovery.service-id` 。

### 4.2 快速失败与响应 ###

4.2.1 开启CONFIG-SERVER启动加载

默认情况下，只有当客户端请求时服务端才会从配置的Git仓库中进行加载，我们可以通过设置 `clone-on-start` ，让服务端在启动时就会加载。

spring.cloud.config.server.git.uri=https://git/common/config-repo.git
    
    spring.cloud.config.server.git.repos.team-a.pattern=team-a-*
    spring.cloud.config.server.git.repos.team-a.clone-on-start=true
    spring.cloud.config.server.git.repos.team-a.uri=http://git/team-a/config-repo.git
    
    spring.cloud.config.server.git.repos.team-b.pattern=team-b-*
    spring.cloud.config.server.git.repos.team-b.clone-on-start=false
    spring.cloud.config.server.git.repos.team-b.uri=http://git/team-b/config-repo.git
    
    spring.cloud.config.server.git.repos.team-c.pattern=team-c-*
    spring.cloud.config.server.git.repos.team-c.uri=http://git/team-a/config-repo.git

上面的配置，对于 `team-a` 的则在 **Config-Server** 启动时就会加载相应的配置，而对于其它则不会。当然，我们可以通过设置 `spring.cloud.config.server.git.clone-on-start` 的值来进行全局配置。

4.2.2 开启CONFIG-CLIENT快速失败

在一些情况下，我们希望启动一个服务时无法连接到服务端能够快速返回失败，那么可以通过下面的配置来设置:

spring.cloud.config.fail-fast=true

4.2.3 设置CONFIG-CLIENT重试

如果在启动时Config-Server碰巧不可以使用，你还想后面再进行重试，那么我们开始开启Config-Client的重试机制。首先，我们需要配置：

spring.cloud.config.fail-fast=true

然后，我们需要在我们的的依赖中增加：

org.springframework.retry
        spring-retry
    
        org.springframework.boot
        spring-boot-starter-aop

这样，我们就可以为Config-Client开启了重试机制，当启动连接Config-Server失败时，Config-Client会继续尝试连接Config-Server，默认会尝试连接6次，时间间隔初始为1000毫秒，后面每次尝试连接会按照1.1倍数增加尝试连接时间的间隔，如果最后还不能够连接到Config-Server才会返回错误。我们可以通过在配置文件中复写 `spring.cloud.config.retry.*` 来进行相关配置。

如果你想全权控制重试机制，可以实现一个类型为: `RetryOperationsInterceptor` 的类，并把bean的id设置为: `configServerRetryInterceptor` 。

### 4.3 动态刷新配置 ###

Config-Client中提供了一个 `refresh` 端点来实现配置文件的刷新。要想使用该功能，我们需要在Config-Client的pom.xml文件中增加以下依赖:

org.springframework.boot
        spring-boot-starter-actuator

这样，当修改配置文件并提交到Git仓库后，就可以使用: [http://localhost:8080/refresh][http_localhost_8080_refresh] 刷新本地的配置数据。

但是，最好的方式还是和Spring Cloud Bus进行整合，这样才能实现配置的自动分发，而不是需要手工去刷新配置。

[9866e2210fab3260af081dafa8fb5ed0.png]: https://img.colabug.com/2018/01/9866e2210fab3260af081dafa8fb5ed0.png
[http_localhost_8080_cfg_foo]: https://www.colabug.com/goto/aHR0cHM6Ly9saW5rLmppYW5zaHUuY29tLz90PWh0dHAlM0ElMkYlMkZsb2NhbGhvc3QlM0E4MDgwJTJGY2ZnJTJGZm9v
[e7fe9a8bf03f0fb4c15ac76d85668194.png]: https://img.colabug.com/2018/01/e7fe9a8bf03f0fb4c15ac76d85668194.png
[Spring Cloud_ Keytool]: https://www.colabug.com/goto/aHR0cHM6Ly9saW5rLmppYW5zaHUuY29tLz90PSUyNUU4JTI1QTElMjVBNSUyNUU1JTI1ODUlMjU4NSUyNUU5JTI1OTMlMjVCRSUyNUU2JTI1OEUlMjVBNQ==
[http_localhost_8080_refresh]: https://www.colabug.com/goto/aHR0cHM6Ly9saW5rLmppYW5zaHUuY29tLz90PWh0dHAlM0ElMkYlMkZsb2NhbGhvc3QlM0E4MDgwJTJGcmVmcmVzaA==