Spring Boot 与 Spring Cloud Config：实现集中化配置管理！

🏆本文收录于「滚雪球学SpringBoot」专栏(全网一个名)，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

🌐 前言

在现代微服务架构中，随着系统的不断扩展和多服务的增多，如何有效地管理各个微服务的配置成了一个巨大的挑战。传统的配置管理往往需要手动更新和分发配置文件，容易出错且不具备灵活性。而 Spring Cloud Config 提供了一个解决方案，它让我们可以集中化管理各个微服务的配置，并且支持动态更新配置，免去手动更改的繁琐。

本文将深入探讨如何通过 Spring Boot 与 Spring Cloud Config 来实现配置的集中化管理。我们将介绍如何搭建一个完整的配置管理系统，让你能实时地获取和更新配置信息，并通过 Git 或 SVN 来存储和版本化这些配置。更重要的是，我们还将探讨如何通过 Spring Boot 的 Profile 机制来区分不同环境下的配置，确保在开发、测试和生产环境中都能获得合适的配置信息。

🧐 什么是 Spring Cloud Config？

Spring Cloud Config 是一个用于集中化配置管理的框架，它可以轻松地将所有微服务的配置集中在一个地方管理。它的核心概念是将配置信息存储在 Git 或 SVN 等版本控制系统中，并通过配置服务器（Config Server）提供给客户端（微服务）。Spring Cloud Config 让配置的更新变得更加高效，通过 Spring Cloud Bus 实现动态刷新配置，无需重启服务即可使配置生效。

Spring Cloud Config 的主要组成：

1. Config Server：负责提供配置信息给各个客户端。Config Server 可以从 Git 仓库或者本地文件系统中读取配置信息，并提供给客户端。
2. Config Client：微服务作为客户端，通过访问 Config Server 获取所需的配置，实时应用这些配置。
3. Spring Cloud Bus：用于将配置更新的通知广播给客户端，使得配置变更能够实时生效，无需重启服务。

Spring Cloud Config 的设计理念使得配置管理从每个微服务的独立管理转变为集中的管理，从而提升了系统的一致性和可维护性。

⚙️ Spring Boot 与 Spring Cloud Config 配置集成

1. 创建 Spring Cloud Config 服务器

首先，我们要创建一个 Config Server，这个服务器将会为微服务提供集中管理的配置信息。

a. 引入依赖

在 pom.xml 文件中加入以下依赖，来启用 Spring Cloud Config Server：

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

b. 启动 Config Server

接下来，我们需要创建一个配置服务器的启动类，并添加 @EnableConfigServer 注解来启用 Spring Cloud Config Server：

package com.example.configserver;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.server.EnableConfigServer;

@SpringBootApplication
@EnableConfigServer
public class ConfigServerApplication {

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

c. 配置 Git 存储库

在 application.properties 文件中，我们需要配置 Config Server 的 Git 仓库地址，并指明从 Git 中获取配置文件。配置如下：

server.port=8888
spring.cloud.config.server.git.uri=https://github.com/your-repository/config-repo
spring.cloud.config.server.git.clone-on-start=true
spring.cloud.config.server.git.username=your-username
spring.cloud.config.server.git.password=your-password

通过这些配置，Spring Cloud Config Server 将从指定的 Git 仓库中拉取配置信息，客户端在访问时就能获取这些配置。

2. 配置 Spring Boot 客户端

Spring Boot 客户端作为微服务的一部分，会通过访问 Config Server 来获取配置。我们只需要在客户端配置中指定 Config Server 的地址，并利用 Spring Boot 提供的 @Value 注解来获取配置项。

a. 引入依赖

在客户端应用中，同样需要引入 Spring Cloud Config Client 的依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-config</artifactId>
    </dependency>
</dependencies>

b. 配置 Config Server 地址

在客户端的 application.properties 文件中，配置连接 Config Server 的地址：

spring.application.name=client-service
spring.cloud.config.uri=http://localhost:8888

c. 创建 Spring Boot 应用

客户端应用代码相对简单，我们通过 @Value 注解将配置值注入到代码中：

package com.example.clientservice;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class ClientServiceApplication {

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

@RestController
class ConfigClientController {

    @Value("${my.config.property}")
    private String configValue;

    @GetMapping("/config")
    public String getConfigValue() {
        return "配置值: " + configValue;
    }
}

d. 配置 Git 存储库中的配置文件

Git 存储库中可以存储针对不同微服务的配置文件，例如 client-service.properties，内容如下：

my.config.property=Hello, Spring Cloud Config!

🔄 Spring Cloud Config 的动态刷新功能

一个非常有用的特性就是 动态刷新配置，即当配置发生变化时，客户端无需重启服务即可立即获取新的配置。这通过 Spring Cloud Bus 和 /actuator/refresh 端点实现。

a. 引入 Spring Cloud Bus

首先，需要引入 Spring Cloud Bus 相关的依赖来支持消息通知：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bus-amqp</artifactId>
</dependency>

b. 启用 Actuator 端点

为了使配置能够实时刷新，我们需要启用 refresh 端点。在 application.properties 文件中添加以下配置：

management.endpoints.web.exposure.include=refresh

c. 发送刷新请求

通过调用 /actuator/refresh 端点，客户端可以获取最新的配置，而无需重启服务：

curl -X POST http://localhost:8080/actuator/refresh

Spring Cloud Bus 会将刷新请求广播到所有连接的微服务，这些微服务会通过监听到的消息进行配置更新。

🌍 结合 Spring Boot Profile 管理不同环境的配置

Spring Boot 提供了 Profile 机制，允许我们为不同的环境（如开发、测试、生产）配置不同的配置信息。通过 Profile 机制，Spring Cloud Config 可以针对不同的环境动态加载不同的配置文件。

a. 配置文件结构

假设我们在 Git 仓库中存储了不同环境的配置文件，如下所示：

config-repo/
    client-service-dev.properties
    client-service-prod.properties
    client-service-test.properties

b. 激活不同的 Profile

在客户端应用中，可以通过设置 spring.profiles.active 来指定激活的 Profile：

spring.profiles.active=dev

这样，客户端应用会根据当前激活的 Profile 加载相应的配置文件。比如，当 dev Profile 被激活时，client-service-dev.properties 文件中的配置将会生效。

📦 版本控制与配置存储库

使用 Git 或 SVN 来存储配置文件，能够为配置提供版本控制。这意味着每次配置文件发生变化时，我们都能够记录变更并进行回滚。通过这种方式，我们不仅能管理不同环境下的配置，还能追踪配置的历史版本，确保配置变更是可控和可回溯的。

🚀 总结

通过 Spring Boot 和 Spring Cloud Config，我们能够实现微服务架构中的集中式配置管理。在这个过程中，Config Server 作为配置源，Config Client 获取配置并动态应用，Spring Cloud Bus 使得配置变更能够实时生效，而 Spring Boot 的 Profile 机制则帮助我们管理不同环境下的配置。Git 或 SVN 作为配置存储库，则提供了强大的版本控制能力，让我们能够追踪每次配置的变更。

集中化配置管理不仅提高了配置管理的效率，还让系统更加灵活与可靠，尤其在多环境、多微服务的情况下，能够显著减少配置错误的发生。通过这样的配置管理系统，我们可以让微服务架构变得更加高效、安全和易于维护。

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」专栏(全网一个名)，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。

  最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。

  同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。

✨️ Who am I?

我是bug菌(全网一个名)，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。

-End-