Contour-Gateway — ein Kubernetes-nativer Ingress-Controller
Dieses Beispiel kompiliert einen kleinen, echten Stack — ein Contour-Ingress-Gateway — aus einem einzigen vom Entwickler verfassten Aggregate zu Kubernetes. Der Entwickler deklariert, was das Gateway ist; ein einziges Ops-Recipe bildet diese Absicht auf das offizielle Helm-Chart project-contour ab (bereitgestellt aus dem HTTPS-Chart-Repository des Projekts) und rendert die Kubernetes-Objekte.
Contour ist ein Kubernetes-nativer Ingress-Controller. Seine Control Plane beobachtet die Ressourcen Ingress und HTTPProxy des Clusters und programmiert eine Envoy-Data-Plane, die den HTTP- und HTTPS-Verkehr der Clients terminiert und ihn per Lastverteilung an die dahinterliegenden Services weiterleitet, die diese Ressourcen nennen. Seine Routing-Eingabe sind die eigenen Ingress-Objekte des Clusters — kein verdrahteter Upstream —, daher nimmt das Gateway keine uses-Kante. Anwendungen erreichen es, indem sie Ingress-Ressourcen für seine Ingress-Klasse deklarieren. Aus demselben Grund hat es keine eigenständige lokale Container-Form, daher liefert diese Familie nur ein Helm-Recipe aus; es gibt kein Compose-Ziel.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzige Komponente gateway (core/gateway/contour), die die Ingress-Klasse nennt, die sie abgleicht. |
manifest.yaml | Bildet den Gateway-Typ auf das Helm-Recipe project-contour (contour) ab. |
release.yaml | Dokument des Operators für das Kubernetes-Ziel: der Service-Port von Envoy und die Dimensionierung von Control Plane und Data Plane. |
Was es zeigt
- Eine Authoring-Oberfläche, realisiert durch ein Ops-Recipe. Das Aggregate ist die maßgebliche Quelle dafür, was das Gateway ist. Das Manifest sagt, wie es realisiert wird, indem es den Gateway-Typ über den Namen auf ein Recipe abbildet; das Release liefert die betriebliche Dimensionierung. Entwicklerabsicht und Ops-Zuordnung bleiben getrennt.
- Control Plane und Data Plane aus einer Komponente. Das Recipe rendert beide Hälften des Ingress-Controllers: ein
Deploymentfür die Contour-Control-Plane und einDaemonSetfür die Envoy-Data-Plane, vom Chart miteinander verbunden. - Eigentum an der Ingress-Klasse. Der Wert
ingress_class_namedes Entwicklers fließt in das Chart, das eineIngressClassdieses Namens erstellt. Anwendungen leiten zum Gateway, indem sie in ihren Ingress-Ressourcen auf diese Klasse verweisen. - CRD-Verwaltung. Contour installiert und verwaltet seine eigenen
CustomResourceDefinitions (seineHTTPProxy-Familie). Das Recipe lässt die CRD-Verwaltung standardmäßig eingeschaltet; deaktivieren Sie sie überinfra.overrides.manage_crds, wenn die CRDs vorinstalliert sind. - Einstiegspunkt der Data Plane. Der Envoy-
Servicewird standardmäßig alsLoadBalancerverfügbar gemacht; der Operator setzt den HTTP-Service-Port überinfra.portund kann den Service-Typ überinfra.overrides.service_typeändern. - Reproduzierbare Images. Das Recipe fixiert die Images von Contour und Envoy erneut auf explizite Release-Tags, sodass die gerenderten Arbeitslasten fixierte Versionen referenzieren.
Das Beispiel generieren
Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example contour-gatewayDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd contour-gatewayBuild
Dieser Workspace enthält keine .aggrega-config.yaml, daher werden die Entitäten der Standardbibliothek aus der Hub-Registry hub.aggrega.ai aufgelöst, und es ist kein Katalog-Flag nötig:
aggrega pull --release release.yamlaggrega build --release release.yamlGerenderte Artefakte landen unter dist/. Der Build löst das Upstream-Chart bei aggrega pull auf und fixiert es in einem Lockfile.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Arbeitsbereichsordner noch keinen Ordner `contour-gateway` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `contour-gateway` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `contour-gateway`. Rufen Sie dann das Tool `build` mit `workspace_root` auf `contour-gateway`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt auf. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `contour-gateway/dist/`.Was gerendert wird
Der Build gibt den vollständigen Ingress-Controller-Stack aus:
- ein
Deployment, das die Contour-Control-Plane ausführt, - ein
DaemonSet, das die Envoy-Data-Plane ausführt, - die
CustomResourceDefinitions von Contour, - eine
IngressClassnamenscontour, - einen
LoadBalancer-Servicevor Envoy auf HTTP-Port 80 und HTTPS-Port 443,
daneben die unterstützende ConfigMap, den Job zur Zertifikatserzeugung, den Service der Control Plane, NetworkPolicy, RBAC und ServiceAccount. Die Images von Contour und Envoy sind auf ihre Release-Tags fixiert, sodass jede Arbeitslast einen fixierten Image-Tag referenziert.