Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzige Komponente gateway (core/gateway/contour), die die Ingress-Klasse nennt, die sie abgleicht.
manifest.yamlBildet den Gateway-Typ auf das Helm-Recipe project-contour (contour) ab.
release.yamlDokument 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 Deployment für die Contour-Control-Plane und ein DaemonSet für die Envoy-Data-Plane, vom Chart miteinander verbunden.
  • Eigentum an der Ingress-Klasse. Der Wert ingress_class_name des Entwicklers fließt in das Chart, das eine IngressClass dieses 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 (seine HTTPProxy-Familie). Das Recipe lässt die CRD-Verwaltung standardmäßig eingeschaltet; deaktivieren Sie sie über infra.overrides.manage_crds, wenn die CRDs vorinstalliert sind.
  • Einstiegspunkt der Data Plane. Der Envoy-Service wird standardmäßig als LoadBalancer verfügbar gemacht; der Operator setzt den HTTP-Service-Port über infra.port und kann den Service-Typ über infra.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:

Terminal window
aggrega scaffold --example contour-gateway

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd contour-gateway

Build

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:

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

Gerenderte 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 IngressClass namens contour,
  • einen LoadBalancer-Service vor 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.