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

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:

Terminal window
aggrega scaffold --example postgres-three-realizations

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

Terminal window
cd postgres-three-realizations
aggrega build --release release-selfhosted.yaml --auto-pull
aggrega build --release release-managed.yaml --auto-pull
aggrega build --release release-managed-dns.yaml --auto-pull
aggrega build --release release-external.yaml --auto-pull

values 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: appuser

ve 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 setting
spec:
extends: ./release-base.yaml
boundaries:
stack:
components:
db:
infra:
storage:
size: 500Gi

Bir 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.

manifest-prod.yaml
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.yaml
spec:
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.