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

FerretDB yığını — modül olarak oluşturulmuş bir belge veritabanı

Bu örnek, küçük ama gerçek bir yığını — MongoDB kablo protokolünü sunan bir belge veritabanını — geliştiricinin yazdığı tek bir Aggregate’ten sentezlenmiş Kubernetes manifestlerine derler.

Belge veritabanı 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 —

  • MongoDB kablo protokolünü konuşan ve yerel durum tutmayan bir proxy ve
  • veriyi bir birimde kalıcı olarak saklayan, DocumentDB uzantılı PostgreSQL 17 olan bir arka uç.

Modül, proxy’den arka uca giden kendi iç kenarını bağlar ve proxy’yi genel uç noktası mongo 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.yamlGeliştirici amacı: belge veritabanı modülünü (core/ferretdb) içe aktarır.
manifest-helm-synth.yamlProxy 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 depolama arka ucundan oluşan bir belge veritabanı — 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 belge veritabanı gereken her yerde yeniden kullanılır.
  • Modül içinde bir iç kenar. Proxy, arka ucu kullandığını bildirir; arka uç Recipe’inin provides host, port, kullanıcı ve veritabanı değerleri proxy’ye aktarılır ve PostgreSQL bağlantısında birleştirilir. Derleyici bu dizeleri yorumlamadan yönlendirir.
  • Genel bir uç nokta. Modül, proxy’sini mongo olarak dışa aktarır; bu, bir belge veritabanı tüketicisinin bağlandığı, modülün iç bileşen adlarından ayrıştırılmış kararlı genel addır.
  • İç bileşenlerin operatör tarafından boyutlandırılması. Release, işlem gücünü ayarlamak için modülün iç bileşenlerine modül kapsamlı kimlikleriyle (database.backend, database.proxy) başvurur; geliştiricinin Aggregate’inin fiziksel boyutlandırmayı yeniden belirtmesi gerekmez.
  • Paylaşılan bir kimlik bilgisi. Proxy, kimlik doğrulamayı PostgreSQL arka ucuna devreder; 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 sır olmadan kendi kendine yeterli çalışır.
  • Parola içermeyen bir bağlantı dizesi. Proxy’nin PostgreSQL bağlantı URL’si parola gömülmeden render edilir; parola ayrıca standart libpq PGPASSWORD ortam değişkeniyle sağlanır ve sürücü bunu bağlantıyla birleştirir. Bu, kimlik bilgisini render edilen manifestteki bağlantı dizesinin dışında tutar.
  • Yeniden üretilebilir imajlar. Hem proxy hem 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 ferretdb-stack

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

Terminal window
cd ferretdb-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 bir `ferretdb-stack` klasörü yoksa `scaffold` aracını `example` değeri `ferretdb-stack` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `ferretdb-stack` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `ferretdb-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 `ferretdb-stack/dist/` altındadır.

Oluşturulan yığın nasıl görünür

Proxy, durumsuz bir Deployment ile kablo portunda bir ClusterIP Service olarak render edilir. Kapsayıcı ortamı, arka uç kenarından oluşturulan bağlantıyı — arka ucun küme içi Service adı, kullanıcısı ve veritabanı, URL’de parola olmadan — taşır ve FerretDB’nin hata ayıklama dinleyicisini, başka hiçbir pod’un erişemediği pod’un geri döngü adresinde tutar:

env:
- name: FERRETDB_LISTEN_ADDR
value: :27017
- name: FERRETDB_DEBUG_ADDR
value: 127.0.0.1:8088
- name: FERRETDB_POSTGRESQL_URL
value: postgres://postgres@database-zdbackend-default:5432/postgres
- name: PGPASSWORD
value: apppass

Yoklamaların hiçbiri bu dinleyiciye ihtiyaç duymaz. Hazırlık yoklaması kapsayıcı içinde ferretdb ping çalıştırır; bu, kablo portuna ping atar ve böylece arka uç bağlantısını da doğrular; canlılık yoklaması yalnızca kablo portunun bağlantı kabul ettiğini denetler; böylece bir arka uç kesintisi proxy’yi yeniden başlatmadan Service’inden çıkarır:

livenessProbe:
tcpSocket:
port: 27017
readinessProbe:
exec:
command:
- /ferretdb
- ping

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.