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

cert-manager — Kubernetes TLS 证书生命周期控制器

本示例将一个小型的真实技术栈——一个 cert-manager 证书控制器——从一个由 Developer 编写的 Aggregate 编译到 Kubernetes。开发者声明 cert-manager 是什么;一个 Ops Recipe 将该意图映射到 jetstack 仓库中官方的 cert-manager Helm chart,并渲染出 Kubernetes 对象。

cert-manager 是一个集群范围的 Kubernetes 附加组件,用于自动从 ACME(Let’s Encrypt)、私有 CA 或 Vault 等签发源签发和续期 X.509 证书。它通过自己的 Certificate、Issuer 和 ClusterIssuer 自定义资源扩展集群。应用通过声明这些资源来申请证书,而不是连接上游,因此该组件没有 uses 边。出于同样的原因,它没有独立的本地容器形式,所以该系列只提供一个 Helm Recipe;没有 Compose 目标。该组件发布的唯一内容是 Prometheus 服务器获取其指标的位置。

文件

文件角色
aggregate.yaml开发者意图:一个启用了 CRD 安装的 cert-manager 组件(core/security/cert-manager)。
manifest.yaml将组件类型映射到 cert-manager Helm Recipe(cert-manager)。
release.yamlKubernetes 目标的运维记录:控制器、webhook 和 CA 注入器的资源规格。

演示内容

  • 一个编写界面,由 Ops Recipe 实现。 Aggregate 是 cert-manager 是什么的唯一事实来源。Manifest 通过按名称将组件类型映射到 Recipe,说明如何实现它;Release 提供运维规格。开发者意图与 Ops 映射保持分离。
  • 一个组件生成三个协同的工作负载。 该 Recipe 渲染 cert-manager 的全部三个部分:一个用于协调证书请求的控制器的 Deployment,一个用于校验自定义资源并设置其默认值的 webhook 的 Deployment,以及一个将 webhook 的 CA 证书包注入集群的 CA 注入器的 Deployment。
  • 证书 API 安装。 开发者的 install_crds 值传入 chart,chart 据此安装 cert-manager 的 CustomResourceDefinition(Certificate、Issuer、ClusterIssuer 以及 ACME Order/Challenge 资源)。当 CRD 由带外方式管理时,将其设为 false。
  • 准入连接。 chart 生成 webhook 所服务的 ValidatingWebhookConfiguration 和 MutatingWebhookConfiguration、webhook 的 Service,以及完整的 RBAC 集合——每项控制器职责各一个 ClusterRole/ClusterRoleBinding,外加用于领导者选举的 Role——使控制器拥有所需的权限。
  • 可复现的镜像。 chart 提供可解析的发布标签;Recipe 将控制器、webhook、CA 注入器和 ACME solver 镜像重新固定到这些标签,使渲染出的工作负载引用已固定的版本。

生成示例

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

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

Terminal window
aggrega scaffold --example cert-manager-tls

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

Terminal window
cd cert-manager-tls

构建

此工作区不带 .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 的工具,不要自己创建任何文件夹。如果工作区文件夹中还没有 `cert-manager-tls` 文件夹,就调用一次 `scaffold` 工具,将 `example` 设为 `cert-manager-tls`,且不提供 `dir`:它会把示例写入一个新的 `cert-manager-tls` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `cert-manager-tls`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `cert-manager-tls/dist/` 下。

渲染结果

构建生成完整的 cert-manager 技术栈——三个 Deployment(控制器、webhook 和 CA 注入器)、启用 install_crds 时的六个 cert-manager CustomResourceDefinition、一个 ValidatingWebhookConfiguration 和一个 MutatingWebhookConfiguration、webhook 的 Service、控制器的 ServiceAccount,以及由 ClusterRole、ClusterRoleBinding 和领导者选举用的 Role 与 RoleBinding 组成的 RBAC 集合。此外还包括一个安装后 Job(启动时的 API 检查,会阻塞直到证书 API 开始提供服务),以及控制器和 CA 注入器各自的指标 Service——共计 50 个 Kubernetes 对象。控制器、webhook、CA 注入器和 ACME solver 镜像均固定到各自的发布标签,因此每个工作负载都引用已固定的镜像标签。