Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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:

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

Kemudian ia mencetak perintah yang dijalankan berikutnya:

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

dan 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: 0

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

directory: 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.

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

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