一、基本使用
1. Config-Server端
(1)pom:
- parent依赖
org.springframework.boot spring-boot-starter-parent 2.0.3.RELEASE - dependencyManagement
org.springframework.cloud spring-cloud-dependencies Finchley.RELEASE pom import - dependencies
org.springframework.cloud spring-cloud-config-server
org.springframework.boot spring-boot-starter-parent 2.0.3.RELEASE 4.0.0 ConfigServer 1.0.0 jar UTF-8 1.8 1.8 org.springframework.cloud spring-cloud-dependencies Finchley.RELEASE pom import org.springframework.cloud spring-cloud-config-server
(2)启动类:增加注解@EnableConfigServer,当然@SpringBootApplication也是必不可少的
package com.luych.configServer;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.cloud.config.server.EnableConfigServer;@SpringBootApplication@EnableConfigServerpublic class ConfigServerApplication { public static void main(String[] args) { SpringApplication.run(ConfigServerApplication.class, args); }}
(3)application.yml
如果用git作配置仓库,则:
spring: cloud: config: server: git: uri: https://gitee.com/LOVE0612/SpringCloud.git username: 562759534@qq.com password: 123@abc
- 如果希望ConfigServer启动的时候就将配置文件clone下来,则可增加配置:spring.cloud.config.server.git.clone-on-start=true。
- 如果配置文件不在git仓库的根目录下, 例如:如果配置文件在git仓库的properties目录下,则可增加配置spring.cloud.config.server.git.search-paths=properties。当有多个目录时逗号分隔。
- 如果需要制定git clone后在本地存储位置,则可增加配置spring.cloud.config.server.git.baseDir。
如果用svn作配置仓库,则:
spring: cloud: config: server: svn: uri: https://192.168.1.111/svn/SpringCloud username: luyanchao password: abc@123
- 同样存在spring.cloud.config.server.svn.search-paths配置项,使用方法同git。
- 同样存在spring.cloud.config.server.git.baseDir配置项,使用方法同git。
如果使用本地文件系统作配置仓库,则:
spring: cloud: config: server: native: search-locations: properties profile: native
- search-locations:可以是绝对路径也可以是classpath路径。
- 使用本地文件系统作为配置仓库的最大缺点在于:如果ConfigServer多点部署以保证高可用时,需要将文件系统进行共享。
如果使用多种/多个配置仓库,则:
spring: cloud: config: server: git: uri: https://gitee.com/LOVE0612/SpringCloud.git username: 562759534@qq.com password: 1226ai0612 order: 1 svn: uri: https://192.168.1.111/svn/SpringCloud username: luyanchao password: abc@123 order: 2 native: search-locations: properties order: 3 profile: native, git, svn
- profile:设定哪些配置仓库可用,逗号分隔
- order:配置仓库的优先级顺序,数字越低优先级越高
server: port: 51011spring: application: name: ConfigServer cloud: config: server: git: uri: https://gitee.com/LOVE0612/SpringCloud.git search-paths: properties username: 562759534@qq.com password: 123@abc clone-on-start: true
(3)run,并测试
ConfigServer提供多种rest接口访问配置信息,可通过run日志查看:
Mapped "{[/{name}-{profiles}.properties],methods=[GET]}" onto ...Mapped "{[/{name}-{profiles}.yml || /{name}-{profiles}.yaml],methods=[GET]}" onto ...Mapped "{[/{name}/{profiles:.*[^-].*}],methods=[GET]}" onto ...Mapped "{[/{label}/{name}-{profiles}.properties],methods=[GET]}" onto ...Mapped "{[/{label}/{name}-{profiles}.json],methods=[GET]}" onto ...Mapped "{[/{label}/{name}-{profiles}.yml || /{label}/{name}-{profiles}.yaml],methods=[GET]}" onto...Mapped "{[/{name}/{profiles}/{label:.*}],methods=[GET]}" onto ...Mapped "{[/{name}-{profiles}.json],methods=[GET]}" onto ...Mapped "{[/{name}/{profile}/{label}/**],methods=[GET],produces=[application/octet-stream]}" onto ...Mapped "{[/{name}/{profile}/{label}/**],methods=[GET]}" onto ...Mapped "{[/{name}/{profile}/**],methods=[GET],params=[useDefaultLabel]}" onto...
- 参数name:即ConfigClient中定义的spring.application.name的值,后续会讲到
- 参数profiles:这个不需要多说,用过SpringBoot的应该都知道
- 参数label:如果是git或svn,label对应的是分之;如果是本地文件系统,label对应子目录名,例如:classpath:properties/{label}
2. Config-Client端
(1)pom:
- parent依赖
org.springframework.boot spring-boot-starter-parent 2.0.3.RELEASE - dependencyManagement
org.springframework.cloud spring-cloud-dependencies Finchley.RELEASE pom import - dependencies
org.springframework.cloud spring-cloud-config-client
(2)启动类:有@SpringBootApplication即可
(3)bootstrap.yml,注意这里不是application.yml哦
spring: application: name: ServiceGateway cloud: config: uri: http://127.0.0.1:51011 profile: company
- spring.application.name:项目名称
- spring.cloud.config.uri:ConfigServer的地址
- spring.cloud.config.profile:这个不需要多说,用过SpringBoot的应该都知道
根据以上配置内容,可得知最终调用ConfigServer的接口地址为:http://127.0.0.1:51011/ServiceGateway-company.yml
3. 多个Config-Client端公用配置
如果多个Config-Client中有部分配置是相同的,为了避免出现重复代码,我们可以把这部分相同的配置抽出来单独做一个配置文件,命名为:application.yml、application.properties,或application-*.yml、application-*.properties,然后放到Config-Server端即可。