NGINX ağ geçidi — bir upstream'e ters proxy yönlendirmesi, iki hedef
Bu örnek, küçük ama gerçek bir yığını — bir web arka ucunun önünde duran bir NGINX ters proxy ağ geçidini — Developer tarafından yazılmış tek bir Aggregate’ten iki hedefe derler:
- yerel geliştirme için Docker Compose ve
- bir küme için sentezlenmiş Kubernetes manifestleri.
İkisini de aynı aggregate.yaml yönlendirir. Hedefe göre yalnızca
Manifest’in seçtiği Recipe katmanı değişir.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer niyeti: bir web arka ucu (core/devtool/adminer) ve arka ucun upstream kullanımını bildiren bir proxy ağ geçidi (core/gateway/nginx). |
manifest-compose.yaml | Ağ geçidi türünü Compose Recipe’ine (compose/nginx), arka ucu ise Compose Adminer Recipe’ine eşler. |
manifest-helm-synth.yaml | Ağ geçidi türünü sentez helm Recipe’ine (helm/nginx), arka ucu ise çevrimdışı Adminer helm Recipe’ine eşler. |
release-compose.yaml / release-helm-synth.yaml | İki hedef için operatör kayıtları. |
Neyi gösteriyor
- Tek yazım yüzeyi, birçok hedef. Tek bir Aggregate, yığının ne olduğu konusunda doğruluğun kaynağıdır. Her Manifest onun nasıl gerçekleştirileceğini söyler.
- String Pipe üzerinden upstream yönlendirmesi. Ağ geçidi arka ucun
upstreamkullanımını bildirir; arka uç Recipe’ininprovides.hostveprovides.portdeğerleri ağ geçidine aktarılır ve onunproxy_passhedefine işlenir. Derleyici dizeleri yorumlamadan yönlendirir — böylece aynı kenardan Compose derlemesi bir compose servis adını, Kubernetes derlemesi ise bir Service adını bağlar. - Provider’a özgü yapılandırma. Her iki hedefte de ağ geçidi, konteyner başlarken
proxy_pass’i enjekte edilen upstream’e yönlendiren minimal bir NGINX server bloğu yazar, ardından nginx’i ön planda başlatır. Kubernetes hedefi bunu, harici bir Helm chart olmadan, durumsuz bir Deployment ve bir ClusterIP Service olarak gerçekleştirir. - Yeniden üretilebilir imajlar. Kubernetes hedefi, açık bir etikete sabitlenmiş resmi upstream nginx imajını çalıştırır; böylece işlenen Deployment kararlı bir imaja başvurur.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example nginx-gatewayArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd nginx-gatewayDerleme
Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur; --auto-pull, yeni bir klonda eksik olan kilit dosyasını derleme sırasında yazar:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)aggrega build --release release-helm-synth.yaml --auto-pullİşlenen yapıtlar dist/ altına yerleşir. Kubernetes hedefi düz manifestleri
çevrimdışı işler — chart çekmek gerekmez.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Workspace klasöründe henüz `nginx-gateway` klasörü yoksa, `scaffold` aracını `example` değeri `nginx-gateway` olacak şekilde ve `dir` olmadan bir kez çağırın: örneği yeni bir `nginx-gateway` klasörüne yazar. Ardından `build` aracını her Release için birer kez, şu sırayla çağırın — `release-compose.yaml` ve `release-helm-synth.yaml` — her seferinde `workspace_root` değeri `nginx-gateway`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde. Her derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `nginx-gateway/dist/` altındadır.Enjekte edilen upstream nasıl görünür
Compose’da ağ geçidi servisi, NGINX’i arka ucun compose servis adını ve portunu gösteren bir server bloğuyla çalıştırır:
server { listen 8000; location / { proxy_pass http://web:8080; } }Kubernetes’te aynı yönlendirme, nginx’i başlatmadan önce server yapılandırmasını
yazan konteyner komutunda gelir ve arka ucun Service’ini gösterir —
helm provider onu arka ucun ve onun default servis anahtarının adıyla adlandırır:
server { listen 8080; location / { proxy_pass http://web-default:8080; } }Her ikisi de aynı Aggregate kenarından çözümlenir — arka uç ana makinesi ve portu
upstream kullanımı üzerinden taşınır ve her hedef bunları kendi deyimiyle işler.
Çalıştırın (Compose)
aggrega build --release release-compose.yaml --auto-pulldocker compose -f dist/app/compose/docker-compose.yaml up -dhttp://localhost:8000 adresini açın — NGINX isteği arka uca iletir. Kaldırmak için: docker compose -f dist/app/compose/docker-compose.yaml down.