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 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example mariadb-bitnami-credential-set然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd mariadb-bitnami-credential-set构建
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:
[… 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。