Brama NGINX — routing reverse proxy do upstreamu, dwa cele
Ten przykład kompiluje mały, rzeczywisty stos — bramę reverse proxy NGINX przed backendem webowym — z jednej encji Aggregate utworzonej przez programistę do dwóch celów:
- Docker Compose do lokalnego programowania oraz
- syntetyzowane manifesty Kubernetes dla klastra.
Ten sam plik aggregate.yaml steruje oboma. Dla każdego celu zmienia się tylko warstwa encji Recipe wybrana przez
encję Manifest.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: backend web (core/devtool/adminer) i brama proxy (core/gateway/nginx), która deklaruje użycie upstream backendu. |
manifest-compose.yaml | Mapuje typ bramy na encję Recipe dla Compose (compose/nginx), a backend na encję Recipe Adminer dla Compose. |
manifest-helm-synth.yaml | Mapuje typ bramy na syntetyczną encję Recipe helm (helm/nginx), a backend na offline’ową encję Recipe Adminer helm. |
release-compose.yaml / release-helm-synth.yaml | Rekordy operatora dla obu celów. |
Co demonstruje
- Jedna powierzchnia tworzenia, wiele celów. Pojedyncza encja Aggregate jest źródłem prawdy o tym, czym jest stos. Każda encja Manifest mówi, jak go zrealizować.
- Routing upstream przez String Pipe. Brama deklaruje
użycie
upstreambackendu; wartościprovides.hostiprovides.portencji Recipe backendu są przekazywane do bramy i renderowane jako jej celproxy_pass. Kompilator przekazuje ciągi znaków bez ich interpretowania — dlatego kompilacja Compose podłącza nazwę usługi compose, a kompilacja Kubernetes podłącza nazwę obiektu Service, z tej samej krawędzi. - Konfiguracja idiomatyczna dla Provider. Na obu targetach gateway przy starcie kontenera zapisuje
minimalny blok server NGINX, którego
proxy_passprzekazuje ruch do wstrzykniętego upstreamu, a następnie uruchamia nginx na pierwszym planie. Target Kubernetes realizuje to jako bezstanowy Deployment wraz z Service typu ClusterIP, bez zewnętrznego chartu Helm. - Powtarzalne obrazy. Cel Kubernetes uruchamia oficjalny obraz nginx z upstreamu przypięty do jawnego tagu, dzięki czemu wyrenderowany Deployment odwołuje się do stabilnego obrazu.
Generowanie przykładu
Ten przykład można zbudować za pomocą poniższych poleceń albo zlecić jego zbudowanie asystentowi AI.
Należy zapisać przykład w nowym folderze nazwanym tak jak on:
aggrega scaffold --example nginx-gatewayNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd nginx-gatewayKompilacja
Ta przestrzeń robocza nie zawiera pliku .aggrega-config.yaml, więc encje biblioteki standardowej są rozwiązywane z rejestru hub, hub.aggrega.ai, i flaga katalogu nie jest potrzebna; --auto-pull zapisuje w trakcie kompilacji plik blokady, którego brakuje w świeżym klonie:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)aggrega build --release release-helm-synth.yaml --auto-pullWyrenderowane artefakty trafiają do dist/. Cel Kubernetes renderuje zwykłe
manifesty offline — pobieranie chartu nie jest wymagane.
Z asystentem AI
Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.
Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder Workspace nie zawiera jeszcze folderu `nginx-gateway`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `nginx-gateway` i bez `dir`: zapisuje ono przykład w nowym folderze `nginx-gateway`. Następnie wywołaj narzędzie `build` raz dla każdej encji Release, w tej kolejności — `release-compose.yaml` i `release-helm-synth.yaml` — za każdym razem z `workspace_root` ustawionym na `nginx-gateway`, `release` ustawionym na ten plik, `auto_pull` ustawionym na true i `write` ustawionym na true. Powiedz mi, jakie pliki zapisała każda kompilacja; znajdują się w `nginx-gateway/dist/`.Jak wygląda wstrzyknięty upstream
W Compose usługa bramy uruchamia NGINX z blokiem server wskazującym na nazwę usługi compose i port backendu:
server { listen 8000; location / { proxy_pass http://web:8080; } }W Kubernetes ten sam routing trafia do polecenia kontenera, które zapisuje
konfigurację serwera przed uruchomieniem nginx, wskazując na obiekt Service backendu —
dostawca helm nadaje mu nazwę od backendu i jego klucza usługi default:
server { listen 8080; location / { proxy_pass http://web-default:8080; } }Oba rozwiązują się z tej samej krawędzi encji Aggregate — host i port backendu przechodzą
przez użycie upstream, a każdy cel renderuje je we własnym idiomie.
Uruchomienie (Compose)
aggrega build --release release-compose.yaml --auto-pulldocker compose -f dist/app/compose/docker-compose.yaml up -dNależy otworzyć http://localhost:8000 — NGINX przekazuje żądanie do backendu. Zatrzymanie i usunięcie: docker compose -f dist/app/compose/docker-compose.yaml down.