Spring Cloud Config：外部集中化配置管理


阅读数: 次   
如需转载，请根据 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 许可，附上本文作者及链接。
本文作者： 执笔成念
作者昵称： zbcn
本文链接： https://1363653611.github.io/zbcn.github.io/2021/01/08/springcloud-08config%E9%9B%86%E4%B8%AD%E9%85%8D%E7%BD%AE%E7%AE%A1%E7%90%86/

Spring Cloud Config：外部集中化配置管理

Spring Cloud Config 可以为微服务架构中的应用提供集中化的外部配置支持，它分为服务端和客户端两个部分。

Spring Cloud Config 简介

Spring Cloud Config 分为服务端和客户端两个部分。服务端被称为分布式配置中心，它是个独立的应用，可以从配置仓库获取配置信息并提供给客户端使用。客户端可以通过配置中心来获取配置信息，在启动时加载配置。Spring Cloud Config 的配置中心默认采用Git来存储配置信息，所以天然就支持配置信息的版本管理，并且可以使用Git客户端来方便地管理和访问配置信息。

在Git仓库中准备配置信息

由于Spring Cloud Config 需要一个存储配置信息的Git仓库，这里我们先在Git仓库中添加好配置文件再演示其功能。仓库地址：https://github.com/1363653611/config-repo.git

配置仓库目录结构

master分支下的配置信息

  • config-dev.yml
1
config:
2
  info: "config info for dev(master)"
  • config-test.yml:
1
config:
2
  info: "config info for test(master)"
  • config-prod.yml
1
config:
2
  info: "config info for prod(master)"

dev分支下的配置信息

  • config-dev.yml:
1
config:
2
  info: "config info for dev(dev)"
  • config-test.yml:
1
config:
2
  info: "config info for test(dev)"
  • config-prod.yml:
1
config:
2
  info: "config info for prod(dev)"

创建config-server模块

这里我们创建一个config-server模块来演示Spring Cloud Config 作为配置中心的功能。

在pom.xml中添加相关依赖

1
<dependency>
2
    <groupId>org.springframework.cloud</groupId>
3
    <artifactId>spring-cloud-config-server</artifactId>
4
</dependency>
5
<dependency>
6
    <groupId>org.springframework.cloud</groupId>
7
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
8
</dependency>

在application.yml中进行配置

1
server:
2
  port: 8901
3
spring:
4
  application:
5
    name: config-server
6
  cloud:
7
    config:
8
      server:
9
        git: #配置存储配置信息的Git仓库
10
          uri: https://github.com/1363653611/config-repo.git
11
          username: xxx
12
          password: xxxx
13
          clone-on-start: true #开启启动时直接从git获取配置
14
eureka:
15
  client:
16
    service-url:
17
      defaultZone: http://localhost:8000/eureka/

在启动类上添加@EnableConfigServer注解来启用配置中心功能

1
@EnableConfigServer
2
@EnableDiscoveryClient
3
@SpringBootApplication
4
public class ConfigServerApplication {
5
6
    public static void main(String[] args) {
7
        SpringApplication.run(ConfigServerApplication.class, args);
8
    }
9
}

通过config-server获取配置信息

这里我们通过config-server来演示下如何获取配置信息。

获取配置文件信息的URI访问格式

1
# 获取配置信息
2
/{label}/{application}-{profile}
3
# 获取配置文件信息
4
/{label}/{application}-{profile}.yml

占位符相关解释

  • application：代表应用名称，默认为配置文件中的spring.application.name，如果配置了spring.cloud.config.name，则为该名称；
  • label：代表分支名称，对应配置文件中的spring.cloud.config.label；
  • profile：代表环境名称，对应配置文件中的spring.cloud.config.profile。

获取配置信息演示

启动eureka-server、config-server服务；

image-20201208191544134

创建config-client模块

我们创建一个config-client模块来从config-server获取配置。

在pom.xml中添加相关依赖

1
<dependency>
2
    <groupId>org.springframework.cloud</groupId>
3
    <artifactId>spring-cloud-starter-config</artifactId>
4
</dependency>
5
<dependency>
6
    <groupId>org.springframework.cloud</groupId>
7
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
8
</dependency>
9
<dependency>
10
    <groupId>org.springframework.boot</groupId>
11
    <artifactId>spring-boot-starter-web</artifactId>
12
</dependency>

在bootstrap.yml中进行配置

1
server:
2
  port: 9101
3
spring:
4
  application:
5
    name: config-client
6
  cloud:
7
    config: #Config客户端配置
8
      profile: dev #启用配置后缀名称
9
      label: dev #分支名称
10
      uri: http://localhost:8901 #配置中心地址
11
      name: config #配置文件名称
12
eureka:
13
  client:
14
    service-url:
15
      defaultZone: http://localhost:8000/eureka/

添加ConfigClientController类用于获取配置

1
@RestController
2
@RequestMapping("/config")
3
public class ConfigClientController {
4
    @Value("${config.info}")
5
    private String configInfo;
6
7
    @GetMapping("/configInfo")
8
    public String getConfigInfo() {
9
        return configInfo;
10
    }
11
}

