每天学习一点点 编程PDF电子书、视频教程免费下载：
http://www.shitanlife.com/code
一、简介
Spring Cloud Config为分布式系统中的外部配置提供服务器和客户端支持。使用Config Server，您可以为所有环境中的应用程序管理其外部属性。它非常适合spring应用，也可以使用在其他语言的应用上。随着应用程序通过从开发到测试和生产的部署流程，您可以管理这些环境之间的配置，并确定应用程序具有迁移时需要运行的一切。服务器存储后端的默认实现使用git，因此它轻松支持标签版本的配置环境，以及可以访问用于管理内容的各种工具。
Spring Cloud Config服务端特性
- HTTP，为外部配置提供基于资源的API（键值对，或者等价的YAML内容）
- 属性值的加密和解密（对称加密和非对称加密）
- 通过使用@EnableConfigServer在Spring boot应用中非常简单的嵌入。
Config客户端的特性（特指Spring应用）
- 绑定Config服务端，并使用远程的属性源初始化Spring环境。
- 属性值的加密和解密（对称加密和非对称加密）
入门示例：
只要classpath下有Spring Boot Actuator和Spring Config Client，Spring Boot应用就会尝试连接配置服务http://localhost:8888，这个地址是spring.cloud.config.uri的默认地址。如果你想修改这个地址，你可以在bootstrap.[yml或properties]中设置spring.cloud.config.uri或者通过系统属性或者通过环境变量。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
@Configuration@EnableAutoConfiguration@RestControllerpublic class Application { @Value("${config.name}") String name = "World"; @RequestMapping("/") public String home() { return "Hello " + name; } public static void main(String[] args) { SpringApplication.run(Application.class, args); }} |
上面例子中的config.name可以来自本地的配置文件，也可以来自远程的配置服务。默认情况下，远程的配置服务将优先使用。
为了运行你自己的配置服务中心，你可以使用spring-cloud-config-server依赖，和@EnableConfigServer注解。如果你设置了spring.config.name=configserver，应用将会运行在8888端口，并且从一个样本仓库提供数据。你需要设置spring.cloud.config.server.git.uri来指定你自己的配置数据。默认的，它是一个git仓库，也可以配置成本地的文件系统。
二、Spring Cloud Config服务端
服务器为外部配置（键称值对或等效的YAML内容）提供了基于资源的HTTP。它可以在Spring Boot应用中使用@EnableConfigServer内嵌。例子如下：
|
1
2
3
4
5
6
7
8
|
@SpringBootApplication@EnableConfigServerpublic class SpringCloudConfigServerApplication { public static void main(String[] args) { SpringApplication.run(SpringCloudConfigServerApplication.class, args); }} |
像所有的Spring Boot应用一样，它默认运行在8080端口，你可以通过多种方式将其切换到8888端口。最简单的可以设置spring.config.name=configserver（在Config Server的jar包有一个configserver.yml），它设置了一个默认的配置仓库。另外一种方式是使用你自己的application.properties，这也是小编推荐的方式：
|
1
2
|
server.port: 8888spring.cloud.config.server.git.uri: git地址 |
git地址中是你的YAML或者properties文件。
环境仓库
你想在哪里存储配置数据？支持这种行为的策略是EnvironmentRepository，它服务于Environment实例。这个Environment是Spring Environment的一个浅副本。Environment通过3个变量被参数化。
- {application}映射客户端的"spring.application.name"
- {profile}映射客户端的"spring.profiles.active"（逗号分隔列表）
- {label}它是服务端的特性，标记版本的一组配置文件
仓库的实现通常表现的像Spring boot加载配置文件一样，"spring.config.name"等于{application}参数， "spring.profiles.active" 等于{profile}参数。profiles的优先规则和正常的规则是一样的，活动的profiles优于默认的。如果有多个profiles，则最后一个胜出。
客户端的配置实例：
|
1
2
3
4
5
|
spring: application: name: foo profiles: active: dev,mysql |
在Spring Boot应用中，这些参数也可以通过环境变量或者命令行参数设置。
git后端
EnvironmentRepository的默认实现是使用git后端，它对管理更新、物理环境和审核更改非常的方便。要改变仓库的地址，你可以在配置服务端设置"spring.cloud.config.server.git.uri"属性（在application.properties文件中）。如果你用file:开头设置它，它将从本地仓库运行，这样可以在没有服务端的情况下非常快速和简单的启动。这种情况，服务端将直接在本地仓库中运行。为了扩展配置服务并使它高可用，你需要把服务的所有实例指向同一个仓库，因此只有共享文件系统可以工作。即使在这种情况下，最好使用共享文件系统存储库的ssh:协议，以便服务器可以将其克隆并使用本地工作副本作为缓存。
该仓库的实现将HTTP资源中的{label}参数映射到git的标签（提交id、分支名称或者tag）。如果git分支或者tag名称中包含“/”，则HTTP URL中的label要使用特殊字符“(_)”代替。例如：如果分支的名称是foo/bar，则HTTP中的label的格式为foo(_)bar。这个特殊字符也可以用到{application}参数中。
git URI中的占位符
Spring Cloud Config Server支持在git URL中使用占位符，使用{application} 和 {profile}（如果使用{label}，请记住它是使用在git标签中的）。因此你可以轻松的支持“一个应用一个仓库”的原则。如下：
|
1
2
3
4
5
6
|
spring: cloud: config: server: git: uri: https://github.com/myorg/{application} |
或者一个环境一个仓库的原则，使用{profile}代替{application}。另外在{application}参数中使用特殊字符"(_)"可以支持多组织。
|
1
2
3
4
5
6
|
spring: cloud: config: server: git: uri: https://github.com/{application} |
{application}参数的格式为"organization(_)application"。
模式匹配和多仓库
在{application}和{profile}参数中使用模式匹配可以支持更多复杂的需求。模式的格式是一组逗号分隔的{application}/{profile}，其中的参数可以使用通配符。例如：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
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 |
如果{application}/{profile}没有匹配到任何模式，它将使用默认的仓库地址:spring.cloud.config.server.git.uri。上面的例子中，"simple"仓库匹配的是“simple/*”（它仅仅匹配一个仓库simple，在所有的环境下）。"local"仓库将匹配所有{application}的名字以“local”开头的，并且也是在所有的环境下。“/*”前缀自动添加到所有没有设置{profile}的模式中。
每一个仓库也可以在子目录下存储配置文件，模式匹配也可以用于搜索这些目录，需要制定searchPaths，如下：
|
1
2
3
4
5
6
7
|
spring: cloud: config: server: git: uri: https://github.com/spring-cloud-samples/config-repo searchPaths: foo,bar* |
上面的例子中，将在foo和以bar开头的目录中，搜索配置文件。
默认地，服务器在第一次请求配置文件时克隆远程的仓库，服务器也可以配置在启动的时候克隆仓库，如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
spring: cloud: config: server: git: uri: https://git/common/config-repo.git repos: team-a: pattern: team-a-* cloneOnStart: true uri: http://git/team-a/config-repo.git team-b: pattern: team-b-* cloneOnStart: false uri: http://git/team-b/config-repo.git team-c: pattern: team-c-* uri: http://git/team-a/config-repo.git |
在上面的例子team-a的仓库将在服务端启动时进行克隆，其他的仓库将在第一次请求时克隆。
认证
如果远程的git仓库需要用户名和密码，可以参照下面的例子
|
1
2
3
4
5
6
7
8
|
spring: cloud: config: server: git: uri: https://github.com/spring-cloud-samples/config-repo username: trolley password: strongpassword |
到此，Spring Cloud Config服务端就介绍到这里，还有一些不常用的功能在这里就不介绍了，大家可以参照spring cloud官网。Spring Cloud Config服务端的代码示例可以参照我的GitHub地址：https://github.com/bigbugliu/spring-cloud-config-server。
三、Spring Cloud Config 客户端
Spring Boot应用可以立即使用Spring Config Server。只要在classpath中有Spring Cloud Config Client的jar包，这个应用就会请求配置的服务端。他将使用绑定的配置服务器（spring.cloud.config.uri中配置的）的属性初始化spring环境。
在某些情况下，如果服务无法连接到配置服务器，则可能希望启动服务失败。如果这是所需的行为，请设置引导配置属性spring.cloud.config.failFast=true，客户端将以异常停止。
如果您希望配置服务器在您的应用程序启动时可能偶尔不可用，您可以要求它在发生故障后继续尝试。首先，您需要设置spring.cloud.config.failFast=true，然后您需要将spring-retry和spring-boot-starter-aop添加到您的类路径中。默认行为是重试6次，初始退避间隔为1000ms，指数乘数为1.1，用于后续退避。您可以使用spring.cloud.config.retry.*配置属性配置这些属性（和其他）。