跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

合成的 helm Deployment 上的多键凭据

一个单一的无状态应用,由 helm provider 的 Workload 合成渲染到 Kubernetes 上——不使用外部 chart。该应用从一个 secret 中读取两个数据键: 用户名和密码。一个凭据槽位同时支撑这两个键,由一个 多键可引用凭据填充。

生成示例

你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。

将示例写入一个以其命名的新文件夹:

Terminal window
aggrega scaffold --example multikey-secret-synth

然后它会打印接下来要运行的命令。第一条命令进入新文件夹:

Terminal window
cd multikey-secret-synth

构建

Terminal window
aggrega build --release release.yaml --auto-pull

catalog 从 .aggrega-config.yaml 中指定的两个来源解析:示例自身的 ./catalog(local/compute/app Component 及其 helm/app 合成 Recipe),以及 hub 注册表(多键凭据 Feature、其 FeatureRecipe 以及 helm Provider)。--auto-pull 会在构建期间写入全新克隆所缺少的 lockfile。三个清单生成在 dist/helm/helm/ 下。

借助 AI 助手

已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。

只使用 Aggrega 工具,不要自己创建任何文件夹。如果工作区文件夹中还没有 `multikey-secret-synth` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `multikey-secret-synth`,不设 `dir`:它会把示例写入一个新的 `multikey-secret-synth` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `multikey-secret-synth`、`release` 设为 `release.yaml`、`auto_pull` 设为 true、`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `multikey-secret-synth/dist/` 下。

一个槽位,两个键

该 Component 声明一个透明凭据槽位 app_credentials (inject: [env])。Aggregate 使用 core/referenced-secret-set 填充它—— 这是一个多键可引用凭据,它物化出一个 Kubernetes Secret,其中携带由调用方提供的一组数据键,并且只发布该 Secret 的定位符(provides.name)。这里调用方提供了两个键:

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

Manifest 将 core/referenced-secret-set 映射到 k8s-secret-set FeatureRecipe,后者渲染出一个同时携带这两个键的 Secret:

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: app-app-credentials
[… omitted: the labels and annotations every rendered document carries]
stringData:
db_username: "appuser"
db_password: "dev-pw-change-me"

按各个键引用同一个槽位

合成 Recipe 两次引用同一个槽位——每个数据键一次。每个 条目通过 key 字段指定它读取的数据键;条目的映射键 是环境变量名:

# helm/app recipe workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

合成器为每个条目渲染一个 env secretKeyRef。两者都引用 同一个 Secret(provides.name),各自使用自己的数据键:

# app-deployment.yaml (container env)
- name: APP_DB_USER
valueFrom:
secretKeyRef:
name: app-app-credentials # == the Secret's metadata.name
key: db_username
- name: APP_DB_PASSWORD
valueFrom:
secretKeyRef:
name: app-app-credentials # same Secret
key: db_password # different data key
[… omitted: the GREETING variable, set from the Aggregate's greeting value]

正是 key 字段使多键 secret 能够被合成的 Workload 使用。当条目省略 key 时,它改为读取该槽位唯一发布的数据 键——这是单键凭据(core/referenced-secret) 所用的形式,它同时发布一个定位符和一个键。

运维规格配置

release.yaml 按环境实现运维规格配置这一支柱: 容器镜像标签来自 infra.image_tag(myapp:1.2)。开发者的 Aggregate 从不携带此字段。