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:
aggrega scaffold --example module-boundary-routingArdından sırada çalıştırılacak komutları yazdırır:
cd module-boundary-routingaggrega build --release release.yaml --auto-pullModü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/ferretdbBir 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.mongoBir 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.netAdres 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/workerDerleme 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: backupsVeritabanı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.