本页面由机器翻译。阅读英文原文。
OpenBao — Kubernetes 密钥管理服务器
本示例将一个小型的真实技术栈(单个 OpenBao 密钥
服务器)从一个由开发者编写的 Aggregate 编译到 Kubernetes,并以
官方 OpenBao Helm chart 为基础。
OpenBao 通过经过身份验证的 HTTP API 存储、生成并控制对令牌、密码、 证书及其他密钥的访问,并在持久数据卷上对其静态状态进行加密。 在这里它作为单个独立服务器运行,将状态保存在内置的文件存储后端中,因此它渲染 为由持久卷支撑的有状态运行服务器,而不是托管云资源。 服务器在运行时于集群内完成初始化和解封——其根令牌和解封密钥由运行中的服务器 在启动后生成——因此 Aggregate 中不声明任何凭据,构建时也不会 实体化任何密钥。
文件
| 文件 | 角色 |
|---|---|
aggregate.yaml | 开发者意图:单个 secrets 组件(core/security/openbao),并启用内置 Web UI。 |
manifest.yaml | 将组件类型映射到官方来源的 Recipe(openbao)。 |
release.yaml | Kubernetes 目标的运维记录:服务器的计算规格和数据卷大小。 |
演示内容
- 单一编写界面。 单个 Aggregate 是密钥服务器是什么的 唯一事实来源;Manifest 说明如何实现它。
- 开发者的值流向渲染结果。 开发者的
ui_enabled值被写入 chart 挂载的服务器配置中,用于控制 内置 Web UI 的开关。 - 持久卷上的有状态服务器。 来源 Recipe
将服务器配置为使用文件存储后端的独立模式,因此服务器将
其加密状态保存在挂载于
/openbao/data的PersistentVolumeClaim上, 其大小由运维人员的storage.size决定。 - 渲染时无凭据。 OpenBao 在运行时自行完成初始化和解封,
因此构建不连接任何凭据,也不生成
Secret。对于相同输入, 多次运行的渲染输出逐字节相同。 - 可复现的镜像。 该 Recipe 将服务器镜像固定到一个可解析的发布标签(
quay.io/openbao/openbao:2.5.5),因此渲染出的工作负载引用的是一个固定的版本。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example openbao-secrets然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd openbao-secrets构建
此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志:
aggrega pull --release release.yamlaggrega build --release release.yaml渲染产物位于 dist/ 下。构建在执行 aggrega pull 时通过 OCI 引用解析上游 chart,并将其固定在锁文件中。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自己创建任何文件夹。如果 Workspace 文件夹中还没有 `openbao-secrets` 文件夹,就调用一次 `scaffold` 工具,将 `example` 设为 `openbao-secrets`,不设 `dir`:它会把示例写入新的 `openbao-secrets` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `openbao-secrets`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我这次构建写入了哪些文件;它们位于 `openbao-secrets/dist/` 下。渲染结果
构建将精简的单工作负载 OpenBao 技术栈生成为七个 Kubernetes 对象:
- 一个用于 OpenBao 服务器的
StatefulSet, - 一个承载服务器配置(文件存储后端和
API 监听器)的
ConfigMap, - 两个
Service——主 API 服务,以及 StatefulSet 用于稳定 Pod 网络的内部无头服务, - 一个用于服务器 Pod 的
ServiceAccount, - 一个
ClusterRoleBinding,授予服务器用于验证 Kubernetes 服务账号的令牌审查权限, - 一个
helm.sh/hook: testPod,用于探测服务器就绪状态。
其中没有 CustomResourceDefinition——OpenBao 是一个自包含的服务器,而不是扩展集群 API 的控制器。服务器镜像固定到其发布标签,因此工作负载引用的是固定的镜像标签。