Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

BerkasPeran
aggregate.yamlIntensi Developer: sebuah backend web (core/devtool/adminer) dan sebuah gateway proxy (core/gateway/nginx) yang mendeklarasikan penggunaan upstream atas backend tersebut.
manifest-compose.yamlMemetakan tipe gateway ke Recipe Compose (compose/nginx) dan backend ke Recipe Adminer Compose.
manifest-helm-synth.yamlMemetakan tipe gateway ke Recipe helm sintesis (helm/nginx) dan backend ke Recipe helm Adminer offline.
release-compose.yaml / release-helm-synth.yamlCatatan 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 upstream atas backend; provides.host dan provides.port dari Recipe backend dialirkan ke gateway dan dirender ke dalam target proxy_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:

Terminal window
aggrega scaffold --example nginx-gateway

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd nginx-gateway

Build

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:

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

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

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

Buka http://localhost:8000 — NGINX meneruskan permintaan ke backend. Hentikan dengan docker compose -f dist/app/compose/docker-compose.yaml down.