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

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 助手替你构建。

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

Terminal window
aggrega scaffold --example contour-gateway

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

Terminal window
cd contour-gateway

构建

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

Terminal window
aggrega pull --release release.yaml
aggrega 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 前端的 LoadBalancer Service,

以及配套的 ConfigMap、生成证书的 Job、控制平面的 Service、NetworkPolicy、RBAC 和 ServiceAccount。Contour 和 Envoy 镜像固定到各自的发布标签,因此每个工作负载都引用已固定的镜像标签。