转载

带你入门SpringCloud统一配置 | SpringCloud Config

前言

在微服务中众多服务的配置必然会出现相同的配置，如果配置发生变化需要修改，一个个去修改然后重启项目的方案是绝对不可取的。而 SpringCloud Config 就是一个可以帮助你实现统一配置选择之一。

如果你不懂 SpringCloud Config 环境搭建，那么该篇博客将会帮助到你，文中通过具体操作带你了解 SpringCloud Config 环境搭建的入门操作。

阅读本文需要你熟悉 SpringBoot 项目的基本使用即可，还有一点需要注意的是在操作过程中尽量和我本地环境一致，因为环境不一致可能会带来一些问题。我本地环境如下：

SpringBoot Version: 2.1.0.RELEASE
SpringCloud Version: Greenwich.RELEASE
Apache Maven Version： 3.6.0
Java Version： 1.8.0_144
IDEA：Spring Tools Suite (STS)

接下来就开始 SpringCloud Config 环境搭建操作介绍！

搭建 SpringCloud Config 环境

SpringCloud Config 环境搭建最小环境需要 3个 SpringCloud 项目：一台 Eureka Server 端、一台 Config Server 端（也是Eureka Client 端）、一台普通服务端（即是 Config Client 也是 Eureka Client）。

关于Eureka环境的搭建请参考我的另一篇博客带你入门SpringCloud服务发现 | Eurka搭建和使用

Config Server 端搭建

在 SpringBoot 项目中引入 spring-cloud-config-server 和 spring-cloud-starter-netflix-eureka-client 依赖，具体代码如下：

<dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-config-server</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>

在 SpringBoot Application 上声明 @EnableDiscoveryClient 和 @EnableConfigServer，具体代码如下：

@SpringBootApplication
@EnableDiscoveryClient
@EnableConfigServer
public class SpringCloudConfigServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringCloudConfigServerApplication.class, args);
    }

}

在 GitHub上创建私有仓库

带你入门SpringCloud统一配置 | SpringCloud Config

然后添加配置信息到 GitHub 上。

带你入门SpringCloud统一配置 | SpringCloud Config

product.properties 配置可以添加一些公共的配置他会覆盖到 product-dev.properties上

在 application.properties 添加配置信息

spring.application.name=CONFIGSERVER
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/

spring.cloud.config.server.git.uri=https://github.com/zhuoqianmingyue/config-repo
spring.cloud.config.server.git.username=github帐号
spring.cloud.config.server.git.password=github帐号密码
spring.cloud.config.server.git.basedir=config-repo/config-repo

spring.application.name：服务的名称
eureka.client.service-url.defaultZone：Eureka Server 地址
spring.cloud.config.server.git.uri：配置GitHub 私有仓库 HTTP 克隆地址
spring.cloud.config.server.git.username：配置你的 github帐号
spring.cloud.config.server.git.password：配置你的github帐号密码
spring.cloud.config.server.git.basedir：克隆配置文件存储地址

Config Server 端高可用只需要配置多台Config Server注册到Eureka 服务端即可。

测试

第一步启动 Eurka Server 端（具体代码请从我的GitHub项目获取，GitHub地址下面有介绍）

将 spring-cloud-config-eureka-service 进行打包，通过 mvn clean package -Dmaven.test.skip=true 。

带你入门SpringCloud统一配置 | SpringCloud Config

进入 target 目录通过 java -jar 方式启动。

带你入门SpringCloud统一配置 | SpringCloud Config

第二步启动 Config Server 端

带你入门SpringCloud统一配置 | SpringCloud Config

第三步最后访问 Eurka Server 端，如下图所示：

CONFIGSERVER 已经注册到 Eurka Server 服务端。

带你入门SpringCloud统一配置 | SpringCloud Config

访问 Config Server 端获取配置信息，具体访问地址： http://localhost :8080/product-dev.properties。访问结果如下图所示：

带你入门SpringCloud统一配置 | SpringCloud Config

到这里 Config Server 端搭建介绍完毕！接下来开始 Config Client 端搭建介绍。

Config Client 端搭建(商品服务)

在商品服务 SpringBoot 项目中引入 spring-cloud-config-client 和 spring-cloud-starter-netflix-eureka-client 依赖。具体代码如下：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-client</artifactId>
</dependency>

在 SpringBoot Application上声明 @EnableDiscoveryClient

@SpringBootApplication
@EnableDiscoveryClient
public class SpringCloudConfigProductServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringCloudConfigProductServiceApplication.class, args);
    }

}

在 srcmainresources 目录下创建 bootstrap.properties，具体代码如下：

spring.cloud.config.discovery.service-id=CONFIGSERVER
spring.cloud.config.discovery.enabled=true
spring.cloud.config.profile=dev
spring.application.name=product

eureka.client.service-url.defaultZone=http://localhost:8761/eureka/

spring.cloud.config.discovery.service-id：Config Server 服务名
spring.cloud.config.discovery.enabled：是否开启配置发现
spring.cloud.config.profile：启用那个后缀的配置文件
eureka.client.service-url.defaultZone：Eureka Server 地址
spring.application.name：服务的名称

连接接Config Server配置 spring.cloud.config.xx 和 eureka Server 端配置eureka.client.service-url.defaultZone= http://localhost :8761/eureka/ 一定要配置到bootstrap.properties中，否则根不获取不到 Config Server 的配置信息。

测试

第一步启动 Eurka Server端和 Config Server 端。

第二步启动 Config Client (商品服务) 端

第三步访问 Eurka Server 端，如下图所示：

PRODUCT 已经注册到 Eurka Server 服务端。

带你入门SpringCloud统一配置 | SpringCloud Config

第四步：编写获取 Config Server 上配置信息的 Controller，具体代码如下：

获取的就是红色框的 env 配置项的值。

带你入门SpringCloud统一配置 | SpringCloud Config

@RestController
public class EvnController {
    @Value("${env}")
    private String env;
    
    @RequestMapping("/env")
    public String evn() {
        return this.env;
    }
}

游览器访问 localhost:8763/product/env 进行测试，具体结果如下：

带你入门SpringCloud统一配置 | SpringCloud Config