Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Gateway Contour — un controlador de ingress nativo de Kubernetes

Este ejemplo compila un stack pequeño y real — un gateway de ingress Contour — a partir de un único Aggregate escrito por el desarrollador, para Kubernetes. El desarrollador declara qué es el gateway; una única Recipe de Ops asigna esa intención al chart de Helm oficial project-contour (servido desde el repositorio de charts HTTPS del proyecto) y renderiza los objetos de Kubernetes.

Contour es un controlador de ingress nativo de Kubernetes. Su plano de control observa los recursos Ingress y HTTPProxy del clúster y programa un plano de datos Envoy, que termina el tráfico HTTP y HTTPS de los clientes y lo balancea hacia los servicios de respaldo que nombran esos recursos. Su entrada de enrutamiento son los propios objetos Ingress del clúster — no un upstream conectado —, así que el gateway no toma ninguna arista uses. Las aplicaciones llegan a él declarando recursos Ingress con su clase de ingress. Por el mismo motivo no tiene una forma independiente de contenedor local, así que esta familia incluye solo una Recipe de Helm; no hay destino de Compose.

Archivos

ArchivoRol
aggregate.yamlIntención del desarrollador: un único componente gateway (core/gateway/contour) que nombra la clase de ingress que reconcilia.
manifest.yamlAsigna el tipo de gateway a la Recipe de Helm project-contour (contour).
release.yamlDocumento del operador para el destino Kubernetes: el puerto del servicio de Envoy y el dimensionamiento del plano de control y del plano de datos.

Lo que demuestra

  • Una sola superficie de autoría, realizada por una Recipe de Ops. El Aggregate es la fuente de verdad de qué es el gateway. El Manifest dice cómo realizarlo asignando el tipo de gateway a una Recipe por nombre; la Release aporta el dimensionamiento operativo. La intención del desarrollador y la asignación de Ops se mantienen separadas.
  • Plano de control y plano de datos a partir de un solo componente. La Recipe renderiza las dos mitades del controlador de ingress: un Deployment para el plano de control de Contour y un DaemonSet para el plano de datos de Envoy, conectados entre sí por el chart.
  • Propiedad de la clase de ingress. El valor ingress_class_name del desarrollador fluye hacia el chart, que crea una IngressClass con ese nombre. Las aplicaciones enrutan hacia el gateway referenciando esa clase en sus recursos Ingress.
  • Gestión de CRD. Contour instala y gestiona sus propias CustomResourceDefinitions (su familia HTTPProxy). La Recipe deja activada la gestión de CRD de forma predeterminada; desactívala mediante infra.overrides.manage_crds cuando las CRD estén preinstaladas.
  • Punto de entrada del plano de datos. El Service de Envoy se expone como LoadBalancer de forma predeterminada; el operador establece el puerto del servicio HTTP mediante infra.port y puede cambiar el tipo de servicio mediante infra.overrides.service_type.
  • Imágenes reproducibles. La Recipe vuelve a fijar las imágenes de Contour y Envoy en tags de release explícitos, de modo que las cargas de trabajo renderizadas referencian versiones fijadas.

Generar el ejemplo

Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example contour-gateway

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd contour-gateway

Compilación

Este espacio de trabajo no contiene ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no hace falta ningún flag de catálogo:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Los artefactos renderizados quedan bajo dist/. La compilación resuelve el chart upstream con aggrega pull y lo fija en un lockfile.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `contour-gateway`, llama una vez a la herramienta `scaffold` con `example` establecido en `contour-gateway` y sin `dir`: escribe el ejemplo en una nueva carpeta `contour-gateway`. Después llama a la herramienta `build` con `workspace_root` establecido en `contour-gateway`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `contour-gateway/dist/`.

Qué se renderiza

La compilación emite el stack completo del controlador de ingress:

  • un Deployment que ejecuta el plano de control de Contour,
  • un DaemonSet que ejecuta el plano de datos de Envoy,
  • las CustomResourceDefinitions de Contour,
  • una IngressClass llamada contour,
  • un Service LoadBalancer delante de Envoy en el puerto HTTP 80 y el puerto HTTPS 443,

junto con la ConfigMap de soporte, el Job de generación de certificados, el Service del plano de control, la NetworkPolicy, RBAC y el ServiceAccount. Las imágenes de Contour y Envoy están fijadas a sus tags de release, así que cada carga de trabajo referencia un tag de imagen fijado.