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

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.yamlKubernetes 目标的运维记录:服务器的计算规格和数据卷大小。

演示内容

  • 单一编写界面。 单个 Aggregate 是密钥服务器是什么的 唯一事实来源;Manifest 说明如何实现它。
  • 开发者的值流向渲染结果。 开发者的 ui_enabled 值被写入 chart 挂载的服务器配置中,用于控制 内置 Web UI 的开关。
  • 持久卷上的有状态服务器。 来源 Recipe 将服务器配置为使用文件存储后端的独立模式,因此服务器将 其加密状态保存在挂载于 /openbao/data 的 PersistentVolumeClaim 上, 其大小由运维人员的 storage.size 决定。
  • 渲染时无凭据。 OpenBao 在运行时自行完成初始化和解封, 因此构建不连接任何凭据,也不生成 Secret。对于相同输入, 多次运行的渲染输出逐字节相同。
  • 可复现的镜像。 该 Recipe 将服务器镜像固定到一个可解析的发布标签(quay.io/openbao/openbao:2.5.5),因此渲染出的工作负载引用的是一个固定的版本。

生成示例

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

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

Terminal window
aggrega scaffold --example openbao-secrets

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

Terminal window
cd openbao-secrets

构建

此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志:

Terminal window
aggrega pull --release release.yaml
aggrega 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: test Pod,用于探测服务器就绪状态。

其中没有 CustomResourceDefinition——OpenBao 是一个自包含的服务器,而不是扩展集群 API 的控制器。服务器镜像固定到其发布标签,因此工作负载引用的是固定的镜像标签。