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

Skema Aggrega Catalog (ArtifactLibrary)

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

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

Kumpulan bundel artefak bernama yang dapat digunakan ulang, yang dikonsumsi oleh Recipes dan FeatureRecipes saat render melalui artifacts.<name>: { $import: ... }. Setiap bundel adalah sekumpulan file keluaran yang diimpor sebagai satu unit. Tingkat 3 — opsional untuk katalog yang memerlukan penggunaan ulang artefak lintas Recipe. Satu mode penulisan: hanya templat Go.

Lihat referensi penulisan ArtifactLibrary untuk panduan prosa tentang penulisan entitas ArtifactLibrary; 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 “ArtifactLibrary”yaKonstanta: "ArtifactLibrary"
metadataobjectya
specobjectyaKonten ArtifactLibrary. spec.artifacts wajib ada dan harus mendeklarasikan setidaknya satu bundel. spec memiliki additionalProperties: false — tidak ada mode penulisan paralel yang diterima pada tingkat envelope. Pendekatan satu mode penulisan ini menjaga render tetap seragam (templat Go di seluruhnya) dan menghindarkan penulis dari keharusan berganti model evaluasi di tengah render saat mengonsumsi bundel yang diimpor.

Properti tambahan tidak diizinkan.

artifactlibrary.metadata

PropertiJenisWajibDeskripsi
namestringyaPengidentifikasi PascalCase untuk library. Ini adalah nama dalam referensi identitas nama polos #/artifacts/; versi disediakan oleh lockfile per-Release dan tidak ada host registry yang masuk ke dalam referensi atau pengidentifikasi turunan apa pun. Pola: ^[A-Z][A-Za-z0-9]*$.
versionstringyaSemantic Versioning ketat dari library (misalnya, 1.0.0). Konsumen dapat menegaskan ini sebagai batas bawah versi minimum :<version> yang opsional dalam referensi nama polos (:#/artifacts/); lockfile per-Release memiliki versi yang di-resolve. 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-]+)*))?$.
descriptionstringtidakRingkasan singkat tentang cakupan pustaka.
labelsmap of stringtidakLabel yang dideklarasikan penulis. Compiler netral terhadap konten dan tidak menafsirkan nilai label: label adalah metadata buram, yang dibawa agar apa pun yang membaca library dapat mencocokkan berdasarkan label tersebut.
annotationsmap of stringtidakAnotasi yang dideklarasikan oleh penulis. Pendekatan metadata buram yang sama seperti label.

Properti tambahan tidak diizinkan.

artifactlibrary.spec

Konten ArtifactLibrary. spec.artifacts wajib ada dan harus mendeklarasikan setidaknya satu bundel. spec memiliki additionalProperties: false — tidak ada mode penulisan paralel yang diterima pada tingkat envelope. Pendekatan satu mode penulisan ini menjaga render tetap seragam (templat Go di seluruhnya) dan menghindarkan penulis dari keharusan berganti model evaluasi di tengah render saat mengonsumsi bundel yang diimpor.

PropertiJenisWajibDeskripsi
artifactsmap dari map dari stringyaMap bernama berisi bundel artefak yang dapat digunakan ulang. Setiap bundel mengelompokkan file keluaran yang saling terkait (misalnya CRD, RBAC-nya, dan ConfigMap). Setiap isi file bersifat opak bagi validasi envelope — semantik konten ditangani oleh parser Go template pada saat konsumsi. Kunci: pengidentifikasi PascalCase. Kunci entri muncul dalam URL referensi kanonis (#/artifacts/<name>); batasan di tingkat envelope mencegah kunci non-PascalCase menyebar melalui ekosistem katalog. merujuk ke seluruh bundel, tidak pernah ke file individual di dalamnya. Pola: ^[A-Z][A-Za-z0-9]*$. Minimal 1 entri.

Properti tambahan tidak diizinkan.