Spring Cloud之Finchley版学习（二十）-Spring Cloud Config-Git仓库配置详解

在 Spring Cloud之Finchley版学习（十九）-配置中心-Spring Cloud Config 一节中，已实现使用Git仓库作为Config Server的后端存储，本节详细探讨如何配置Git仓库。

一、占位符支持

Config Server的占位符支持{application}、{profile}和{label}。

示例：

server:
  port: 8080
spring:
  application:
    name: microservice-config-server
  cloud:
    config:
      server:
        git:
          uri: https://git.oschina.net/itmuch/{application}
          username:
          password:

使用这种方式，即可轻松支持一个应用对应一个Git仓库。同理，也可支持一个profile对应一个Git仓库。

二、模式匹配

模式匹配指的是带有通配符的{application}/{profile}名称的列表。如果{application}/{profile}不匹配任何模式，它将会使用 spring.cloud.config.server.git.uri 定义的URI。

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

该例中，对于simple仓库，它只匹配所有配置文件中名为simple的应用程序，它的模式等同于 simple/* 。local仓库则匹配所有配置文件中以local开头的所有应用程序的名称。

三、搜索目录

很多场景下，我们可能把配置文件放在了Git仓库子目录中，此时可以使用search-paths指定，search-path同样支持占位符。

spring:
  cloud:
    config:
      server:
        git:
          uri: http://git.oschina.net/itmuch/spring-cloud-config-repo
          search-paths: foo,bar*

这样，Config Server就会在Git仓库根目录、foo子目录、以及所有以bar开始的子目录中查找配置文件。

四、启动时加载配置文件

默认情况下，在配置被首次请求时，Config Server才会clone Git仓库。我们也可让Config Server在启动时就clone Git仓库，例如。

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          repos:
            team-a:
                pattern:  microservice-*
                clone-on-start: true
                uri: http://git.oschina.net/itmuch/spring-cloud-config-repo

将属性 spring.cloud.config.server.git.repos.*.clone-on-start 设为true，即可让Config Server启动时clone指定Git仓库。

当然，也可使用 spring.cloud.config.server.git.clone-on-start = true 进行全局配置。

配置clone-on-start = true，可帮助Config Server启动时快速识别错误的配置源（例如无效的Git仓库）。

小技巧

将以下包的日志级别设为DEBUG，即可打印Config Server请求Git仓库的细节。我们可借助日志，更好地理解Config Server的Git仓库配置，同时，也便于我们快速定位问题。

logging:
  level:
    org.springframework.cloud: DEBUG
    org.springframework.boot: DEBUG