合成的 helm Deployment 上的多键凭据
一个单一的无状态应用,由 helm provider 的 Workload 合成渲染到 Kubernetes 上——不使用外部 chart。该应用从一个 secret 中读取两个数据键: 用户名和密码。一个凭据槽位同时支撑这两个键,由一个 多键可引用凭据填充。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example multikey-secret-synth然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd multikey-secret-synth构建
aggrega build --release release.yaml --auto-pullcatalog 从 .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)。这里调用方提供了两个键:
features: app_credentials: type: core/referenced-secret-set values: entries: - key: db_username value: appuser - key: db_password value: dev-pw-change-meManifest 将 core/referenced-secret-set 映射到 k8s-secret-set
FeatureRecipe,后者渲染出一个同时携带这两个键的 Secret:
[… 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 workloadattachments: 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 从不携带此字段。