İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

DosyaRol
aggregate.yamlDeveloper niyeti: API ağ geçidi modülünü (core/kong) içe aktarır.
manifest-helm-synth.yamlAğ geçidi ve arka uç türlerini sentez helm Recipes’lerine eşler.
release-helm-synth.yamlKubernetes 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 provides ile 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 proxy olarak 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:

Terminal window
aggrega scaffold --example kong-stack

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd kong-stack

Derleme

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:

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

Ağ 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.