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

Bileşim

Bu sayfa tek bir fikri, bir uygulamayı tek bir bileşenden daha büyük parçalardan oluşturmayı açıklar ve çalıştırılabilir bir çalışma alanı değildir. Modül sınır yönlendirmesi — tüm alt modülleri sınırlara yerleştirme bunu sizin derlediğiniz bir çalışma alanında gösterir; şu komutla kendi klasörünüze yazın:

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

Ardından sırada çalıştırılacak komutları yazdırır:

Terminal window
cd module-boundary-routing
aggrega build --release release.yaml --auto-pull

Modüller: başka bir Aggregate tarafından içe aktarılan bir Aggregate

Bir Aggregate, başka bir Aggregate’i aggregates: altında modül olarak içe aktarabilir. Modül kendi bileşenlerini oluşturur ve kendi kenarlarını bağlar, bu nedenle iç yapısının hiçbir parçası onu içe aktaran Aggregate’te görünmez. Örnek, standart kitaplık kataloğundan iki modül içe aktarır; aggregate.yaml dosyasından:

spec:
aggregates:
metrics:
type: core/thanos
documents:
type: core/ferretdb

Bir modülün exportedComponents bloğu onun genel arabirimidir: modülün dışındaki bir şeyin bağlanabileceği bileşenler, her biri dışa aktarıldığı adla. core/ferretdb, proxy bileşenini mongo olarak dışa aktarır; bu nedenle içe aktaran Aggregate’in bir bileşeni ona noktalı yol documents.mongo ile ulaşır:

uses:
database:
main:
target: documents.mongo

Bir modül kendi parametrelerini bildirebilir; içe aktaran Aggregate bunları içe aktarımın parameters: alanında karşılar.

Bir modülü yerleştirme

Release, modülün adıyla anahtarlanmış bir aggregates: girdisiyle bütün bir modülü bir sınıra yerleştirir ve modülün içerdiği her bileşen onunla birlikte gider. Ayrıca modülün bileşenlerini, her birini modülün içinde sahip olduğu adla yapılandırabilir. release.yaml dosyasından, yorumlar çıkarılmış olarak:

spec:
boundaries:
observability:
directory: observability
annotations:
aggrega.ai/namespace: observability
aggregates:
metrics:
components:
query:
infra:
compute:
cpu: 500m
memory: 1Gi
data:
directory: data
annotations:
aggrega.ai/namespace: data
aggregates:
documents: {}

Bir modülün kendi ek açıklamaları, bir Aggregate’in ek açıklamalarının kendi bileşenlerine ulaştığı biçimde, modülün kendi bileşenlerine tam olarak aynı şekilde ulaşır; bu nedenle bir modül, bileşenlerini bildirdiği bir ad alanına yerleştirebilir. İçe aktaran Aggregate, modülün içine uzanan hiçbir şey bildirmez; bunu Release yapar ve aynı anahtarda onun değeri geçerli olur.

Derlemenin sağlamadığı bir hizmet

Zaten var olan bir sunucu yine de grafın bir düğümüdür: bağlantılarda, politikada ve tüketicilerinin aldığı şeylerde yer alır ve onun için hiçbir şey sağlanmaz. Manifest’i hiçbir şey sağlamayan bir Recipe’yi bağlar ve adresi Release verir. Tek sözleşme, üç gerçekleştirme örneğinde manifest-external.yaml Manifest’i, core/datastore/postgres öğesini yalnızca bir ExternalName Service üreten helm/postgres-external öğesine bağlar ve adresi Release sağlar; release-external.yaml dosyasından:

db:
infra:
overrides:
host: postgres.data.example.net

Adres bir işaretçi dizesidir: derleme onu çözümlemeden geçirir ve uygulama çalışırken o adda yanıt veren şey neyse uygulamanın ulaştığı şey odur. Aggregate, bu örnekteki üç Releases’in tümü için aynı dosyadır.

Alt sistemler: tek bir Aggregate içinde gruplama

Bir alt sistem, bir Aggregate içindeki bileşenleri gruplar. Üzerinde bildirilen ek açıklamalar içerdiği her bileşene ulaşır ve ona iliştirilen bir Feature, bileşenlerin her birine iliştirilir:

spec:
subsystems:
billing:
annotations:
team.aggrega.ai/owner: billing-squad
aggrega.ai/namespace: billing
features:
metrics:
type: core/prometheus-exporter
components:
invoice-api:
type: core/compute/server
payment-worker:
type: core/compute/worker

Derleme alt sistem ağacını düzleştirir: invoice-api ve payment-worker her biri metrics iliştirmesini ve her iki ek açıklamayı taşır; bir Recipe bunları {{ index .context.annotations.aggregate "team.aggrega.ai/owner" }} olarak okur. aggrega.ai/namespace bir sağlayıcı ek açıklamasıdır, bu nedenle her iki bileşeni de billing ad alanına yerleştirir. Release, iliştirmenin infra değerini her bileşenin girdisi altında, alt sistemin ona verdiği adla yapılandırır ve Release’in ayarladığı bir ad alanı, kapsadığı bileşenler için alt sistemin ad alanını geçersiz kılar.

Kendine ait bir şeye bağlanan bir iliştirme

Bir iliştirme kendi uses: bloğunu taşıyabilir ve kenarı, üzerinde bulunduğu bileşenden değil iliştirmenin kendisinden çizer. Her hedefte yedeklenen bir veri deposu örneğinde operatör core/backup öğesini veritabanına iliştirir ve iliştirmeyi yedeklerin gittiği kovaya bağlar; release-helm-velero.yaml dosyasından:

spec:
components:
db:
features:
backup:
type: core/backup
infra:
schedule: "30 2 * * *"
retention_days: 14
uses:
store:
bucket:
target: backups

Veritabanının kendi bağlantıları değişmez: backups öğesine giden kenar iliştirmeye aittir, onun tarafından çizilmiş olarak kaydedilir ve diğer her kenar gibi politika tarafından denetlenir. Operasyonel bir Feature ve kimlik bilgisi Feature’ı aynı şekilde iliştirilir ve her ikisi de bir uses: bloğu taşıyabilir.