对于最新的稳定版本,请使用 Spring Cloud Config 4.3.0! |
复合环境存储库
在某些情况下,您可能希望从多个环境存储库中提取配置数据。为此,您可以启用composite
配置文件。例如,如果要从 Subversion 存储库以及两个 Git 存储库中提取配置数据,则可以为配置服务器设置以下属性:
spring:
profiles:
active: composite
cloud:
config:
server:
composite:
-
type: svn
uri: file:///path/to/svn/repo
-
type: git
uri: file:///path/to/rex/git/repo
-
type: git
uri: file:///path/to/walter/git/repo
使用此配置,优先级由存储库在composite
钥匙。 在上面的示例中,首先列出了 Subversion 存储库,因此在 Subversion 存储库中找到的值将覆盖在其中一个 Git 存储库中找到的相同属性的值。在rex
Git 存储库将在walter
Git 存储库。
如果只想从每种类型不同的存储库中提取配置数据,则可以启用相应的配置文件,而不是composite
配置文件,位于配置服务器的应用程序属性或 YAML 文件中。例如,如果要从单个 Git 存储库和单个 HashiCorp Vault 服务器中提取配置数据,则可以为配置服务器设置以下属性:
spring:
profiles:
active: git, vault
cloud:
config:
server:
git:
uri: file:///path/to/git/repo
order: 2
vault:
host: 127.0.0.1
port: 8200
order: 1
使用此配置,优先级可以通过order
财产。 您可以使用order
属性来指定所有存储库的优先级顺序。的数值越低order
属性,则其优先级越高。存储库的优先级顺序有助于解决包含相同属性值的存储库之间的任何潜在冲突。
如果复合环境包含 Vault 服务器,如上例所示,则必须在向配置服务器发出的每个请求中包含 Vault Tokens。请参阅 Vault 后端。 |
从环境存储库检索值时,任何类型的失败都会导致整个复合环境失败。如果希望即使存储库发生故障也能继续组合,可以将spring.cloud.config.server.failOnCompositeError 自false . |
使用复合环境时,所有存储库都包含相同的标签非常重要。如果您的环境与前面示例中的环境类似,并且使用master 标签,但 Subversion 存储库不包含名为master ,则整个请求失败。 |
自定义复合环境存储库
除了使用 Spring Cloud 中的环境存储库之一外,您还可以提供自己的EnvironmentRepository
bean 作为复合环境的一部分包含在内。为此,您的 bean 必须实现EnvironmentRepository
接口。 如果您想控制自定义的优先级EnvironmentRepository
在复合环境中,还应实现Ordered
接口并覆盖getOrdered
方法。 如果您不实现Ordered
界面,您的EnvironmentRepository
被赋予最低优先级。