SpringCloud之配置中心Config（高可用）

墨蓝 2022-01-21 03:35 385阅读 0赞

# 前言 #

SpringCloud 是微服务中的翘楚，最佳的落地方案。

Spring Cloud Config 是一个解决分布式系统的配置管理方案，它包含了 server 和 client 两个部分。

server 用来获取远程的配置信息（默认为 Git 仓库），并且以接口的形式提供出去；

client 根据 server 提供的接口读取配置文件，以便于初始化自己的应用。

如果配置中心出现了问题，将导致灾难性的后果，因此在生产环境下配置中心都会做集群，来保证高可用。

此处配置高可用实际就是把多个配置中心（指定同一个 Git 远程仓库）注册到注册中心。

# 源码 #

GitHub地址：[https://github.com/intomylife/SpringCloud][https_github.com_intomylife_SpringCloud]

# 环境 #

*  JDK 1.8.0 +
 *  Maven 3.0 +
 *  SpringBoot 2.0.3
 *  SpringCloud Finchley.RELEASE

# 开发工具 #

*  IntelliJ IDEA

# 正文 #

## commons 工程 ##

### commons 工程 - POM 文件 ###

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        
        <groupId>com.zwc</groupId>
        <artifactId>springcloud-config-eureka-commons</artifactId>
        <version>1.0</version>
    
        
        <name>springcloud-config-eureka-commons</name>
        <description>公用工程</description>
    
        
        <packaging>jar</packaging>
    
        
        <properties>
            
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            
            <java.version>1.8</java.version>
    
            
            <platform-bom.version>Cairo-SR3</platform-bom.version>
    
            
            <spring-cloud-dependencies.version>Finchley.RELEASE</spring-cloud-dependencies.version>
        </properties>
    
        
        <dependencies>
    
        </dependencies>
    
        
        
        
        
        <dependencyManagement>
            <dependencies>
                
                <dependency>
                    <groupId>io.spring.platform</groupId>
                    <artifactId>platform-bom</artifactId>
                    <version>${platform-bom.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
                
                <dependency>
                    <groupId>org.springframework.cloud</groupId>
                    <artifactId>spring-cloud-dependencies</artifactId>
                    <version>${spring-cloud-dependencies.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
    
        
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    
    </project>

*  配置一些共用依赖

### commons 工程 - 项目结构 ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDAyMjAw_size_16_color_FFFFFF_t_70][]

## 配置文件 ##

创建一个 Git 库，里面存放配置文件，文件夹名称为：config-repo；这里模拟不同的环境，所以分别构建了

dev（开发）、uat（测试）以及 online（线上）三种不同的配置文件；此文件夹存在此项目的根目录中

- springcloud-config-eureka
     
      - config-repo
     
        - system-dev.properties
     
        - system-online.properties
     
        - system-uat.properties
     
      + springcloud-config-eureka-commons
      
      + springcloud-config-eureka-service

## service 工程 ##

**  ① 此工程下有四个模块：一个注册中心，二个 server 以及一个 client**

**  ② 二个 server 除端口不一致以外，其他代码基本一致**

### registry-service（注册中心） ###

### registry-service - POM 文件 ###

*  主要加入 spring-cloud-starter-netflix-eureka-server 依赖

### registry-service - application.yml 配置文件 ###

# 端口
    server:
      port: 8761
    
    # 应用名称
    spring:
      application:
        name: eureka-server
    
    eureka:
      instance:
        # 使用 ip 代替实例名
        prefer-ip-address: true
        # 实例的主机名
        hostname: ${spring.cloud.client.ip-address}
        # 实例的 ID 规则
        instance-id: ${spring.cloud.client.ip-address}:${spring.application.name}:${server.port}
      client:
        # 是否向注册中心注册自己
        registerWithEureka: false
        # 是否向注册中心获取注册信息
        fetchRegistry: false
        serviceUrl:
          # 注册中心地址
          defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

*  这里使用了默认的 8761 端口，当然也可以更改，不过在发现调用服务端的注册中心地址端口要与它一致

### registry-service - 启动类 ###

package com.zwc;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;
    
    @SpringBootApplication
    @EnableEurekaServer
    public class SpringcloudConfigEurekaRegistryServiceApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(SpringcloudConfigEurekaRegistryServiceApplication.class, args);
        }
    
    }

*  在启动类中添加 @EnableEurekaServer 注解表示此工程是注册中心

### registry-server - 启动项目 ###

1. 项目启动成功后访问 [http://localhost:8761/][http_localhost_8761] 即可看到 eureka-server 主页面

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDAyMjAw_size_16_color_FFFFFF_t_70 1][]

### server（获取远程的配置信息） ###

### server - POM 文件 ###

**注：一共有两个 server，但是除端口以外的代码基本上一致，所有这里就列举其中一个**

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        
        <parent>
            <groupId>com.zwc</groupId>
            <artifactId>springcloud-config-eureka-service</artifactId>
            <version>1.0</version>
        </parent>
    
        
        <groupId>com.zwc</groupId>
        <artifactId>springcloud-config-eureka-serverfirst-service</artifactId>
        <version>1.0</version>
    
        
        <name>springcloud-config-eureka-serverfirst-service</name>
        <description>config server</description>
    
        
        <packaging>jar</packaging>
    
        
        <properties>
    
        </properties>
    
        
        <dependencies>
            
            <dependency>
                <groupId>com.zwc</groupId>
                <artifactId>springcloud-config-eureka-commons</artifactId>
                <version>1.0</version>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-config-server</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
            </dependency>
        </dependencies>
    
        
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    
    </project>

*  加入 spring-cloud-config-server 依赖：config server
 *  加入 spring-cloud-starter-netflix-eureka-client 依赖：提供和注册服务

### server - application.yml 配置文件 ###

# 端口
    server:
      port: 8000
    
    spring:
      application:
        # 应用名称
        name: config-eureka-server
      cloud:
        config:
          server:
            git:
              # 仓库地址
              uri: https://github.com/intomylife/SpringCloud
              # 对应 {label} 部分，即 Git 的分支
              label: master
              # 仓库文件夹名称，多个以逗号分隔
              search-paths: springcloud-config-eureka/config-repo
              # git 仓库用户名（公开库可以不用填写）
              username:
              # git 仓库密码（公开库可以不用填写）
              password:
    
    eureka:
      instance:
        # 使用 ip 代替实例名
        prefer-ip-address: true
        # 实例的主机名
        hostname: ${spring.cloud.client.ip-address}
        # 实例的 ID 规则
        instance-id: ${spring.cloud.client.ip-address}:${spring.application.name}:${server.port}
      client:
        serviceUrl:
          # 注册中心地址
          defaultZone: http://${eureka.instance.hostname}:8761/eureka/

*  **注意这里 uri 只能写到仓库名**
 *  **如果配置文件在仓库中多层目录下，那么 search-paths 就从根目录开始写起**
 *  **注意此处配置注册中心地址的端口为 8761 也就是上面注册中心工程配置的端口**

### server - 启动类 ###

package com.zwc;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.cloud.config.server.EnableConfigServer;
    import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
    
    @SpringBootApplication
    @EnableConfigServer
    @EnableEurekaClient
    public class SpringcloudConfigEurekaServerfirstServiceApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(SpringcloudConfigEurekaServerfirstServiceApplication.class, args);
        }
    
    }

