Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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

PlikRola
aggregate.yamlIntencja programisty: backend web (core/devtool/adminer) i brama proxy (core/gateway/nginx), która deklaruje użycie upstream backendu.
manifest-compose.yamlMapuje typ bramy na encję Recipe dla Compose (compose/nginx), a backend na encję Recipe Adminer dla Compose.
manifest-helm-synth.yamlMapuje typ bramy na syntetyczną encję Recipe helm (helm/nginx), a backend na offline’ową encję Recipe Adminer helm.
release-compose.yaml / release-helm-synth.yamlRekordy 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 upstream backendu; wartości provides.host i provides.port encji Recipe backendu są przekazywane do bramy i renderowane jako jej cel proxy_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_pass przekazuje 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:

Terminal window
aggrega scaffold --example nginx-gateway

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd nginx-gateway

Kompilacja

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:

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

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

Terminal window
aggrega build --release release-compose.yaml --auto-pull
docker compose -f dist/app/compose/docker-compose.yaml up -d

Należy otworzyć http://localhost:8000 — NGINX przekazuje żądanie do backendu. Zatrzymanie i usunięcie: docker compose -f dist/app/compose/docker-compose.yaml down.