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

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 助手替你构建。

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

Terminal window
aggrega scaffold --example mariadb-helm-synth

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

Terminal window
cd mariadb-helm-synth

构建

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

catalog 从 .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-me

Black-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。承载它的文件名 是单独推导的,形式不同:它以组件名和槽名 作为附件自身的坐标作为前缀,并按只允许小写字母和数字的 文件名字母表编码,因此 下划线在其中以转义形式出现,而不是连字符。

db--user-zupassword--db-secret-db-user-password.yaml
[… 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 从不包含这些字段。