分布式配置中心：Spring Cloud Config 全面指南！

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

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

🎉 前言：配置管理的超级助手——Spring Cloud Config

  微服务架构是现代软件开发中最流行的架构模式之一，其灵活性和可扩展性使其成为大型企业应用的首选。然而，随着服务数量的增加，配置的管理变得愈加复杂。一个微服务架构中，可能有上百个微服务，每个服务都需要独立的配置文件，并且这些配置随着业务需求和环境变化频繁变动。在这种情况下，如何高效、可靠地管理这些配置成为了一个巨大的挑战。

  传统的配置管理方法已经无法满足现代微服务架构的需求，因为每次修改配置文件时，都需要手动更新每个服务的配置，并且还需要重启服务，这不仅效率低，而且容易出错。因此，Spring Cloud Config 应运而生，它提供了集中式配置管理的能力，不仅能简化配置管理，还能让配置的动态刷新变得容易，从而保证微服务架构的高效运作。

  今天，我们将深入探讨 Spring Cloud Config，并为您提供详细的教程，介绍如何使用 Spring Cloud Config 搭建一个高效、可扩展的配置管理系统，涵盖从 Config Server 搭建 到 Config Client 配置使用 的全套内容，以及如何结合 Git 仓库 进行远程配置管理。📚

🎯 1. 什么是 Spring Cloud Config？

在微服务架构中，每个服务都通常有自己的配置文件，用于管理不同的参数。随着微服务的增多，管理这些配置变得越来越困难。如果每个微服务都独立存储和维护配置文件，不仅会造成大量的重复配置，还会在修改配置时增加大量的维护成本。

Spring Cloud Config 提供了一个解决方案，它可以将所有微服务的配置集中管理，并提供统一的配置访问接口。通过 Spring Cloud Config，微服务可以从一个中心位置动态获取配置，且支持多种存储方式（如 Git、SVN、本地文件系统等）。此外，Spring Cloud Config 还支持 动态刷新配置，不需要重启服务即可应用新的配置。

💡 Spring Cloud Config 的优势

1. 集中管理配置：通过 Config Server，集中管理所有微服务的配置。
2. 动态刷新：无需重启服务即可更新配置，支持 @RefreshScope 注解实现动态刷新。
3. 版本控制：可以通过 Git 进行配置的版本管理，支持回滚和审计。
4. 多环境配置支持：支持为不同的环境提供不同的配置，如开发环境、生产环境等。
5. 简化配置管理：通过集中式配置文件管理，减少重复配置，提高一致性，避免配置错误。

🏗 2. 搭建 Spring Cloud Config Server

Spring Cloud Config Server 是配置中心的核心组件，负责提供集中化配置管理服务。通过它，所有的微服务可以从一个位置获取到所需的配置。

✨ 2.1 创建 Spring Boot 项目

首先，我们需要创建一个 Spring Boot 项目，该项目将作为 Config Server。在使用 Spring Initializr 时，选择以下依赖：

• Spring Cloud Config Server（用于启动配置中心）
• Spring Boot Web（用于实现 Web 服务）

创建一个新的 Spring Boot 项目，并在 “Dependencies” 选项中选择 Config Server 和 Spring Web 依赖。

🛠 2.2 配置 Config Server 启动类

在创建的项目中，我们需要定义一个启动类，并加上 @EnableConfigServer 注解来启用 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  // 启用 Spring Cloud Config Server
public class ConfigServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConfigServerApplication.class, args);
    }
}

📜 2.3 配置 application.yml

配置文件 application.yml 用来指定 Config Server 如何连接到配置存储（例如 Git 仓库或本地文件系统）。以下是一个典型的配置示例，Config Server 从 Git 仓库 中获取配置文件。

server:
  port: 8888  # Config Server 默认监听端口

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/your-repo/config-repository  # Git 仓库地址
          search-paths: config  # 配置文件所在路径
          clone-on-start: true  # 启动时自动克隆仓库

上面的配置指定了 Git 仓库的地址，并且在 search-paths 中指定了配置文件的路径。您可以根据需求调整路径或者切换到文件系统作为配置源。

🎬 2.4 启动 Config Server

