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

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

DateiRolle
aggregate.yamlEntwicklerabsicht: ein Backend web (core/devtool/adminer) und ein Gateway proxy (core/gateway/nginx), das eine Nutzung upstream des Backends deklariert.
manifest-compose.yamlBildet den Gateway-Typ auf das Compose-Recipe (compose/nginx) und das Backend auf das Compose-Recipe für Adminer ab.
manifest-helm-synth.yamlBildet 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.yamlDokumente 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 upstream des Backends; die Werte provides.host und provides.port des Backend-Recipe werden in das Gateway durchgereicht und in das Ziel seines proxy_pass gerendert. 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_pass an 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:

Terminal window
aggrega scaffold --example nginx-gateway

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

Terminal window
cd nginx-gateway

Build

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:

Terminal window
# Local development (Docker Compose)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)
aggrega build --release release-helm-synth.yaml --auto-pull

Gerenderte 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)

Terminal window
aggrega build --release release-compose.yaml --auto-pull
docker 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.