Gateway NGINX — perutean reverse-proxy ke upstream, dua target
Contoh ini mengompilasi sebuah stack kecil yang nyata — sebuah gateway reverse-proxy NGINX yang berada di depan sebuah backend web — dari satu Aggregate yang ditulis oleh Developer ke dua target:
- Docker Compose untuk pengembangan lokal, dan
- manifest Kubernetes hasil sintesis untuk sebuah klaster.
aggregate.yaml yang sama menggerakkan keduanya. Hanya lapisan Recipe yang dipilih oleh
Manifest yang berubah per target.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intensi Developer: sebuah backend web (core/devtool/adminer) dan sebuah gateway proxy (core/gateway/nginx) yang mendeklarasikan penggunaan upstream atas backend tersebut. |
manifest-compose.yaml | Memetakan tipe gateway ke Recipe Compose (compose/nginx) dan backend ke Recipe Adminer Compose. |
manifest-helm-synth.yaml | Memetakan tipe gateway ke Recipe helm sintesis (helm/nginx) dan backend ke Recipe helm Adminer offline. |
release-compose.yaml / release-helm-synth.yaml | Catatan Operator untuk kedua target. |
Apa yang didemonstrasikan
- Satu permukaan penulisan, banyak target. Satu Aggregate menjadi sumber kebenaran tentang apa stack tersebut. Setiap Manifest menyatakan bagaimana merealisasikannya.
- Perutean upstream melalui String Pipe. Gateway mendeklarasikan
penggunaan
upstreamatas backend;provides.hostdanprovides.portdari Recipe backend dialirkan ke gateway dan dirender ke dalam targetproxy_pass-nya. Compiler merutekan string tersebut tanpa menafsirkannya — sehingga build Compose menghubungkan nama layanan compose dan build Kubernetes menghubungkan nama Service, dari edge yang sama. - Konfigurasi yang idiomatis bagi Provider. Pada kedua target, gateway menulis
blok server NGINX minimal saat container dimulai, yang
proxy_pass-nya meneruskan ke upstream yang diinjeksikan, lalu menjalankan nginx di foreground. Target Kubernetes mewujudkannya sebagai Deployment stateless ditambah Service ClusterIP, tanpa chart Helm eksternal. - Image yang dapat direproduksi. Target Kubernetes menjalankan image nginx upstream resmi yang dipatok ke tag eksplisit, sehingga Deployment yang dirender merujuk ke image yang stabil.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example nginx-gatewayKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd nginx-gatewayBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)aggrega build --release release-helm-synth.yaml --auto-pullArtefak yang dirender ditempatkan di bawah dist/. Target Kubernetes merender manifest
biasa secara offline — tidak diperlukan penarikan chart.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder Workspace belum berisi folder `nginx-gateway`, panggil alat `scaffold` sekali dengan `example` diatur ke `nginx-gateway` dan tanpa `dir`: alat ini menulis contoh ke folder `nginx-gateway` yang baru. Kemudian panggil alat `build` sekali untuk setiap Release, dengan urutan ini — `release-compose.yaml` dan `release-helm-synth.yaml` — setiap kali dengan `workspace_root` diatur ke `nginx-gateway`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file apa saja yang ditulis setiap build; file-file itu ada di bawah `nginx-gateway/dist/`.Seperti apa upstream yang diinjeksikan
Pada Compose, layanan gateway menjalankan NGINX dengan blok server yang menunjuk ke nama layanan compose dan port milik backend:
server { listen 8000; location / { proxy_pass http://web:8080; } }Pada Kubernetes, perutean yang sama muncul dalam perintah container yang menulis
konfigurasi server sebelum menjalankan nginx, dengan menunjuk ke Service milik backend —
provider helm menamainya berdasarkan backend dan kunci layanan default-nya:
server { listen 8080; location / { proxy_pass http://web-default:8080; } }Keduanya diresolusi dari edge Aggregate yang sama — host dan port backend mengalir
melalui penggunaan upstream, dan setiap target merendernya dengan idiomnya sendiri.
Menjalankannya (Compose)
aggrega build --release release-compose.yaml --auto-pulldocker compose -f dist/app/compose/docker-compose.yaml up -dBuka http://localhost:8000 — NGINX meneruskan permintaan ke backend. Hentikan dengan docker compose -f dist/app/compose/docker-compose.yaml down.