*  添加 @EnableConfigServer 注解表示开启配置中心
 *  添加 @EnableEurekaClient 注解表示此工程可以向注册中心提供服务

### server -  启动项目 ###

1. 项目启动成功后访问：[http://localhost:8761/][http_localhost_8761]（注册中心）可以看到服务已经被注册进来了

![20190608000311638.png][]

2. 访问地址：[http://localhost:8000/config-repo/dev][http_localhost_8000_config-repo_dev]（获取完整配置信息）

3. 输出内容：

{
        "name":"config-repo",
        "profiles":[
            "dev"
        ],
        "label":null,
        "version":"0d6480b5ba6f7f2be87b3130de8163dcb0af9f5f",
        "state":null,
        "propertySources":[
    
        ]
    }

4. 访问地址：[http://localhost:8000/system/dev][http_localhost_8000_system_dev]（获取完整配置信息）

5. 输出内容：

{
        "name":"system",
        "profiles":[
            "dev"
        ],
        "label":null,
        "version":"0d6480b5ba6f7f2be87b3130de8163dcb0af9f5f",
        "state":null,
        "propertySources":[
            {
                "name":"https://github.com/intomylife/SpringCloud/springcloud-config-eureka/config-repo/system-dev.properties",
                "source":{
                    "hello":"I'm dev."
                }
            }
        ]
    }

6. 访问地址：[http://localhost:8000/system-dev.properties][http_localhost_8000_system-dev.properties]（获取指定配置文件内容）

7. 输出内容：'hello: I'm dev.'

8. 启动另一个 server（springcloud-config-eureka-serversecond-service）

9. 项目启动成功后访问：[http://localhost:8761/][http_localhost_8761]（注册中心）可以看到服务已经被注册进来了

![20190608001357600.png][]

10. 访问地址：[http://localhost:8001/config-repo/uat][http_localhost_8001_config-repo_uat]（获取完整配置信息）

11. 输出内容：

{
        "name":"config-repo",
        "profiles":[
            "uat"
        ],
        "label":null,
        "version":"0d6480b5ba6f7f2be87b3130de8163dcb0af9f5f",
        "state":null,
        "propertySources":[
    
        ]
    }

12. 访问地址：[http://localhost:8001/system/uat][http_localhost_8001_system_uat]（获取完整配置信息）

13. 输出内容：

{
        "name":"system",
        "profiles":[
            "uat"
        ],
        "label":null,
        "version":"0d6480b5ba6f7f2be87b3130de8163dcb0af9f5f",
        "state":null,
        "propertySources":[
            {
                "name":"https://github.com/intomylife/SpringCloud/springcloud-config-eureka/config-repo/system-uat.properties",
                "source":{
                    "hello":"I'm uat."
                }
            }
        ]
    }

14. 访问地址：[http://localhost:8001/system-uat.properties][http_localhost_8001_system-uat.properties]（获取指定配置文件内容）

15. 输出内容：'hello: I'm uat.'

16. 证明两个 server 都已经成功从远程仓库中获取到了配置信息

**  注：接口访问有如下规则：**

/{application}/{profile}[/{label}]
     
    /{application}-{profile}.yml
     
    /{label}/{application}-{profile}.yml
     
    /{application}-{profile}.properties
     
    /{label}/{application}-{profile}.properties

### client（读取注册中心的 server 中的配置信息） ###

### client - POM 文件 ###

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        
        <parent>
            <groupId>com.zwc</groupId>
            <artifactId>springcloud-config-eureka-service</artifactId>
            <version>1.0</version>
        </parent>
    
        
        <groupId>com.zwc</groupId>
        <artifactId>springcloud-config-eureka-client-service</artifactId>
        <version>1.0</version>
    
        
        <name>springcloud-config-eureka-client-service</name>
        <description>config client</description>
    
        
        <packaging>jar</packaging>
    
        
        <properties>
    
        </properties>
    
        
        <dependencies>
            
            <dependency>
                <groupId>com.zwc</groupId>
                <artifactId>springcloud-config-eureka-commons</artifactId>
                <version>1.0</version>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-config</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
            </dependency>
        </dependencies>
    
        
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    
    </project>

*  加入 spring-cloud-starter-config 依赖：config client
 *  加入 spring-cloud-starter-netflix-eureka-client 依赖：提供和注册服务

### client - application.yml 配置文件 ###

# 端口
    server:
      port: 8002
    
    spring:
      application:
        # 应用名称
        name: config-eureka-client

### client - bootstrap.yml 配置文件（注意） ###

spring:
      cloud:
        config:
          # 对应 {label} 部分，即 Git 的分支
          label: master
          # 对应 {application} 部分
          name: system
          # 对应 {profile} 部分
          profile: dev
          discovery:
            # 开启 Config 服务发现与注册
            enabled: true
            # 指定 server
            service-id: config-eureka-server
    
    eureka:
      instance:
        # 使用 ip 代替实例名
        prefer-ip-address: true
        # 实例的主机名
        hostname: ${spring.cloud.client.ip-address}
        # 实例的 ID 规则
        instance-id: ${spring.cloud.client.ip-address}:${spring.application.name}:${server.port}
      client:
        serviceUrl:
          # 注册中心地址
          defaultZone: http://${eureka.instance.hostname}:8761/eureka/

*  bootstrap.yml 配置文件加载先于 application.yml 配置文件
 *  与 Spring Cloud Config 相关的属性必须配置在 bootstrap.yml 中
 *  这里就不是直接指定 server 地址了，而是 server 的应用名（spring.application.name）
 *  从注册中心的 server 中读取 dev（开发）环境的配置文件信息
 *  **注意此处配置注册中心地址的端口为 8761 也就是上面注册中心工程配置的端口**

### client - controller 前端控制器 ###

package com.zwc.client.controller;
    
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    /**
     * @ClassName HelloController
     * @Desc TODO   读取 git 配置文件
     * @Date 2019/6/2 16:54
     * @Version 1.0
     */
    @RestController
    public class HelloController {
    
        @Value("${hello}")
        private String hello;
    
        /*
         * @ClassName HelloController
         * @Desc TODO   读取 git 配置文件
         * @Date 2019/6/2 16:56
         * @Version 1.0
         */
        @RequestMapping("/hello")
        public String hello() {
            return this.hello;
        }
    
    }

*  直接使用 @Value 注解就可以从注册中心的 server 中读取到对应的配置信息

### client - 启动类 ###

package com.zwc;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
    
    @SpringBootApplication
    @EnableEurekaClient
    public class SpringcloudConfigEurekaClientServiceApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(SpringcloudConfigEurekaClientServiceApplication.class, args);
        }
    
    }

*  添加 @EnableEurekaClient 注解表示此工程可以向注册中心提供服务

### client -  启动项目 ###

1. 项目启动成功后访问：[http://localhost:8761/][http_localhost_8761]（注册中心）可以看到服务已经被注册进来了

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDAyMjAw_size_16_color_FFFFFF_t_70 2][]

2. 访问地址：[http://localhost:8002/hello][http_localhost_8002_hello]

3. 输出内容：'I'm dev.'

4. 证明 client 已经成功从注册中心的 server 中读取到了配置信息

5. 此时当 client 已经启动完毕后，配置文件就已经全部读取到了，所以即使停止其中一个 server 或者停止

全部 server，client 依然可以读取到配置文件。此处高可用应该是指在 client 启动时能保证有 server 可

用

### service 工程 - 项目结构 ###

![20190608002713608.png][]

# 把多工程项目使用 IntelliJ IDEA  打开 #

1.  把项目从 GitHub 中下载到你的本地
2.  打开 IntelliJ IDEA 
3.  点击 File -> Open
4.  打开你下载到本地的项目目录
5.  springcloud-config-eureka -> springcloud-config-eureka-service（选择打开此工程）
6.  打开 service 工程后
7.  再次点击 File -> Project Structrue
8.  选择 Modules，点击 '+' 符号
9.  点击 Import  Module
10. 还是打开你下载到本地的项目目录
11. springcloud-config-eureka -> springcloud-config-eureka-commons -> pom.xml
12. 点击 OK
13. 点击 Next，Finish
14. 点击 Apply，OK

--------------------

希望能够帮助到你

over

[https_github.com_intomylife_SpringCloud]: https://github.com/intomylife/SpringCloud
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDAyMjAw_size_16_color_FFFFFF_t_70]: /images/20220121/9dfb5c5d59924da894aca74b280bfa78.png
[http_localhost_8761]: http://localhost:8761/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDAyMjAw_size_16_color_FFFFFF_t_70 1]: /images/20220121/9b115c6d61bf4b4a849f8c68341127c9.png
[20190608000311638.png]: /images/20220121/81e744c7318c43f08d6aeadf2474c325.png
[http_localhost_8000_config-repo_dev]: http://localhost:8000/config-repo/dev
[http_localhost_8000_system_dev]: http://localhost:8000/system/dev
[http_localhost_8000_system-dev.properties]: http://localhost:8000/system-dev.properties
[20190608001357600.png]: /images/20220121/6eadae38765d43bab0c59450fdc76398.png
[http_localhost_8001_config-repo_uat]: http://localhost:8001/config-repo/uat
[http_localhost_8001_system_uat]: http://localhost:8001/system/uat
[http_localhost_8001_system-uat.properties]: http://localhost:8001/system-uat.properties
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDAyMjAw_size_16_color_FFFFFF_t_70 2]: /images/20220121/c1a4ec0171be45aeae6b8b014bd1976a.png
[http_localhost_8002_hello]: http://localhost:8002/hello
[20190608002713608.png]: /images/20220121/1c33e00fada649e3a9854fa7e587d0c0.png