Model data
Halaman ini menjelaskan satu gagasan, yaitu siapa yang menulis data apa tentang sebuah komponen, dan bukan ruang kerja yang dapat dijalankan. Satu kontrak, tiga realisasi menunjukkannya dalam ruang kerja yang Anda build; tulis ruang kerja itu ke folder Anda sendiri dengan:
aggrega scaffold --example postgres-three-realizationsKemudian ia mencetak perintah yang dijalankan berikutnya:
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 dan infra: dua namespace, dua penulis
Sebuah Component mendeklarasikan dua set pengaturan yang terpisah. values-nya milik developer, ditulis di Aggregate: apa yang dibutuhkan aplikasi, sama di setiap lingkungan. infra-nya milik operator, ditulis di Release: ukuran dan penempatan, yang berbeda dari satu lingkungan ke lingkungan berikutnya. Skema memisahkan keduanya — skema Aggregate tidak memiliki infra pada komponen dan skema Release tidak memiliki values — sehingga tidak ada penulis yang dapat mengatur field milik penulis lainnya. Recipe menerima keduanya, sebagai dua objek terpisah, .values dan .infra.
Dalam contoh ini, developer menamai basis data dan peran login-nya, dari aggregate.yaml:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appuserdan Release yang mem-build instans terkelola menentukan ukurannya, dari release-managed.yaml dengan komentarnya dihilangkan:
spec: boundaries: stack: directory: stack components: db: infra: engine_version: "16" storage: size: 100Gi type: gp3 ha: enabled: true read_replicas: 0Dua Releases lainnya dalam contoh ini mem-build Aggregate yang sama di dalam klaster dan terhadap server yang sudah ada, masing-masing dengan infra-nya sendiri; Aggregate tidak berubah.
Nilai yang tetap perlu bervariasi menurut lingkungan diangkat: Aggregate mendeklarasikan parameter, menuliskannya ke dalam nilai, dan setiap Release memenuhi parameter tersebut (lihat File dari sebuah build).
Release yang dibangun di atas Release lain
Sebuah Release dapat menyebutkan Release lain sebagai dasarnya dengan extends: dan hanya mengubah apa yang berbeda. Turunan mewarisi batas, penempatan, dan parameter dari dasarnya, dan mendeklarasikan aggregate: di samping extends: ditolak oleh skema Release, karena turunan harus mem-build Aggregate yang sama dengan dasarnya. Turunan dapat menyebutkan Manifest-nya sendiri, atau menghilangkan manifest: dan mewarisi milik dasarnya.
# release-prod.yaml: the base gives every other settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500Gidirectory: sebuah batas diwarisi seperti pengaturan lainnya, sehingga turunan yang mewarisi direktori literal akan dirender ke tempat yang sama dengan dasarnya. Menulis direktori berdasarkan sebuah parameter adalah cara mengirim keluaran setiap Release ke tempatnya sendiri; lihat Release komposit dan pewarisan extends.
Manifest yang dibangun di atas Manifest lain
Sebuah Manifest dapat memperluas Manifest lain dengan cara yang sama, dan entri-entrinya menggantikan entri dasar untuk kunci yang sama. Manifest pengembangan dapat mempertahankan setiap pengikatan dari Manifest produksi dan mengubah cara kredensial direalisasikan: di sini lampiran core/referenced-secret diambil dari penyimpanan rahasia di produksi dan ditulis ke dalam sebuah Secret dari nilai yang diberikan penulis di pengembangan.
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.0Kedua realisasi memublikasikan nama Secret dengan cara yang sama, sehingga komponen yang membaca kredensial merender referensi yang sama di bawah Manifest mana pun; Satu niat developer, dua bentuk pengiriman kredensial mem-build keduanya dan membandingkannya.
Dua label: tipe dan kategori
Setiap Component membawa satu nilai dari himpunan tertutup pada label yang dicadangkan component.aggrega.ai/type: server, endpoint yang berjalan lama; worker, konsumen latar belakang; stateful-server, sesuatu yang menyimpan data persistennya sendiri; task, yang berjalan hingga selesai; function, fungsi berbasis peristiwa; dan resource, sumber daya cloud terkelola yang tidak menjalankan komputasi sendiri. Nilai ini berada pada entitas katalog, tidak pernah pada instans di dalam Aggregate.
Tipe menyatakan bagaimana infrastruktur harus memperlakukan sebuah komponen, bukan untuk apa komponen itu. Message broker yang memegang disknya sendiri adalah stateful-server, persis seperti basis data: core/messaging/kafka dan core/datastore/postgres membawa tipe yang sama. Yang digunakan pembaca untuk menelusuri adalah label lainnya, component.aggrega.ai/category — messaging untuk broker, datastore untuk basis data — yang juga merupakan direktori katalog tempat entitas itu berada. Selektor yang ditulis berdasarkan satu label tidak pernah cocok pada label lainnya.