Aggrega Catalog (ArtifactLibrary) şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/artifactlibrary-v1beta1.schema.json
Recipes ve FeatureRecipes tarafından render zamanında artifacts.<name>: { $import: ... } aracılığıyla tüketilen, adlandırılmış yapıt paketlerinden oluşan yeniden kullanılabilir bir koleksiyon. Her paket, tek bir birim olarak içe aktarılan bir çıktı dosyaları kümesidir. Katman 3 — Recipe’ler arası yapıt yeniden kullanımına ihtiyaç duyan kataloglar için isteğe bağlıdır. Tek yazım modu: yalnızca Go şablonları.
ArtifactLibrary varlıklarının yazımına ilişkin açıklayıcı rehberlik için ArtifactLibrary yazım başvurusuna bakın; bu sayfa, o başvurunun tanımladığı yapısal şemayı belgeler.
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | evet | Sabit: "aggrega.ai/v1beta1" |
kind | const “ArtifactLibrary” | evet | Sabit: "ArtifactLibrary" |
metadata | object | evet | |
spec | object | evet | ArtifactLibrary’nin içeriği. spec.artifacts zorunludur ve en az bir paket bildirmelidir. spec, additionalProperties: false taşır — zarf düzeyinde paralel yazım modları kabul edilmez. Tek yazım modu yaklaşımı, render işlemini tekdüze tutar (baştan sona Go şablonu) ve içe aktarılan paketler tüketilirken yazarların render ortasında değerlendirme modelleri arasında geçiş yapmak zorunda kalmasını önler. |
Ek özelliklere izin verilmez.
artifactlibrary.metadata
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Kütüphane için PascalCase tanımlayıcı. Yalın ad kimlik başvurusu ^[A-Z][A-Za-z0-9]*$. |
version | string | evet | Kütüphanenin katı Anlamsal Sürümlemesi (ör. 1.0.0). Bir tüketici bunu, yalın ad başvurusunda (:<version> asgari sürüm tabanı olarak öne sürebilir; çözümlenen sürüm, Release başına kilit dosyasına aittir. Desen: ^(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-]+)*))?$. |
description | string | hayır | Kütüphanenin neyi kapsadığına dair kısa bir özet. |
labels | string eşlemi | hayır | Yazar tarafından bildirilen etiketler. Derleyici içeriğe karşı tarafsızdır ve etiket değerlerini yorumlamaz: bunlar, kütüphaneyi okuyan herhangi bir şeyin eşleştirme yapabilmesi için taşınan opak meta verilerdir. |
annotations | string eşlemi | hayır | Yazar tarafından bildirilen ek açıklamalar. Etiketlerle aynı opak meta veri yaklaşımı. |
Ek özelliklere izin verilmez.
artifactlibrary.spec
ArtifactLibrary’nin içeriği. spec.artifacts zorunludur ve en az bir paket bildirmelidir. spec, additionalProperties: false taşır — zarf düzeyinde paralel yazım modları kabul edilmez. Tek yazım modu yaklaşımı, render işlemini tekdüze tutar (baştan sona Go şablonu) ve içe aktarılan paketler tüketilirken yazarların render ortasında değerlendirme modelleri arasında geçiş yapmak zorunda kalmasını önler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
artifacts | string eşlemlerinin eşlemi | evet | Yeniden kullanılabilir yapıt paketlerinin adlandırılmış eşlemi. Her paket, birbirine ait çıktı dosyalarını gruplar (örneğin bir CRD, onun RBAC’si ve bir ConfigMap). Her dosya gövdesi zarf doğrulaması için opaktır — içerik anlamı, tüketim zamanında Go şablon ayrıştırıcısı tarafından ele alınır. Anahtarlar: PascalCase tanımlayıcı. Girdi anahtarları kanonik başvuru URL’lerinde (#/artifacts/<name>) görünür; zarf düzeyindeki kısıt, PascalCase olmayan anahtarların katalog ekosistemi boyunca yayılmasını önler. ^[A-Z][A-Za-z0-9]*$. En az 1 girdi. |
Ek özelliklere izin verilmez.