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

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

DosyaRol
aggregate.yamlDeveloper 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.yamlOperatö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ıtlar observability sınırı altına, iki belge veritabanı bileşeni ise data altına yerleşir.
  • Hiçbir bileşeni adlandırmamak birincil biçimdir. data sınırı, belge veritabanı modülünü yalın bir documents: {} 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.query değil query, çü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: burada query boyutlandı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/namespace değ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:

Terminal window
aggrega scaffold --example module-boundary-routing

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

Terminal window
cd module-boundary-routing

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.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-zdquery
dist/data/helm/ documents-zdproxy, documents-zdbackend

Dosya 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/v1
kind: ServiceMonitor
metadata:
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