Spring Boot应用程序可以立即利用Spring Config Server(或应用程序开发人员提供的其他外部属性源),它还提取了一些与 Environment
变化事件相关的额外有用特性。
在类路径上具有Spring Cloud Config Client的任何应用程序的默认行为如下:当配置客户端启动时,它会绑定到Config Server(通过 spring.cloud.config.uri
bootstrap配置属性)并使用远程属性源初始化Spring Environment
。
这种行为的最终结果是,所有想要使用Config Server的客户端应用程序都需要一个 bootstrap.yml
(或环境变量),其服务器地址在 spring.cloud.config.uri
中设置(默认为“ http://localhost:8888
" )。
如果你使用 DiscoveryClient
实现,例如Spring Cloud Netflix和Eureka Service Discovery或Spring Cloud Consul,你可以将Config Server注册到Discovery Service,但是,在默认的“配置优先Bootstrap”模式下,客户端无法利用注册。
如果你更喜欢使用 DiscoveryClient
来定位Config Server,可以通过设置 spring.cloud.config.discovery.enabled=true
(默认值为 false
)来实现,这样做的最终结果是客户端应用程序都需要具有适当发现配置的 bootstrap.yml
(或环境变量)。例如,使用Spring Cloud Netflix,你需要定义Eureka服务器地址(例如,在 eureka.client.serviceUrl.defaultZone
中),使用此选项的代价是启动时额外的网络往返,以查找服务注册,好处是,只要Discovery Service是固定点,Config Server就可以更改其坐标。默认服务ID是 configserver
,但你可以通过设置 spring.cloud.config.discovery.serviceId
在客户端上更改它(并在服务器上,以通常的方式提供服务,例如通过设置 spring.application.name
) 。
发现客户端实现都支持某种元数据映射(例如,我们为Eureka提供了 eureka.instance.metadataMap
),可能需要在其服务注册元数据中配置Config Server的一些额外属性,以便客户端可以正确连接。如果使用HTTP Basic保护Config Server,则可以将凭据配置为 user
和 password
,此外,如果Config Server具有上下文路径,则可以设置 configPath
,例如,以下YAML文件用于作为Eureka客户端的Config Server:
eureka: instance: ... metadataMap: user: osufhalskjrtl password: lviuhlszvaorhvlo5847 configPath: /config
在某些情况下,如果服务无法连接到Config Server,你可能希望服务启动失败,如果这是所需的行为,请将bootstrap配置属性 spring.cloud.config.fail-fast=true
设置为使客户端停止并显示异常。
如果你预期配置服务器在应用程序启动时偶尔可能不可用,你可以在失败后继续尝试。首先,你需要设置 spring.cloud.config.fail-fast=true
,然后,你需要在类路径中添加 spring-retry
和 spring-boot-starter-aop
,默认行为是重试六次,初始回退间隔为1000毫秒,后续回退的指数乘数为1.1,你可以通过设置 spring.cloud.config.retry.*
配置属性来配置这些属性(和其他属性)。
要完全控制重试行为,请添加一个类型为 RetryOperationsInterceptor
的 @Bean
,其ID为 configServerRetryInterceptor
,Spring Retry有一个 RetryInterceptorBuilder
支持创建它。
Config Service从 /{name}/{profile}/{label}
提供属性源,其中客户端应用程序中的默认绑定如下:
${spring.application.name}
${spring.profiles.active}
(实际上是 Environment.getActiveProfiles()
)
设置属性 ${spring.application.name}
时,不要在应用程序名称前加上保留字 application-
,以防止解析正确的属性源问题。
你可以通过设置 spring.cloud.config.*
来覆盖所有这些(其中 *
是 name
、 profile
或 label
),该 label
可用于回滚到以前版本的配置,使用默认的Config Server实现,它可以是git标签,分支名称或提交ID。标签也可以以逗号分隔列表的形式提供,在这种情况下,列表中的项目将逐个尝试,直到成功为止,在处理特性分支时,此行为非常有用。例如,你可能希望将配置标签与你的分支对齐,但使其成为可选(在这种情况下,请使用 spring.cloud.config.label=myfeature,develop
)。
当你部署了多个Config Server实例并预期一个或多个实例不时不可用时,为确保高可用性,你可以指定多个URL(作为 spring.cloud.config.uri
属性下的逗号分隔列表),也可以让所有实例在Eureka等Service Registry中注册(如果使用发现优先Bootstrap模式)。请注意,只有在Config Server未运行时(即应用程序已退出时)或发生连接超时时,才能确保高可用性,例如,如果Config Server返回500(内部服务器错误)响应或Config Client从Config Server收到401(由于凭据错误或其他原因),则Config Client不会尝试从其他URL获取属性,这种错误表示用户问题而不是可用性问题。
如果在Config Server上使用HTTP基本安全性,则仅当你在 spring.cloud.config.uri
属性下指定的每个URL中嵌入凭据时,才能支持每个Config Server身份验证凭据,如果使用任何其他类型的安全机制,则无法(目前)支持每个Config Server身份验证和授权。
如果要配置读取超,可以使用属性 spring.cloud.config.request-read-timeout
来完成此操作。
如果你在服务器上使用HTTP Basic安全性,客户端需要知道密码(如果不是默认值,则需要用户名),你可以通过配置服务器URI或单独的用户名和密码属性指定用户名和密码,如以下示例所示:
spring: cloud: config: uri: https://user:secret@myconfig.mycompany.com
以下示例显示了传递相同信息的另一种方法:
spring: cloud: config: uri: https://myconfig.mycompany.com username: user password: secret
spring.cloud.config.password
和 spring.cloud.config.username
值覆盖URI中提供的任何内容。
如果你在Cloud Foundry上部署应用程序,提供密码的最佳方式是通过服务凭据(例如在URI中,因为它不需要在配置文件中),以下示例在本地运行,并在名为 configserver
的Cloud Foundry上为用户提供服务:
spring: cloud: config: uri: ${vcap.services.configserver.credentials.uri:http://user:password@localhost:8888}
如果你使用其他形式的安全性,则可能需要向 ConfigServicePropertySourceLocator
提供一个 RestTemplate
(例如,通过在引导程序上下文中获取它并注入它)。
Config Client提供尝试从Config Server加载配置的Spring Boot Health Indicator,可以通过设置 health.config.enabled=false
来禁用健康指示器,出于性能原因,还会缓存响应,生存的默认缓存时间为5分钟,要更改该值,请设置 health.config.time-to-live
属性(以毫秒为单位)。
在某些情况下,你可能需要自定义从客户端向配置服务器发出的请求,通常,这样做涉及传递特殊的 Authorization
headers来验证对服务器的请求,要提供自定义 RestTemplate
:
PropertySourceLocator
的实现创建一个新的配置bean,如以下示例所示: @Configuration public class CustomConfigServiceBootstrapConfiguration { @Bean public ConfigServicePropertySourceLocator configServicePropertySourceLocator() { ConfigClientProperties clientProperties = configClientProperties(); ConfigServicePropertySourceLocator configServicePropertySourceLocator = new ConfigServicePropertySourceLocator(clientProperties); configServicePropertySourceLocator.setRestTemplate(customRestTemplate(clientProperties)); return configServicePropertySourceLocator; } }
resources/META-INF
中,创建一个名为 spring.factories
的文件并指定自定义配置,如以下示例所示: org.springframework.cloud.bootstrap.BootstrapConfiguration = com.my.config.client.CustomConfigServiceBootstrapConfiguration
使用Vault作为配置服务器的后端时,客户端需要为服务器提供令牌以从Vault检索值,可以通过在 bootstrap.yml
中设置 spring.cloud.config.token
在客户端内提供此令牌,如以下示例所示:
spring: cloud: config: token: YourVaultToken
Vault支持将密钥嵌套在Vault中存储的值中,如以下示例所示:
echo -n '{"appA": {"secret": "appAsecret"}, "bar": "baz"}' | vault write secret/myapp -
此命令将JSON对象写入Vault,要在Spring中访问这些值,可以使用传统的点( .
)注解,如以下示例所示:
@Value("${appA.secret}") String name = "World";
上面的代码会将 name
变量的值设置为 appAsecret
。