Veri modeli
Bu sayfa tek bir fikri, bir bileşen hakkında hangi verileri kimin yazdığını açıklar ve çalıştırılabilir bir çalışma alanı değildir. Tek sözleşme, üç gerçekleştirme bunu derlediğiniz bir çalışma alanında gösterir; şu komutla kendi klasörünüze yazın:
aggrega scaffold --example postgres-three-realizationsArdından sırada çalıştırılacak komutları yazdırır:
cd postgres-three-realizationsaggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega build --release release-external.yaml --auto-pullvalues ve infra: iki ad alanı, iki yazar
Bir Component iki ayrı ayar kümesi bildirir. values alanları geliştiriciye aittir ve Aggregate’te yazılır: uygulamanın ihtiyaç duyduğu, her ortamda aynı olan şeyler. infra alanları operatöre aittir ve Release’te yazılır: bir ortamdan diğerine değişen boyutlandırma ve yerleşim. Şemalar ikisini birbirinden ayrı tutar — Aggregate şemasında bir bileşen üzerinde infra yoktur ve Release şemasında values yoktur — bu nedenle hiçbir yazar diğerinin alanlarını ayarlayamaz. Bir Recipe ikisini de iki ayrı nesne olarak, .values ve .infra olarak alır.
Örnekte geliştirici, veritabanını ve oturum açma rolünü adlandırır; aggregate.yaml dosyasından:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appuserve yönetilen bir örnek derleyen Release onu boyutlandırır; yorumları çıkarılmış hâliyle release-managed.yaml dosyasından:
spec: boundaries: stack: directory: stack components: db: infra: engine_version: "16" storage: size: 100Gi type: gp3 ha: enabled: true read_replicas: 0Örnekteki diğer iki Releases, aynı Aggregate’i bir kümede ve zaten var olan bir sunucuya karşı, her biri kendi infra değerleriyle derler; Aggregate değişmez.
Yine de ortama göre değişmesi gereken bir değer yukarı taşınır: Aggregate bir parametre bildirir, onu değerin içine yazar ve her Release parametreyi karşılar (bkz. Bir derlemenin dosyaları).
Bir başkası üzerine kurulan Release
Bir Release, extends: ile başka bir Release’i temeli olarak adlandırabilir ve yalnızca farklı olanı değiştirebilir. Alt öğe temelin sınırlarını, yerleşimini ve parametrelerini devralır; extends: yanında aggregate: bildirmek Release şeması tarafından reddedilir, çünkü alt öğe temeliyle aynı Aggregate’i derlemek zorundadır. Kendi Manifest’ini adlandırabilir ya da manifest: alanını dışarıda bırakıp temelinkini devralabilir.
# release-prod.yaml: the base gives every other settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500GiBir sınırın directory: değeri diğer her ayar gibi devralınır; bu nedenle değişmez bir dizini devralan alt öğe, temelinin işlendiği yere işlenir. Her Release’in çıktısını kendine ait bir yere gönderen şey, dizini bir parametreye göre yazmaktır; bkz. Bileşik Release ve extends ile devralma.
Bir başkası üzerine kurulan Manifest
Bir Manifest de aynı şekilde başka birini genişletebilir ve girdileri, aynı anahtar için temelin girdisinin yerini alır. Bir geliştirme Manifest’i, üretim Manifest’inin her bağlamasını koruyup kimlik bilgilerinin nasıl gerçekleştirildiğini değiştirebilir: burada bir core/referenced-secret eki üretimde bir gizli bilgi deposundan alınır, geliştirmede ise bir yazarın sağladığı değerden bir Secret’e yazılır.
spec: mappings: components: type: core/datastore/postgres:1.0.0: helm/postgres:1.0.0 features: type: core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0---# manifest-dev.yamlspec: extends: ./manifest-prod.yaml mappings: features: type: core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0İki gerçekleştirme Secret’in adını aynı şekilde yayımlar; bu nedenle kimlik bilgisini okuyan bir bileşen, hangi Manifest altında olursa olsun aynı başvuruyu işler; Tek geliştirici niyeti, iki kimlik bilgisi teslim biçimi ikisini de derler ve karşılaştırır.
İki etiket: tür ve kategori
Her Component, ayrılmış component.aggrega.ai/type etiketinde kapalı bir kümeden bir değer taşır: server, uzun süre çalışan bir uç nokta; worker, bir arka plan tüketicisi; stateful-server, kendi kalıcı verisini tutan bir şey; task, tamamlanana kadar çalışan; function, olay güdümlü bir işlev; ve resource, kendine ait hiçbir hesaplama çalıştırmayan yönetilen bir bulut kaynağı. Değer, bir Aggregate içindeki örnekte değil, her zaman katalog varlığında bulunur.
Tür, altyapının bir bileşeni nasıl ele alması gerektiğini söyler, bileşenin ne için olduğunu değil. Kendi diskini tutan bir ileti aracısı, tıpkı bir veritabanı gibi bir stateful-server türüdür: core/messaging/kafka ve core/datastore/postgres aynı türü taşır. Bir okuyucunun göz attığı şey diğer etikettir, component.aggrega.ai/category — aracı için messaging, veritabanı için datastore — ve bu aynı zamanda varlığın bulunduğu katalog dizinidir. Bir etikete göre yazılmış bir seçici diğeriyle asla eşleşmez.