springcloud入门系列(4)-configserver

之前做的例子里使用的都是本地的aplication配置文件，每次要更新配置文件都需要在每台机器上手动更新后重启，springcloud支持很多种方式的分布式配置管理方式，默认支持的是Git管理各个微服务的配置文件方式，也可以使用svn或者本地文件，其实原理都是一样的，都是从代码管理库中获取到对应微服务的配置文件，然后在微服务启动的时候加载这些远程版本管理库中的配置文件到本地，使用的时候就像使用本地配置文件一样，当git或者svn或者本地文件更新的时候，通过消息的方式通知到相关微服务进行本地配置文件的重新下载和更新，这样做到不用重启服务就能更新配置文件的效果。

Screenshot 2017-08-08 20.15.56.png

图中展示的就是config配置服务器高可用的一个架构图，后面的git版本库也可以配置多台组成HA高可用，在网上可以找到很多通过Git进行配置文件管理的案例，由于公司生产网络没有git环境，我相信大部分公司在生产网络都没有git环境，起码我待过的几家公司在生产网络都没有版本控制的服务器，所以今天主要给大家讲解下config server本地配置文件的方案，其实很git没有本质上的区别。实现起来也是非常简单。

1. 添加config依赖

    org.springframework.cloud
    spring-cloud-config-server

2.启动类增加config注解

在Application启动类中增加@EnableConfigServer注解，这样在启动的时候springboot就会自动去将该服务注册为一个config server。

3. 配置文件路径、git地址

在整个configserver中最重要的就是配置git的地址和配置文件的路径了，我们先说下git如何配置

spring:
  application:
    name: springcloud-config-server
  profiles:
    active: native
  cloud:
    config:
      server:
        git:
          uri:  https://github.com/spring-cloud-samples/config-repo
#          #username:
#          #password:
server:
  port: 1101

在配置文件中，需要配置git的uri地址，可以配置多条地址，用于git的HA保证高可用。如果git有密码还需要在下面设置username和password。

下面我们再介绍下使用本地配置文件的配置方式。

spring:
  application:
    name: springcloud-config-server
  profiles:
    active: native
  cloud:
    config:
      server:
        native:
          searchLocations: classpath:/properties/
server:
  port: 1101

可以发现唯一的区别就是在之前配置git的地方换成了native的标签，并且设置了搜索本地配置文件的路径，这个路径可以配置成相对路径，也可以配置成绝对路径。

4. 微服务配置文件

之前看了很多配置文件的访问方式，都说的比较含糊，自己也是试了很长时间才理清楚配置文件和微服务的正则关系。这里贴下官网的访问配置信息的URL与配置文件的映射关系。
/{application}/{profile}[/{label}]
/{application}-{profile}.yml
/{label}/{application}-{profile}.yml
/{application}-{profile}.properties
/{label}/{application}-{profile}.properties
上面的url会映射{application}-{profile}.properties对应的配置文件，其中{label}对应Git上不同的分支，默认为master。我们可以尝试构造不同的url来访问不同的配置内容，比如，要访问master分支，config-client应用的dev环境，就可以访问这个url：http://localhost:1101/config-client/dev/master
这里推荐大家使用yml为每个微服务进行参数配置，这样通过一个yml就可以配置各个环境的参数，管理起来会比较容易而且不容易出问题。先看个例子：

spring:
  profiles: default
server:
  port: 8080
management:
  security:
    enabled: false
urleureka: http://node0:8760/eureka
---

spring:
  profiles: dev
server:
  port: 8082
management:
    security:
      enabled: false
urleureka: http://node2:8763/eureka
---

spring:
  profiles: prd
server:
  port: 8081
management:
  security:
    enabled: false
urleureka: http://node1:8761/eureka

可以看到例子中通过－－－将配置文件分割为了3段，在yml中通过这样的分隔表示是3个不同的配置单元，每个配置单元都通过profiles来进行区分。

5.client端配置

服务端完成配置后，就可以在客户端进行配置了，客户端配置其实很简单就。首先也是增加config库的依赖。

    org.springframework.cloud
    spring-cloud-starter-config

接着在启动类中需要增加configclient的注解@EnableEurekaClient。
client端为了能在启动的时候去主动加载configserver的配置文件需要配置bootstrap.yml这个配置文件，很多同学会问这个bootstrap.yml和application.yml有什么区别，主要的区别就在于，bootstrap.yml会最优先去加载是第一个加载的配置文件，所以把设置取configserver端的哪个配置文件放在这里配置。直接来看例子。

#指定属性文件名 usercenter-provider-dev.yml,是有命名规则的

spring:
  application:
    name: usercenter-provider
  profiles:
      active: dev
  cloud:
    config:
      uri: http://node1:1101
      label: master

可以看到这里profiles.active配置了dev，这样在找到对应微服务的配置文件后就会去找到dev对应的profile节点，然后获取dev节点中的配置信息，这里的dev是和上面介绍的服务端放置的那个配置文件里的名字叫dev的profile对应的。下面的uri配置的就是config server的路径，也可以不配置uri配置成serviceId，这样就可以通过eureka来实现软负载了，但是需要在config server中配置eurekaclient在eureka上注册服务。最后一个label表示git的分支，默认是master，如果是像本例中配置的本地文件的方式，也可以在config server端管理的微服务配置文件中设置label来模拟版本管理工具中的branch。
这样就可以以此启动config server和微服务的client了，启动后就可以发现在client端通过@Value("${urleureka}")就可以获取到配置文件中的变量，是不是很方便，urleureka就是配置的变量名。