Kong stack — API gateway berbasis basis data yang disusun sebagai modul
Contoh ini mengompilasi sebuah stack kecil yang nyata — sebuah API gateway berbasis basis data —
menjadi manifest Kubernetes hasil sintesis dari satu Aggregate yang ditulis oleh Developer.
Gateway ini bukan satu komponen tunggal. Ia adalah sebuah modul: sub-aggregate yang dapat digunakan ulang dan menyusun dua komponen dengan satu workload —
- sebuah gateway yang mengakhiri lalu lintas klien pada port proxy-nya dan tidak menyimpan state lokal, dan
- sebuah backend, PostgreSQL, yang menyimpan konfigurasi gateway dan mempertahankannya pada sebuah volume.
Modul menghubungkan edge internalnya sendiri dari gateway ke backend dan
mengekspor gateway sebagai endpoint publiknya proxy. Aggregate tingkat atas
mengimpor modul berdasarkan nama dan merender stack yang tersusun; operator menentukan ukuran
komponen internal modul di dalam Release.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intent Developer: mengimpor modul API gateway (core/kong). |
manifest-helm-synth.yaml | Memetakan tipe gateway dan backend ke Recipes synth helm masing-masing. |
release-helm-synth.yaml | Catatan operator untuk target Kubernetes. Menentukan ukuran komponen internal modul berdasarkan ID yang dicakup modul; apa pun yang diserahkan ke default skema dirender secara mandiri. |
Apa yang didemonstrasikan
- Komposisi sebagai modul. Sebuah kapabilitas multi-workload — API gateway yang sebenarnya adalah proxy ditambah basis data konfigurasi — dikemas sebagai sub-aggregate yang menyusun dua komponen single-workload, bukan sebagai satu komponen monolitik. Modul diimpor berdasarkan nama dan digunakan kembali di mana pun gateway dibutuhkan.
- Edge internal di dalam modul. Gateway mendeklarasikan penggunaan
backend; host, port, user, dan database dari
providesmilik Recipe backend dialirkan ke gateway dan disusun menjadi koneksi PostgreSQL-nya. Compiler merutekan string tersebut tanpa menafsirkannya. - Endpoint publik. Modul mengekspor gateway-nya sebagai
proxy, nama publik yang stabil tempat konsumen terhubung — terpisah dari nama komponen internal modul. - Penentuan ukuran komponen internal oleh operator. Release menunjuk komponen
internal modul berdasarkan ID lingkup modulnya (
gateway.backend,gateway.gateway) untuk mengatur compute, tanpa Aggregate milik developer menyatakan ulang ukuran fisik. - Langkah migrasi yang berjalan sebelum melayani. Gateway menyiapkan skema basis datanya melalui init container yang berjalan hingga selesai sebelum container gateway utama dimulai, sehingga gateway melayani dengan skema yang sudah siap. Bootstrap bersifat idempoten, sehingga menjalankannya ulang terhadap basis data yang sudah disiapkan tidak berpengaruh apa pun.
- Kredensial bersama. Gateway mengautentikasi ke backend PostgreSQL-nya, sehingga keduanya berbagi satu kata sandi. Contoh ini menggunakan nilai default pengembangan inline bersama, sehingga stack berjalan mandiri tanpa secret eksternal.
- Image yang dapat direproduksi. Gateway dan backend sama-sama mematok tag image eksplisit, sehingga manifest 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 kong-stackKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd kong-stackBuild
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:
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 ruang kerja belum berisi folder `kong-stack`, panggil alat `scaffold` sekali dengan `example` diatur ke `kong-stack` dan tanpa `dir`: alat ini menulis contoh ke folder `kong-stack` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `kong-stack`, `release` diatur ke `release-helm-synth.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `kong-stack/dist/`.Seperti apa stack yang tersusun
Gateway dirender sebagai Deployment stateless ditambah Service ClusterIP pada port proxy dan ConfigMap yang memuat allowlist permintaan Status API-nya. Pod-nya memuat init container migrasi yang berjalan sebelum container utama; keduanya memuat koneksi yang disusun dari edge backend — nama Service backend di dalam cluster, user, dan database:
env: - name: KONG_DATABASE value: postgres - name: KONG_PG_HOST value: gateway-zdbackend-default - name: KONG_PG_PORT value: "5432" - name: KONG_PG_USER value: kong - name: KONG_PG_DATABASE value: kong [… omitted: the gateway's own proxy, admin and status listen addresses, and the allowlist file its Status API includes] - name: KONG_PG_PASSWORD value: apppassProbe readiness dan liveness gateway menanyai Status API Kong —
GET /status/ready dan GET /status — pada port container status, sehingga
listener tersebut terikat pada alamat Pod. Kong menyertakan allowlist dari
ConfigMap di dalam blok server milik Status API: dari alamat mana pun selain alamat
loopback Pod, ia menjawab GET atas /status, /status/ready atau /metrics, dan
menolak setiap permintaan lain dengan 403 — di antaranya POST /status/ready, yang
jika tidak ditolak akan menandai gateway sebagai draining dan mengeluarkannya dari Service-nya hingga
ia dimulai ulang.
Backend dirender sebagai StatefulSet dengan volume persisten yang di-mount pada
/var/lib/postgresql/data, ditambah Service ClusterIP dan Service headless.