Contour 网关——Kubernetes 原生的 ingress 控制器
本示例从一个由 Developer 编写的 Aggregate 出发,将一个小型的真实技术栈——Contour ingress 网关——编译到 Kubernetes。开发者声明网关是什么;单个 Ops Recipe 将这一意图映射到官方的
project-contour Helm chart(由该项目的 HTTPS chart 仓库提供),并渲染出 Kubernetes 对象。
Contour 是 Kubernetes 原生的 ingress 控制器。其控制平面监视集群的 Ingress 和 HTTPProxy 资源,并对 Envoy 数据平面进行编程;数据平面终结客户端的 HTTP 和 HTTPS 流量,并将其负载均衡到这些资源所指定的后端服务。它的路由输入是集群自身的 Ingress 对象,而不是连接的上游,因此该网关不接受 uses 边。应用通过针对其 ingress class 声明 Ingress 资源来访问它。出于同样的原因,它没有独立的本地容器形式,因此这一系列只提供 Helm Recipe,没有 Compose 目标。
文件
| 文件 | 角色 |
|---|---|
aggregate.yaml | 开发者意图:单个 gateway 组件(core/gateway/contour),指明它所协调的 ingress class。 |
manifest.yaml | 将网关类型映射到 project-contour Helm Recipe(contour)。 |
release.yaml | 面向 Kubernetes 目标的运维记录:Envoy 服务端口以及控制平面/数据平面的规模配置。 |
演示内容
- 单一编写界面,由 Ops Recipe 实现。 Aggregate 是网关是什么的事实来源。Manifest 通过按名称将网关类型映射到 Recipe,说明如何实现它;Release 提供运维规模配置。开发者意图与 Ops 映射保持分离。
- 由一个组件生成控制平面和数据平面。 该 Recipe 渲染 ingress 控制器的两部分:用于 Contour 控制平面的
Deployment,以及用于 Envoy 数据平面的DaemonSet,二者由 chart 连接在一起。 - ingress class 归属。 开发者的
ingress_class_name值传入 chart,chart 会创建同名的IngressClass。应用在其 Ingress 资源中引用该 class,即可路由到该网关。 - CRD 管理。 Contour 安装并管理其自身的
CustomResourceDefinition(其HTTPProxy系列)。该 Recipe 默认启用 CRD 管理;如果 CRD 已预先安装,可通过infra.overrides.manage_crds禁用。 - 数据平面入口。 Envoy
Service默认以LoadBalancer方式暴露;运维人员通过infra.port设置 HTTP 服务端口,并可通过infra.overrides.service_type更改服务类型。 - 可复现的镜像。 该 Recipe 将 Contour 和 Envoy 镜像重新固定到明确的发布标签,使渲染出的工作负载引用已固定的版本。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example contour-gateway然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd contour-gateway构建
此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志:
aggrega pull --release release.yamlaggrega build --release release.yaml渲染产物位于 dist/ 下。构建在执行 aggrega pull 时解析上游 chart,并将其固定在锁文件中。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自行创建任何文件夹。如果工作区文件夹中还没有 `contour-gateway` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `contour-gateway`,且不设置 `dir`:它会把示例写入新的 `contour-gateway` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `contour-gateway`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我这次构建写入了哪些文件;它们位于 `contour-gateway/dist/` 下。渲染结果
构建会输出完整的 ingress 控制器技术栈:
- 运行 Contour 控制平面的
Deployment, - 运行 Envoy 数据平面的
DaemonSet, - Contour 的
CustomResourceDefinition, - 名为
contour的IngressClass, - 在 HTTP 端口 80 和 HTTPS 端口 443 上作为 Envoy 前端的
LoadBalancerService,
以及配套的 ConfigMap、生成证书的 Job、控制平面的 Service、NetworkPolicy、RBAC 和 ServiceAccount。Contour 和 Envoy 镜像固定到各自的发布标签,因此每个工作负载都引用已固定的镜像标签。