Spring Cloud Config快速入门Demo

1.什么是Spring Cloud Config？

2.代码工程

实验目标

实现基于config来管理项目的配置文件

config-server

pom.xml

<?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">
    <parent>
        <artifactId>spring-cloud-config</artifactId>
        <groupId>com.et</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>config-server</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
    <dependencies>

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


        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-config-server</artifactId>
        </dependency>

    </dependencies>
</project>

server

1. 启动配置服务器：通过它，应用程序可以接收和处理配置请求，为其他应用提供配置数据。
2. 支持多种存储方式：配置服务器可以从多种配置源（如 Git、文件系统、本地仓库或数据库等）加载配置文件，并根据请求路径或参数动态选择配置文件。
3. 支持不同环境配置：它能根据客户端应用的 spring.profiles.active 等参数提供不同环境（如 dev、prod）的配置。

package com.et;

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);
    }
}

服务端配置文件

• spring.cloud.config.server：表示该服务将作为配置服务器，用于向其他应用提供集中化的配置管理。
• native：指定配置服务器的模式为“本地模式”，即配置文件保存在应用内部的目录或类路径下。这样，应用可以从本地文件系统读取配置，而不是从外部 Git 仓库或其他远程配置源读取。
• search-locations：定义本地配置文件的路径，这里设置为 classpath:/config-repo/crm 和 classpath:/config-repo/client，表示配置服务器会从应用程序的类路径中的这两个文件夹加载配置文件。
• bootstrap: true：启用 bootstrap.yml 加载过程，确保配置加载的优先级较高，通常用于在应用启动时获取外部配置源的信息。

server:
  port: 8888

spring:
  profiles:
    active: native
  cloud:
    config:
      server:
        #        git:
        #          uri: https://github.com/chinoukin/SpringcloudConfig
        native:
          search-locations: classpath:/config-repo/crm,classpath:/config-repo/client
        bootstrap: true

config-client

pom.xml

<?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">
    <parent>
        <artifactId>spring-cloud-config</artifactId>
        <groupId>com.et</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>config-client</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
    <dependencies>

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

    </dependencies>
</project>

controller

package com.et.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author liuhaihua
 * @version 1.0
 * @ClassName DemoController
 * @Description todo
 * @date 2024/11/01/ 13:47
 */
@RestController
public class DemoController {
    @Value("${example.property}")
    private String exampleProperty;

    @GetMapping("/property")
    public String getProperty() {
        return exampleProperty;
    }
}

客户端启动类

1. 配置文件加载：客户端应用在启动时，会自动向配置服务器发送 HTTP 请求，获取以 application-name 和 profile 为参数的配置文件（如 /client-app/dev）。
2. 配置源添加：ConfigServicePropertySourceLocator 会将从配置服务器获取的配置信息转换为 Spring 的 PropertySource，并添加到应用的 Environment 中，供应用程序使用。

package com.et;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class ConfigClientApplication {



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


}

客户端配文件bootstrap.yml

• spring.application.name：指定客户端的应用名称，这个名称用于从配置服务器上找到对应的配置文件。
• spring.cloud.config.uri：配置服务器的 URI 地址。客户端会从这个地址获取配置。

spring:
  cloud:
    config:
      uri: http://127.0.0.1:8888/
      #name: crm,config-client
      name: config-client
      profile: dev

以上只是一些关键代码，所有代码请参见下面代码仓库

代码仓库

• https://github.com/Harries/springcloud-demo(spring cloud config)

3.测试

1. 启动server应用(http://127.0.0.1:8888/config-client-dev.yml)
2. 启动客户端应用
3. 访问http://127.0.0.1:8080/property
4. 返回配置文件中配置值client-dev

4.引用

• https://docs.spring.io/spring-cloud-config/docs/current/reference/html/
• https://www.liuhaihua.cn/archives/711631.html