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

MariaDB(Bitnami chart)——一个多键凭据 Secret

一个由 Bitnami Helm chart 实现的单一 MariaDB 数据库,其 密码由一个多键可引用 secret (core/referenced-secret-set)提供。

Bitnami chart 从 auth.existingSecret 指定的单个 Kubernetes Secret 进行认证, 并要求该 Secret 携带固定的数据键—— mariadb-root-password,以及在设置了自定义用户时的 mariadb-password (复制部署还会增加 mariadb-replication-password)。没有 用于重命名这些键的选项;它们由 chart 固定。

开发者不让数据库 Recipe 去猜测 Secret 的名称,而是 附加一个恰好携带这些固定键的多键凭据, Recipe 从 .features.root_password.provides.name 读取所生成 Secret 的名称。 引用名称与所生成 Secret 的 metadata.name 是同一个值—— 不存在重新推导,也不存在需要双方达成一致的约定。

生成示例

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

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

Terminal window
aggrega scaffold --example mariadb-bitnami-credential-set

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

Terminal window
cd mariadb-bitnami-credential-set

构建

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

--auto-pull 会在构建期间写入全新克隆所缺少的 lockfile。

mariadb-bitnami Recipe 从本示例自己的本地 catalog/ 副本解析——这是一个由企业编写的本地来源 Recipe——而 core/datastore/mariadb Component 和凭据 feature 从 .aggrega-config.yaml 指定的默认注册表 hub.aggrega.ai 解析;本地 catalog/ 列在该文件的 catalog_dirs 下。Bitnami chart 从其 OCI 源拉取。

借助 AI 助手

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

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

凭据生成的内容

db component 将 core/referenced-secret-set 附加到其必需的 root_password 槽位,并以数据形式提供 chart 的固定键名。 Manifest 将该凭据映射到 k8s-secret-set,后者生成一个 Kubernetes Secret,并将其名称发布为 provides.name:

dist/app/helm/db--root-zupassword--db-secret-db-root-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-root-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
mariadb-root-password: "dev-root-pw-change-me"
mariadb-password: "dev-user-pw-change-me"

chart 引用的内容

mariadb-bitnami Recipe 根据槽位发布的名称连接 auth.existingSecret, 因此渲染出的 StatefulSet 挂载的是凭据生成的同一个 Secret ——双方都读取 .features.root_password.provides.name:

# dist/app/helm/db-statefulset-default-db-mariadb.yaml (credential volume)
- name: mariadb-credentials
secret:
secretName: db-root-password # == the produced Secret's metadata.name
items:
- key: mariadb-root-password # a fixed key the chart reads
path: mariadb-root-password
- key: mariadb-password
path: mariadb-password

由于设置了 auth.existingSecret,chart 不会自行生成 Secret——构建中唯一的 Secret 就是凭据生成的那个。

单键的同类

core/referenced-secret(参见 credential-secretkeyref 示例)是 同一系列中的单键成员:它封装一个由调用方命名的数据键, 并同时发布资源名称和该键,供通过 secretKeyRef 引用 单个键的使用方使用。当使用目标从其整体命名的一个 Secret 中读取一组固定的键时, 如 Bitnami chart 那样,请改用 core/referenced-secret-set。