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

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

BerkasPeran
aggregate.yamlIntent Developer: mengimpor modul API gateway (core/kong).
manifest-helm-synth.yamlMemetakan tipe gateway dan backend ke Recipes synth helm masing-masing.
release-helm-synth.yamlCatatan 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 provides milik 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:

Terminal window
aggrega scaffold --example kong-stack

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

Terminal window
cd kong-stack

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
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 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: apppass

Probe 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.