NGINX-Gateway — Reverse-Proxy-Routing zu einem Upstream, zwei Ziele
Dieses Beispiel kompiliert einen kleinen, realen Stack — ein NGINX-Reverse-Proxy-Gateway vor einem Web-Backend — aus einem einzigen vom Entwickler verfassten Aggregate für zwei Ziele:
- Docker Compose für die lokale Entwicklung und
- synthetisierte Kubernetes-Manifeste für einen Cluster.
Dasselbe aggregate.yaml steuert beide. Pro Ziel ändert sich nur die vom Manifest ausgewählte Recipe-Schicht.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: ein Backend web (core/devtool/adminer) und ein Gateway proxy (core/gateway/nginx), das eine Nutzung upstream des Backends deklariert. |
manifest-compose.yaml | Bildet den Gateway-Typ auf das Compose-Recipe (compose/nginx) und das Backend auf das Compose-Recipe für Adminer ab. |
manifest-helm-synth.yaml | Bildet den Gateway-Typ auf das synth-helm-Recipe (helm/nginx) und das Backend auf das Offline-helm-Recipe für Adminer ab. |
release-compose.yaml / release-helm-synth.yaml | Dokumente des Operators für die beiden Ziele. |
Was es zeigt
- Eine Authoring-Oberfläche, viele Ziele. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was der Stack ist. Jedes Manifest sagt, wie er zu realisieren ist.
- Upstream-Routing über die String Pipe. Das Gateway deklariert eine Nutzung
upstreamdes Backends; die Werteprovides.hostundprovides.portdes Backend-Recipe werden in das Gateway durchgereicht und in das Ziel seinesproxy_passgerendert. Der Compiler leitet die Strings weiter, ohne sie zu interpretieren — so verdrahtet der Compose-Build einen Compose-Servicenamen und der Kubernetes-Build einen Service-Namen, aus derselben Kante. - Provider-idiomatische Konfiguration. Auf beiden Zielen schreibt das Gateway beim Start des Containers einen minimalen NGINX-Serverblock, dessen
proxy_passan den injizierten Upstream weiterleitet, und startet dann nginx im Vordergrund. Das Kubernetes-Ziel realisiert dies als zustandsloses Deployment plus einen ClusterIP-Service, ohne externes Helm-Chart. - Reproduzierbare Images. Das Kubernetes-Ziel führt das offizielle Upstream-Image von nginx aus, fixiert auf einen expliziten Tag, sodass das gerenderte Deployment ein stabiles Image referenziert.
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 nginx-gatewayDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd nginx-gatewayBuild
Dieser Workspace enthält kein .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; --auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)aggrega build --release release-helm-synth.yaml --auto-pullGerenderte Artefakte landen unter dist/. Das Kubernetes-Ziel rendert einfache Manifeste offline — es ist kein Chart-Pull erforderlich.
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 Workspace-Ordner noch keinen Ordner `nginx-gateway` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `nginx-gateway` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `nginx-gateway`. Rufen Sie dann das Tool `build` einmal für jedes Release auf, in dieser Reihenfolge — `release-compose.yaml` und `release-helm-synth.yaml` — jedes Mal mit `workspace_root` auf `nginx-gateway`, `release` auf die jeweilige Datei, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die jeder Build geschrieben hat; sie liegen unter `nginx-gateway/dist/`.Wie der injizierte Upstream aussieht
Auf Compose führt der Gateway-Service NGINX mit einem Serverblock aus, der auf den Compose-Servicenamen und den Port des Backends zielt:
server { listen 8000; location / { proxy_pass http://web:8080; } }Auf Kubernetes gelangt dasselbe Routing in den Container-Befehl, der die Serverkonfiguration schreibt, bevor er nginx startet, und auf den Service des Backends zielt — der helm-Provider benennt ihn nach dem Backend und dessen Service-Schlüssel default:
server { listen 8080; location / { proxy_pass http://web-default:8080; } }Beide ergeben sich aus derselben Aggregate-Kante — Host und Port des Backends gelangen über die Nutzung upstream dorthin, und jedes Ziel rendert sie in seiner eigenen Ausdrucksweise.
Ausführen (Compose)
aggrega build --release release-compose.yaml --auto-pulldocker compose -f dist/app/compose/docker-compose.yaml up -dÖffnen Sie http://localhost:8000 — NGINX leitet die Anfrage an das Backend weiter. Abbauen mit docker compose -f dist/app/compose/docker-compose.yaml down.