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
| Dosya | Rol |
|---|---|
aggregate.yaml | Geliştirici amacı: belge veritabanı modülünü (core/ferretdb) içe aktarır. |
manifest-helm-synth.yaml | Proxy 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 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
provideshost, 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
mongoolarak 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
PGPASSWORDortam 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:
aggrega scaffold --example ferretdb-stackArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd ferretdb-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 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: apppassYoklamaları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: 27017readinessProbe: exec: command: - /ferretdb - pingArka 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.