AWS Secrets Manager

当使用 AWS Secrets Manager 作为后端时,可以通过将配置放在 /application/ 中或放在应用程序的 default profile 中来与所有应用程序共享配置。例如,如果您添加具有以下键的 Secrets,则所有使用配置服务器的应用程序都将拥有属性 shared.fooshared.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