Modül sınırı yönlendirme — alt modüllerin tamamını sınırlara yerleştirme
Bu örnek, iki yeteneği — nesne depolama üzerinde bir Thanos metrik okuma katmanı ve
MongoDB kablo protokolünü konuşan bir belge veritabanı — Developer tarafından yazılmış
tek bir Aggregate’ten derler ve her birini Release’ten kendine ait bir sınıra yerleştirir.
Her iki yetenek de modüldür: her biri birden çok tek iş yüklü bileşeni bir araya getiren
ve kendi iç bağlantılarını kuran yeniden kullanılabilir alt aggregate’lerdir. Aggregate iki
modülü adlandırır ve nerede çalıştıklarına dair hiçbir şey söylemez. Release, her modülü
sınır başına bir aggregates: girdisiyle bütün olarak yerleştirir — operatör, bir yeteneğin
nerede çalışacağına içinde ne olduğunu izlemeden ya da yeniden belirtmeden karar verir.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer niyeti: metrik modülünü (core/thanos) ve belge veritabanı modülünü (core/ferretdb) içe aktarır. |
manifest.yaml | İki modülün katkıda bulunduğu her bileşen türünü synth helm Recipe’ine, metrik modülünün eklediği kimlik bilgisi Feature’ını modülün iki anahtar parametresinin her birinden bir Secret üreten gerçekleştirmeye ve scrape Feature’ını FeatureRecipe’ine eşler. |
release.yaml | Operatör kaydı: her modülü kendi sınırına yönlendirir, bir modülün bir bileşenini boyutlandırır ve scrape Feature’ını ona ekler. |
Neyi gösteriyor
- Bir modülün tamamını bir sınıra yönlendirme. Bir sınırın
aggregates:girdisi, modülün Aggregate içindeki adıyla anahtarlanır. Modülün içerdiği her bileşeni yerleştirir; böylece üç metrik bileşeninin tamamı için üretilen yapıtlarobservabilitysınırı altına, iki belge veritabanı bileşeni isedataaltına yerleşir. - Hiçbir bileşeni adlandırmamak birincil biçimdir.
datasınırı, belge veritabanı modülünü yalın birdocuments: {}ile yönlendirir. İçindeki her bileşen yerleştirilir ve kendi şema varsayılanlarını alır; Release’in modül hakkında yalnızca adına ihtiyacı vardır. - Yönlendirilen bir bileşeni yerel adıyla yapılandırma. Bir yönlendirme girdisi,
yönlendirdiği modülün tek tek bileşenlerini de yapılandırabilir; bunlara her birinin
o modül içinde taşıdığı yerel adla başvurulur —
metrics.querydeğilquery, çünkü modülün içinde sahip olduğu tek ad budur. Bir bileşeni adlandırmak diğerleri hakkında hiçbir şey söylemez: buradaqueryboyutlandırılır ve bir scrape hedefi verilirken nesne deposu ve depo ağ geçidi varsayılanlarıyla yönlendirilir. - Yönlendirilen bir bileşen o sınırın bir bileşenidir. Diğer her bileşen gibi
sınırın ek açıklama kademesini devralır; yönlendirilen bir modülün her kaynağına —
yönlendirme girdisinin hiç anmadığı bileşenler dahil — sınırın
aggrega.ai/namespacedeğerini veren de budur. - Yönlendirme, farklı bir üyelik türü değil, yerleştirmedir. Hakkında hiçbir şey söylenmeden yönlendirilen bir bileşen, o sınırda boş bir gövdeyle doğrudan adlandırılan aynı bileşenle aynı şekilde işlenir. İki yazım, bir bileşenin nereye ait olduğunu söylemenin iki yoludur, iki ayrı davranış değil.
Ö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 module-boundary-routingArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd module-boundary-routingDerleme
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.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 `module-boundary-routing` klasörü yoksa `scaffold` aracını `example` değeri `module-boundary-routing` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `module-boundary-routing` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `module-boundary-routing`, `release` değeri `release.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 `module-boundary-routing/dist/` altındadır.Yerleştirilen yığınlar nasıl görünür
Her sınırın directory değeri, içine yerleştirilen her şeyin yapıt köküdür; bu nedenle
iki modülün bileşenleri diskte onları yönlendiren sınıra göre ayrılır:
dist/observability/helm/ metrics-zdobjstore, metrics-zdstore, metrics-zdquerydist/data/helm/ documents-zdproxy, documents-zdbackendDosya adları, her bileşenin kimliğini modül ayırıcısı açıkça yazılmış olarak taşır,
çünkü nokta her kaynak adının içerebileceği bir karakter değildir — Aggregate’teki
metrics.store, kümede metrics-zdstore olur. Bir kimliğe ayırıcı koyan tek şey bir
modülü bir araya getirmektir; bu nedenle doğrudan adlandırdığınız bir bileşen her iki
yerde de aynı yazılır.
Her kaynak, yönlendiren sınırın ad alanını taşır ve onu hangi sınırın yerleştirdiğini kaydeder. Depo ağ geçidi yönlendirme girdisinde hiç adlandırılmaz, yine de her ikisini de devralır:
metadata: name: metrics-zdstore namespace: observability [… omitted: the labels every rendered document carries] annotations: aggrega.ai/boundary-path: observability [… omitted: the annotation naming the Recipe that rendered it]Aynısı, metrik modülünün kimlik bilgisi Feature’ının nesne deposunun anahtar çifti ve depo ağ geçidinin ona sunduğu anahtar çifti için ürettiği dört Secret için de geçerlidir: her biri o ad alanıyla, onu okuyan iş yükünün yanında observability altına yerleşir.
Yönlendirilen query bileşenine eklenen scrape Feature’ı, operatörün scrape ayarlarını
taşıyan kendi yapıtını aynı sınırın altında işler:
apiVersion: monitoring.coreos.com/v1kind: ServiceMonitormetadata: name: metrics-zdquery-scrape [… omitted: the namespace, labels and annotations every rendered document carries]spec: selector: matchLabels: app.kubernetes.io/name: metrics-zdquery endpoints: - port: http interval: 30s path: /metrics