Kubernetes 上的 MariaDB — 合成的 helm(StatefulSet),双槽凭据
由 helm provider 的 Workload
合成在 Kubernetes 上渲染的单个 MariaDB 数据库 — 不使用外部 chart。core/datastore/mariadb Component 绑定到
helm/mariadb Recipe,该 Recipe 声明了一个 form: stateful Workload;helm provider
将其转换为一个 StatefulSet、一个 ClusterIP Service、一个 Headless
Service(StatefulSet 的稳定网络标识),以及一个用于数据目录的
volumeClaimTemplate。
本示例旨在展示 MariaDB 在 合成 helm 目标上的双槽凭据模型。两个密码槽通过不同的 机制交付,因为 Component 以不同方式声明它们,而 Recipe 按 每个槽的要求分别连接。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example mariadb-helm-synth然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd mariadb-helm-synth构建
aggrega build --release release.yaml --auto-pullcatalog 从 .aggrega-config.yaml 中指定的 hub 注册表解析,因此不需要 --catalog 标志,并且 --auto-pull 会在构建期间写入全新克隆所缺少的 lockfile。四个 manifest 生成在 dist/helm/helm/ 下。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自己创建任何文件夹。如果工作区文件夹中还没有 `mariadb-helm-synth` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `mariadb-helm-synth`,不设 `dir`:它会把示例写入一个新的 `mariadb-helm-synth` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `mariadb-helm-synth`、`release` 设为 `release.yaml`、`auto_pull` 设为 true、`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `mariadb-helm-synth/dist/` 下。root_password — Black-Box,通过 inject 管道交付
root_password 是一个 Black-Box 槽:Component 的 featuresSchema 声明了
inject: [],因此由 Recipe 控制交付,开发者无法指定。
Aggregate 附加 core/secret-value,Manifest 将其映射到
env-secret。该 FeatureRecipe 将值以所选键放到组件的 inject 管道上,
Recipe 以
.context.inject.env.MARIADB_ROOT_PASSWORD 读取它,并输出一个普通的容器环境变量:
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meBlack-Box 槽从不在 workload 容器的 attachments: 块中被引用,也不会
为其生成 Kubernetes Secret 资源 — 值直接通过 inject 管道
到达容器。
user_password — 透明,以 Secret + secretKeyRef 交付
user_password 是一个透明槽(inject: [env, file])。Aggregate
附加 core/referenced-secret,Manifest 将其映射到
k8s-secret-from-parameter。该 FeatureRecipe 生成一个 Kubernetes Secret,
并以 provides {name, key} 发布该 Secret 的标识。Recipe
通过 containers.attachments 引用该槽,合成器将其渲染为
环境变量 secretKeyRef。生成的 Secret 与容器的引用指向
同一个资源,因为两者都读取 .features.user_password.provides.name — 不存在
重新推导,也不需要双方遵守任何约定。发布的
名称会将槽名中的下划线规范化为连字符,因此 user_password
变为有效的 Kubernetes 资源名 db-user-password。承载它的文件名
是单独推导的,形式不同:它以组件名和槽名
作为附件自身的坐标作为前缀,并按只允许小写字母和数字的
文件名字母表编码,因此
下划线在其中以转义形式出现,而不是连字符。
[… omitted: the apiVersion and the Secret kind]metadata: name: db-user-password [… omitted: the labels and annotations every rendered document carries]stringData: MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)- name: MARIADB_PASSWORD valueFrom: secretKeyRef: name: db-user-password # == the Secret's metadata.name key: MARIADB_PASSWORD # == the Secret's data key不附加 user_password 同样有效:Recipe 会回退到
内联的开发默认值(MARIADB_PASSWORD: apppass),且不生成 Secret,
因此最小化部署仍能渲染并运行。
运维规格配置
release.yaml 按环境实现运维规格配置这一支柱:容器
镜像标签来自 infra.engine_version(mariadb:11.4),
volumeClaimTemplate 的请求量和存储类来自 infra.storage
(5Gi、standard)。开发者的 Aggregate 从不包含这些字段。