Kong yığını — modül olarak oluşturulmuş, veritabanı destekli bir API ağ geçidi
Bu örnek, küçük ama gerçek bir yığını — veritabanı destekli bir API ağ geçidini —
Developer tarafından yazılmış tek bir Aggregate’ten sentezlenmiş Kubernetes manifestlerine derler.
Ağ geçidi tek bir bileşen değildir. Bir modüldür: iki tek iş yüklü bileşeni bir araya getiren, yeniden kullanılabilir bir alt aggregate —
- istemci trafiğini proxy portunda sonlandıran ve yerel durum tutmayan bir ağ geçidi ve
- ağ geçidinin yapılandırmasını tutan ve onu bir birimde kalıcı olarak saklayan bir arka uç, PostgreSQL.
Modül, ağ geçidinden arka uca giden kendi iç kenarını bağlar ve
ağ geçidini proxy genel uç noktası olarak dışa aktarır. Üst düzey Aggregate
modülü adıyla içe aktarır ve oluşturulan yığını render eder; operatör,
modülün iç bileşenlerini Release’te boyutlandırır.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer niyeti: API ağ geçidi modülünü (core/kong) içe aktarır. |
manifest-helm-synth.yaml | Ağ geçidi ve arka uç türlerini sentez helm Recipes’lerine eşler. |
release-helm-synth.yaml | Kubernetes hedefi için operatör kaydı. Modülün iç bileşenlerini modül kapsamlı kimlikleriyle boyutlandırır; şema varsayılanlarına bırakılan her şey kendi kendine yeterli olarak render edilir. |
Neyi gösteriyor
- Modül olarak bileşim. Çok iş yüklü bir yetenek — aslında bir proxy ile bir yapılandırma veritabanından oluşan bir API ağ geçidi — tek parça bir bileşen olarak değil, iki tek iş yüklü bileşeni bir araya getiren bir alt aggregate olarak paketlenir. Modül adıyla içe aktarılır ve bir ağ geçidine ihtiyaç duyulan her yerde yeniden kullanılır.
- Modül içinde bir iç kenar. Ağ geçidi, arka ucu kullandığını bildirir;
arka uç Recipe’inin
providesile sağladığı host, port, kullanıcı ve veritabanı ağ geçidine aktarılır ve onun PostgreSQL bağlantısında birleştirilir. Derleyici bu dizeleri yorumlamadan yönlendirir. - Genel bir uç nokta. Modül, ağ geçidini
proxyolarak dışa aktarır; bu, bir tüketicinin bağlandığı kararlı genel addır — modülün iç bileşen adlarından bağımsızdır. - İç bileşenlerin operatör tarafından boyutlandırılması. Release, işlem kaynaklarını
ayarlamak için modülün iç bileşenlerini modül kapsamlı kimlikleriyle (
gateway.backend,gateway.gateway) adresler; geliştiricinin Aggregate’inin fiziksel boyutlandırmayı yeniden belirtmesi gerekmez. - Hizmet vermeden önce çalışan bir migrasyon adımı. Ağ geçidi, veritabanı şemasını ana ağ geçidi konteyneri başlamadan önce tamamlanana kadar çalışan bir init konteyneri aracılığıyla hazırlar; böylece ağ geçidi hazır bir şema üzerinde hizmet verir. Önyükleme idempotenttir; bu nedenle zaten hazırlanmış bir veritabanına karşı yeniden çalıştırmanın hiçbir etkisi olmaz.
- Paylaşılan bir kimlik bilgisi. Ağ geçidi PostgreSQL arka ucuna kimlik doğrular, bu yüzden ikisi tek bir parolayı paylaşır. Bu örnek, paylaşılan satır içi bir geliştirme varsayılanı kullanır; böylece yığın harici bir gizli bilgi olmadan kendi kendine yeterli çalışır.
- Yeniden üretilebilir imajlar. Hem ağ geçidi hem de arka uç açık imaj etiketlerini sabitler; böylece render edilen manifestler kararlı imajlara 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 kong-stackArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd kong-stackDerleme
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:
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 klasör oluşturmayın. Çalışma alanı klasöründe henüz `kong-stack` klasörü yoksa `scaffold` aracını `example` değeri `kong-stack` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `kong-stack` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `kong-stack`, `release` değeri `release-helm-synth.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `kong-stack/dist/` altındadır.Oluşturulan yığın nasıl görünür
Ağ geçidi; durumsuz bir Deployment, proxy portunda bir ClusterIP Service ve Status API’sinin istek izin listesini taşıyan bir ConfigMap olarak render edilir. Pod’u, ana konteynerden önce çalışan bir migrasyon init konteyneri taşır; her ikisi de arka uç kenarından oluşturulan bağlantıyı — arka ucun küme içi Service adı, kullanıcısı ve veritabanı — taşır:
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: apppassAğ geçidinin hazırlık ve canlılık yoklamaları Kong’un Status API’sini —
GET /status/ready ve GET /status — status konteyner portunda sorgular; bu nedenle
bu dinleyici Pod’un adresine bağlanır. Kong, ConfigMap’teki izin listesini
Status API’sinin kendi sunucu bloğuna ekler: Pod’un geri döngü adresi dışındaki
herhangi bir adresten /status, /status/ready veya /metrics için bir GET isteğini yanıtlar ve
diğer her isteği 403 ile reddeder — bunlar arasında, aksi halde ağ geçidini boşaltılıyor
olarak işaretleyip yeniden başlayana kadar Service’inden çıkaracak olan POST /status/ready de vardır.
Arka uç, /var/lib/postgresql/data konumuna bağlanmış kalıcı bir birime sahip bir StatefulSet ile
bir ClusterIP Service ve bir headless Service olarak render edilir.