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

Skema Aggrega Dependency Lockfile (Manifest)

Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.

Id skema: https://aggrega.ai/schemas/manifest-v1beta1.schema.json

Satu lockfile global yang memetakan tipe abstrak component dan Feature ke implementasi Recipe dan FeatureRecipe yang konkret, berdasarkan tipe, dengan penimpaan per instans berdasarkan nama.

Lihat referensi penulisan Manifest untuk panduan prosa tentang penulisan entitas Manifest; halaman ini mendokumentasikan skema struktural yang dijelaskan oleh referensi tersebut.

Jenis tingkat teratas: object

Properti

PropertiJenisWajibDeskripsi
apiVersionconst “aggrega.ai/v1beta1”yaKonstanta: "aggrega.ai/v1beta1"
kindconst “Manifest”yaKonstanta: "Manifest"
metadataobjectya
defsstring[]tidakBlok opsional untuk anchor YAML standar (& dan *) agar Manifest tetap DRY sambil mempertahankan kamus O(1) yang datar bagi kompiler.
specobjectyaDeklarasi pemetaan Manifest beserta pewarisan basis opsional: mappings menghubungkan jenis component dan feature abstrak ke implementasi Recipe dan FeatureRecipe konkret; extends mewarisi pemetaan dari Manifest basis.

Properti tambahan tidak diizinkan.

manifest.metadata

PropertiJenisWajibDeskripsi
namestringyaPanjang minimal 1 karakter.
versionstringyaSemantic Versioning ketat dari lockfile manifest (misalnya, 1.0.0). Pola: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$.
descriptionstringtidakApa entitas ini dan untuk apa, ditulis bagi seseorang yang sedang memutuskan apakah akan menggunakannya. Awali dengan kalimat yang menyebutkan hal tersebut, lalu tambahkan apa yang perlu diketahui pembaca untuk memilih dan menggunakannya dengan benar — apa yang diharapkannya dari Release yang menggunakannya, dan apa pun yang mengejutkan tentang perilakunya. Satu paragraf pendek adalah panjang yang lazim.
maintainersobject[]tidakDaftar pemelihara yang memiliki entitas ini.
licensestringtidakPengidentifikasi SPDX untuk lisensi perangkat lunak yang dideskripsikan entitas ini, seperti MIT atau AGPL-3.0. Pengidentifikasi ini mencatat ketentuan perangkat lunak tersebut, bukan ketentuan berkas ini.
repositorystringtidakURL ke repositori Git tempat berkas sumber berada.
homestringtidakURL halaman beranda, wiki, atau dokumentasi entitas ini.
keywordsstring[]tidakDaftar kata kunci deskriptif untuk kemudahan penemuan di UI.

Properti tambahan tidak diizinkan.

manifest.metadata.maintainers[]
PropertiJenisWajibDeskripsi
namestringya
emailstringtidak
urlstringtidak

Properti tambahan tidak diizinkan.

manifest.spec

Deklarasi pemetaan Manifest beserta pewarisan basis opsional: mappings menghubungkan jenis component dan feature abstrak ke implementasi Recipe dan FeatureRecipe konkret; extends mewarisi pemetaan dari Manifest basis.

PropertiJenisWajibDeskripsi
extendsstringtidakURI Manifest basis tempat pemetaan diwarisi. Untuk kunci yang sama, pemetaan turunan menggantikan pemetaan basis.
mappingsobjectyaMemetakan antarmuka abstrak ke implementasi konkret. Deklarasikan pemetaan di bawah kunci tingkat atas ‘components’ dan ‘features’, masing-masing memetakan URI component-type / feature-type langsung ke URI Recipe / FeatureRecipe. Kedua kunci ini adalah seluruh permukaannya; tidak ada kunci lain yang diterima di sini. Pemetaan bersifat agnostik terhadap kapabilitas pada lapisan Manifest — penentuan kapabilitas berasal dari spec.capability setiap Recipe yang di-resolve saat Aggrega mem-build Release. Kunci: Salah satu dari "components", "features".

Properti tambahan tidak diizinkan.

manifest.spec.mappings

Memetakan antarmuka abstrak ke implementasi konkret. Deklarasikan pemetaan di bawah kunci tingkat atas ‘components’ dan ‘features’, masing-masing memetakan URI component-type / feature-type langsung ke URI Recipe / FeatureRecipe. Kedua kunci ini adalah seluruh permukaannya; tidak ada kunci lain yang diterima di sini. Pemetaan bersifat agnostik terhadap kapabilitas pada lapisan Manifest — penentuan kapabilitas berasal dari spec.capability setiap Recipe yang di-resolve saat Aggrega mem-build Release.

PropertiJenisWajibDeskripsi
componentsmapping_tiertidakPemetaan tipe Component ke URI Recipe. Sebuah URI Recipe memuat paling banyak dua segmen — capability di depan yang bersifat opsional, lalu nama recipe — ditambah versi opsional; referensi dengan segmen ketiga tidak cocok dengan recipe mana pun. Bentuk versi: tepat (‘postgres-bitnami:1.2.0’), rentang (‘postgres-bitnami:^1.2.0’), atau tanpa versi (‘postgres-bitnami’); resolver menyematkan versi hasil resolusi di lockfile pada resolusi pertama. Sebuah referensi juga dapat dikualifikasi dengan capability (‘terraform/mariadb-rds:1.0.0’, segmen sebelum ’/’ pertama menyebutkan spec.capability milik recipe) — wajib bila lebih dari satu recipe memiliki nama yang sama; referensi polos yang ambigu menghentikan resolusi secara tegas alih-alih diam-diam memilih salah satunya.
featuresmapping_tiertidakPemetaan feature-type ke URI FeatureRecipe. Mencakup Features operasional maupun Features kredensial (berlabel feature.aggrega.ai/kind: secret).

Kunci: Salah satu dari "components", "features".

Properti tambahan tidak diizinkan.

Definisi

mapping_tier

Resolusi dua tingkat: ‘type’ memetakan berdasarkan jenis katalog (massal DRY), ‘name’ memetakan berdasarkan nama instans (penimpaan granular). Keduanya opsional, tetapi setidaknya satu harus ada. Name lebih diutamakan daripada type selama resolusi. Kunci type berversi lebih diutamakan daripada yang tanpa versi.

PropertiJenisWajibDeskripsi
typemap of stringtidakMemetakan URI jenis katalog ke URI Recipe. Mendukung kunci berversi (‘core/api-server:1.0.0’) untuk kecocokan tepat, kunci rentang (‘core/api-server:^1.0.0’) untuk kecocokan yang kompatibel secara mayor, atau kunci tanpa versi (‘core/api-server’) untuk kecocokan versi apa pun.
namemap of stringtidakMemetakan nama instans tertentu ke URI Recipe. Lebih diutamakan daripada pemetaan berbasis type.
annotationsmap of objecttidakPintasan Feature berbasis anotasi. Memetakan kunci anotasi ke URI Feature beserta tabel routing yang dikelompokkan per pilar, dari subkunci jalur bertitik ke pilar Feature (values atau infra). Validasi diturunkan dari deklarasi spec.schema.. pada Feature target; binding hanya mendeklarasikan routing. URI Feature yang dirujuk oleh ‘feature’ HARUS juga muncul di bagian ‘type’ (di sanalah binding versi FeatureRecipe berada).

Properti tambahan tidak diizinkan.