sealed-secrets — Kubernetes SealedSecret 解密控制器
本示例将一个小型的真实技术栈——sealed-secrets 控制器——
从一个由 Developer 编写的 Aggregate 编译到 Kubernetes,其底层是由 HTTPS chart 仓库提供的官方
sealed-secrets Helm chart。
sealed-secrets 使加密的机密内容可以安全地提交到源代码管理:
公钥将机密加密为 SealedSecret 自定义资源,
持有对应私钥的集群级控制器再将其解密
还原为原生 Kubernetes Secret。该控制器以自己的 SealedSecret 自定义资源扩展集群 API,
而不是作为应用路由到的服务器,因此它不使用 uses 边,也不向
使用方导出任何内容:应用通过声明 SealedSecret
资源获取机密,控制器则解封出对应的 Kubernetes Secret。
控制器在运行时于集群内生成其密封密钥对,因此渲染时
不会产生任何密钥材料。
文件
| 文件 | 角色 |
|---|---|
aggregate.yaml | Developer 意图:单个 sealed-secrets 组件(core/security/sealed-secrets)。 |
manifest.yaml | 将组件类型映射到官方的外部来源 Recipe(sealed-secrets)。 |
release.yaml | 面向 Kubernetes 目标的 Operator 记录:operator 的计算资源规格。 |
演示内容
- 单一编写入口。 单个 Aggregate 是控制器是什么的 唯一事实来源;Manifest 则说明如何实现它。
- 通过 HTTPS 提供的 chart。 Recipe 从 HTTPS chart 仓库
而非 OCI registry 获取 chart;构建在
aggrega pull时解析并锁定它。 - 随 chart 的 CRD 目录一起提供的 CRD。
SealedSecretCustomResourceDefinition 位于 chart 的 Helm 原生 CRD 目录中,而不在 templates 中;它总是随 release 一起渲染到输出中。 - 扩展集群的控制器,无拓扑边。 sealed-secrets 向集群 API 添加
自己的自定义资源;使用方通过声明
SealedSecret资源请求机密, 因此该组件不连接任何uses边,也不导出 任何内容。 - 单一而完整的控制器。 该 chart 渲染出一个控制器及其 RBAC 和 Service,不含外部数据存储、缓存或消息代理。对于相同输入, 每次运行的渲染输出逐字节相同。
- 可复现的镜像。 Recipe 将控制器镜像锁定到一个可解析的 release 标签(
docker.io/bitnami/sealed-secrets-controller:0.38.4),因此渲染出的工作负载引用的是固定的版本。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example sealed-secrets-controller然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd sealed-secrets-controller构建
此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志:
aggrega pull --release release.yamlaggrega build --release release.yaml渲染产物位于 dist/ 下。构建在 aggrega pull 时从
HTTPS chart 仓库解析上游 chart,并将其锁定在 lockfile 中。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
仅使用 Aggrega 工具,不要自行创建任何文件夹。如果工作区文件夹中还没有 `sealed-secrets-controller` 文件夹,请调用一次 `scaffold` 工具,将 `example` 设为 `sealed-secrets-controller`,且不设 `dir`:它会把示例写入新的 `sealed-secrets-controller` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `sealed-secrets-controller`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `sealed-secrets-controller/dist/` 下。渲染结果
构建将 sealed-secrets 控制器输出为一组 Kubernetes 对象:
- 一个用于 sealed-secrets API(
SealedSecret)的CustomResourceDefinition, - 一个
Deployment——即控制器, - 为其绑定权限的 RBAC:一个
ClusterRole、一个ClusterRoleBinding、两个Role, 以及两个RoleBinding, - 一个
ServiceAccount, - 两个
Service——控制器服务及其指标服务。
控制器镜像锁定到其 release 标签,因此工作负载引用的是固定的镜像标签。