AWS Secrets Manager
当使用 AWS Secrets Manager 作为后端时,可以通过将配置放在 /application/
中或放在应用程序的 default
profile 中来与所有应用程序共享配置。例如,如果您添加具有以下键的 Secrets,则所有使用配置服务器的应用程序都将拥有属性 shared.foo
和 shared.bar
secret name = /secret/application-default/
secret value =
{
shared.foo: foo,
shared.bar: bar
}
或
secret name = /secret/application/
secret value =
{
shared.foo: foo,
shared.bar: bar
}
带标签的版本
AWS Secrets Manager 仓库允许保留配置环境的标签版本,就像 Git 后端一样。
仓库实现将 HTTP 资源的 {label}
参数映射到 AWS Secrets Manager 密钥的暂存标签 (staging label)。要创建标签密钥,请创建一个密钥或更新其内容,并为其定义一个暂存标签(在 AWS 文档中有时称为版本阶段)。例如
$ aws secretsmanager create-secret \
--name /secret/test/ \
--secret-string '{"version":"1"}'
{
"ARN": "arn:aws:secretsmanager:us-east-1:123456789012:secret:/secret/test/-a1b2c3",
"Name": "/secret/test/",
"VersionId": "cd291674-de2f-41de-8f3b-37dbf4880d69"
}
$ aws secretsmanager update-secret-version-stage \
--secret-id /secret/test/ \
--version-stage 1.0.0 \
--move-to-version-id cd291674-de2f-41de-8f3b-37dbf4880d69
{
"ARN": "arn:aws:secretsmanager:us-east-1:123456789012:secret:/secret/test/-a1b2c3",
"Name": "/secret/test/",
}
使用 spring.cloud.config.server.aws-secretsmanager.default-label
属性设置默认标签。如果未定义此属性,后端将使用 AWSCURRENT 作为暂存标签。
spring:
profiles:
active: aws-secretsmanager
cloud:
config:
server:
aws-secretsmanager:
region: us-east-1
default-label: 1.0.0
注意,如果未设置默认标签且请求未定义标签,仓库将像禁用了标签版本支持一样使用密钥。此外,默认标签仅在启用了标签支持时使用。否则,定义此属性毫无意义。
注意,如果暂存标签包含斜杠 (/
),则 HTTP URL 中的标签应改用特殊字符串 ({special-string})
指定(以避免与其他 URL 路径产生歧义),这与 Git 后端章节 中描述的方式相同。
使用 spring.cloud.config.server.aws-secretsmanager.ignore-label
属性将忽略 HTTP 资源的 {label}
参数以及 spring.cloud.config.server.aws-secretsmanager.default-label
属性。仓库将像禁用了标签版本支持一样使用密钥。
spring:
profiles:
active: aws-secretsmanager
cloud:
config:
server:
aws-secretsmanager:
region: us-east-1
ignore-label: true