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

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.yamlDeveloper 意图:单个 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。 SealedSecret CustomResourceDefinition 位于 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 助手替你构建。

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

Terminal window
aggrega scaffold --example sealed-secrets-controller

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

Terminal window
cd sealed-secrets-controller

构建

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

Terminal window
aggrega pull --release release.yaml
aggrega 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 标签,因此工作负载引用的是固定的镜像标签。