完成上述配置后，您可以启动 Config Server。在浏览器中访问 http://localhost:8888/{application}/{profile}/{label} 来查看配置。例如：

http://localhost:8888/service-client/default

🚗 3. 配置 Spring Cloud Config Client

Config Client 是一个 Spring Boot 应用，它会连接到 Config Server 获取配置。Config Client 通过远程读取 Config Server 的配置，加载配置文件并应用到服务中。

🏗 3.1 创建 Spring Boot 项目作为 Config Client

创建一个新的 Spring Boot 项目，添加以下依赖：

• Spring Cloud Config Client（用于连接 Config Server）
• Spring Boot Web（用于构建 Web 应用）

🔧 3.2 配置 application.yml

在 Config Client 项目中，我们需要配置 Config Server 的地址，告知 Client 从哪里获取配置文件：

spring:
  application:
    name: service-client  # 服务名称

  cloud:
    config:
      uri: http://localhost:8888  # Config Server 地址

🚀 3.3 配置动态刷新（@RefreshScope）

通过 @RefreshScope 注解，我们可以实现动态刷新配置，无需重启服务即可更新配置。

1. 添加 @RefreshScope 注解
   在需要动态刷新的配置类上，添加 @RefreshScope 注解，表示该类支持动态刷新。

package com.example.configclient.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RefreshScope  // 使该类支持动态刷新配置
public class ConfigClientController {

    @Value("${message:Default Message}")
    private String message;

    @GetMapping("/message")
    public String getMessage() {
        return message;
    }
}

2. 触发配置刷新
   当配置文件发生变动时，可以通过向 /actuator/refresh 端点发送 POST 请求来刷新配置。

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

这样，message 配置项将会被动态刷新，客户端服务将应用新的配置。

🎯 3.4 启动 Config Client

启动 Config Client 项目，访问 http://localhost:8081/message 来查看动态加载的配置。

🌍 4. 配合 Git 进行远程配置管理

使用 Git 仓库来管理配置文件是 Spring Cloud Config 的一个核心优势。通过 Git，您可以使用 Git 的版本控制和协作功能来管理配置文件。每个配置文件都可以版本化并且能够追踪配置变动，确保团队在修改配置时不会出现冲突。

✨ 4.1 配置 Git 仓库

首先，您需要创建一个 Git 仓库，用来存储配置文件。配置文件可以按照服务进行分类，例如：

/config-repository
    /application.yml
    /service-client.yml
    /service-provider.yml

🛠 4.2 配置 Config Server 使用 Git

在 application.yml 中配置 Git 仓库的地址，Config Server 会从 Git 仓库中加载配置文件：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/your-repo/config-repository  # Git 仓库地址
          search-paths: config  # 配置文件的路径
          profile: prod  # 设置不同的环境配置文件

🎯 4.3 配置文件的版本控制

Git 仓库支持配置文件的版本控制。您可以通过 Git 的分支和标签来管理不同环境的配置。例如，您可以创建一个 dev 分支来存储开发环境的配置文件，prod 分支来存储生产环境的配置文件。

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/your-repo/config-repository  # Git 仓库地址
          search-paths: config
          profile: prod  # 设置不同的环境配置文件

这样，您可以方便地管理多个环境的配置文件，并在不同环境中使用不同的配置。

💡 5. 总结

通过本文的讲解，您应该已经对 Spring Cloud Config 有了全面的了解，从 Config Server 搭建 到 Config Client 配置使用，以及如何与 Git 仓库结合进行远程配置管理，我们深入探讨了 Spring Cloud Config 在微服务架构中的应用。它不仅为我们提供了集中式配置管理的解决方案，还支持动态配置刷新，使得微服务架构的配置管理更加高效和灵活。

通过 Spring Cloud Config，我们能够实现更加清晰和高效的配置管理，减少重复配置，避免配置错误，并且通过版本控制和 Git 仓库的集成，实现了配置的可审计性和回滚能力。

Spring Cloud Config 是微服务架构中一个不可或缺的工具，它能够帮助我们保持各个微服务配置的一致性，增强系统的可维护性和可扩展性。

是不是已经迫不及待要在你的项目中使用 Spring Cloud Config 了？ 🚀 不妨赶紧动手实践，配置中心的强大功能将大大简化你项目中的配置管理！

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学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-