cloud-配置中心

以你之姓@ 2023-02-25 08:35 20阅读 0赞

# 前言 #

每个spring-boot程序都依赖于一些特定的第三方数据源，在一个分布式系统中，需要有一个这样的数据源服务器，其他的微服务能够从这个数据源拿到最新的数据。spring cloud中实现这个功能的组件就是spring cloud config server。

# spring cloud config server #

Spring Cloud配置服务器**为外部配置(名称-值对或等效的YAML内容)提供了基于HTTP资源的API**。通过使用@EnableConfigServer注释，服务器可以嵌入到Spring引导应用程序中。因此，下面的应用程序是一个配置服务器:

application.properties

@SpringBootApplication
    @EnableConfigServer
    public class ConfigServer {
      public static void main(String[] args) {
        SpringApplication.run(ConfigServer.class, args);
      }
    }

与所有Spring引导应用程序一样，默认情况下它运行在端口8080上，但是您可以通过各种方式将其切换到更传统的端口8888。最简单的方法是使用spring.config.name=configserver（Config Server jar中有一个configserver.yml）启动配置库，这也是设置默认配置库的方法。另一种方法是使用自己的application.properties，如下例所示:

server.port: 8888
    spring.cloud.config.server.git.uri: file://${user.home}/config-repo

其中$\{user.home\}/config-repo是一个包含YAML和属性文件的git存储库。

> 在Windows上，如果文件是带有驱动器前缀的绝对文件，则需要在文件URL中额外添加一个“/”(例如，file:///$\{user.home\}/config-repo)。

# 环境库 #

配置服务器的配置数据应该存储在哪里?管理这种行为的策略是为Environment对象服务的EnvironmentRepository。这个Environment是来自Spring Environment的域的浅拷贝(包括propertySources作为主要特性)。环境资源由三个变量参数化:

*  \{application\}，它映射到客户端spring.application.name。
 *  \{profile\}，它映射到客户端的spring.profiles.active的客户端(逗号分隔列表)。
 *  \{label\}，它是一个服务器端特性，用于标记配置文件的“版本化”集。

存储库实现的行为通常类似于Spring引导应用程序，从等于\{application\}参数的spring.config.name和spring.profiles.active等于\{profiles\}加载配置文件参数。概要文件的优先规则与常规Spring引导应用程序中的相同:活动概要文件优先于默认配置文件，并且，如果有多个概要文件，最后一个优先(类似于向Map中添加条目)。

下面的示例客户端应用程序有这样的引导配置:

bootstrap.yml

spring:
      application:
        name: foo
      profiles:
        active: dev,mysql

(与Spring引导应用程序一样，这些属性也可以由环境变量或命令行参数设置)。

如果存储库是基于文件的，则服务器从application.yml创建环境(在所有客户端之间共享)和foo.yml (foo.yml采取优先)。如果YAML文件中有指向Spring概要文件的文档，则应用这些文件的优先级更高(按照列出的概要文件的顺序)。如果存在特定于配置文件的YAML(或属性)文件，也会以高于默认值的优先级应用这些文件。较高的优先级将转换为环境中较早列出的PropertySource。(这些规则同样适用于独立的Spring引导应用程序。)

可以设置spring.cloud.config.server.accept-empty到false，这样如果没有找到应用程序，服务器将返回HTTP 404状态。默认情况下，此标志设置为true。

# Git后端 #

环境存储库的默认实现使用一个Git后端，它对于管理升级和物理环境以及审核更改非常方便。要更改存储库的位置，可以设置spring.cloud.config.server.git。配置服务器中的uri配置属性(例如application.yml中)。如果您将其设置为file:前缀，那么它应该在本地存储库中工作，这样您就可以在不使用服务器的情况下快速而轻松地入门。然而，在这种情况下，服务器直接在本地存储库上操作而不克隆它(如果它不是裸的也没关系，因为配置服务器从不更改“远程”存储库)。要扩展配置服务器并使其高可用性，您需要让该服务器的所有实例指向同一个存储库，这样只有共享文件系统才能工作。即使在这种情况下，最好还是为共享的文件系统存储库使用ssh:协议，这样服务器就可以克隆它并使用本地工作副本作为缓存。

这个存储库实现将HTTP资源的\{label\}参数映射到一个git标签(提交id、分支名称或标记)。`如果git分支或标记名称包含斜杠(/)，那么HTTP URL中的标签应该使用特殊字符串(_)指定(以避免与其他URL路径产生歧义)。例如，如果标签是foo/bar，替换斜杠将产生以下标签:foo(_)bar。包含特殊字符串(_)也可以应用于{application}参数`。如果使用curl之类的命令行客户机，请注意URL中的括号，应该使用单引号(")将它们从shell中转义。

# Git搜索路径中的占位符 #

Spring Cloud Config Server还支持带有占位符的\{application\}和\{profile\}搜索路径(如果需要还支持\{label\})，如下面的示例所示:

spring:
      cloud:
        config:
          server:
            git:
              uri: https://github.com/spring-cloud-samples/config-repo
              searchPaths: '{application}'	#注意单引号

上面的清单导致在存储库中搜索同名（名称为\{application\}）目录中的文件(以及顶层)。通配符在带有占位符的搜索路径中也有效(搜索中包括任何匹配的目录)。

# 推送通知和Spring Cloud Bus #

许多源代码库提供商(如Github、Gitlab、Gitea、Gitee、Gogs或Bitbucket)通过webhook通知你库中的更改。您可以通过提供者的用户界面将webhook配置为一个URL和一组您感兴趣的事件。例如，Github使用一个JSON主体，其中包含一个提交列表和一个设置为push的头(X-Github-Event)。如果您在Spring-Cloud添加一个spring-cloud-config-monitor依赖项，并在配置服务器中激活Spring云总线，那么就启用了一个/monitor端点。

参考[spring cloud bus][]。

[spring cloud bus]: https://blog.csdn.net/ssehs/article/details/107310530