测试从配置中心获取配置

获取子目录下的配置

我们不仅可以把每个项目的配置放在不同的Git仓库存储，也可以在一个Git仓库中存储多个项目的配置，此时就会用到在子目录中搜索配置信息的配置。

  • 首先我们需要在config-server中添加相关配置，用于搜索子目录中的配置，这里我们用到了application占位符，表示对于不同的应用，我们从对应应用名称的子目录中搜索配置，比如config子目录中的配置对应config应用；
1
spring:
2
  cloud:
3
    config:
4
      server:
5
        git: 
6
          search-paths: '{application}'
1
config info for config dir dev(dev)

刷新配置

当Git仓库中的配置信息更改后，我们可以通过SpringBoot Actuator的refresh端点来刷新客户端配置信息，以下更改都需要在config-client中进行。

  • 在pom.xml中添加Actuator的依赖：
1
<dependency>
2
   <groupId>org.springframework.boot</groupId>
3
   <artifactId>spring-boot-starter-actuator</artifactId>
4
</dependency>
  • 在bootstrap.yml中开启refresh端点：
1
management:
2
  endpoints:
3
    web:
4
      exposure:
5
        include: 'refresh'
  • 在ConfigClientController类添加@RefreshScope注解用于刷新配置：
1
@RestController
2
@RefreshScope
3
public class ConfigClientController {
4
5
    @Value("${config.info}")
6
    private String configInfo;
7
8
    @GetMapping("/configInfo")
9
    public String getConfigInfo() {
10
        return configInfo;
11
    }
12
}
  • 重新启动config-client后，调用refresh端点进行配置刷新：

请求方式 post： http://localhost:9101/actuator/refresh

使用到的模块

1
ZBCN-SERVER
2
├── zbcn-register/eureka-server -- eureka注册中心
3
├── zbcn-config/ config-client -- 获取配置的客户端服务
4
└── zbcn-config/ zbcn-config/ config-server -- 配置中心服务

配置中心添加安全认证

创建config-security-server模块

  • 添加pom依赖
1
<dependency>
2
    <groupId>org.springframework.cloud</groupId>
3
    <artifactId>spring-cloud-config-server</artifactId>
4
</dependency>
5
<dependency>
6
    <groupId>org.springframework.boot</groupId>
7
    <artifactId>spring-boot-starter-security</artifactId>
8
</dependency>
  • 在application.yml中进行配置：
1
server:
2
  port: 8905
3
spring:
4
  application:
5
    name: config-security-server
6
  cloud:
7
    config:
8
      server:
9
        git:
10
         uri: https://github.com/1363653611/config-repo.git
11
          username: xxx
12
          password: xxxx
13
          clone-on-start: true #开启启动时直接从git获取配置
14
  security: #配置用户名和密码
15
    user:
16
      name: zbcn
17
      password: 123456
  • 启动config-security-server服务。

修改config-client的配置

  • 添加bootstrap-security.yml配置文件，主要是配置了配置中心的用户名和密码：
1
server:
2
  port: 9002
3
spring:
4
  application:
5
    name: config-client
6
  cloud:
7
    config:
8
      profile: dev #启用配置后缀名称
9
      label: dev #分支名称
10
      uri: http://localhost:8905 #配置中心地址
11
      name: config #配置文件名称
12
      username: zbcn
13
      password: 123456

  • 使用bootstrap-security.yml启动config-client服务；

    --spring.config.location=classpath:bootstrap-security.yml

image-20201209101857577

使用到的模块

1
ZBCN-SERVER
2
├── zbcn-register/eureka-server -- eureka注册中心
3
├── zbcn-config/ config-client -- 获取配置的客户端服务
4
└── zbcn-config/ config-security-server -- 带安全认证的配置中心服务

config-sever集群搭建

在微服务架构中，所有服务都从配置中心获取配置，配置中心一旦宕机，会发生很严重的问题，下面我们搭建一个双节点的配置中心集群来解决该问题。

  • 启动两个config-server分别运行在8902和8903端口上；
  • 添加config-client的配置文件bootstrap-cluster.yml，主要是添加了从注册中心获取配置中心地址的配置并去除了配置中心uri的配置：
1
spring:
2
  cloud:
3
    config:
4
      profile: dev #启用环境名称
5
      label: dev #分支名称
6
      name: config #配置文件名称
7
      discovery:
8
        enabled: true
9
        service-id: config-server
10
eureka:
11
  client:
12
    service-url:
13
      defaultZone: http://localhost:8000/eureka/

使用到的模块

1
ZBCN-SERVER
2
├── zbcn-register/eureka-server -- eureka注册中心
3
├── zbcn-config/ config-client -- 获取配置的客户端服务
4
└── zbcn-config/ config-server -- 配置中心服务
赏

谢谢你请我吃糖果

支付宝
微信

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

身在井隅<br><br> 心想星光<br><br> 眼里有诗<br><br>自在远方