Aggrega Catalog (WorkloadLibrary) şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/workloadlibrary-v1beta1.schema.json
Recipes’in render zamanında workload: { $import: ... } aracılığıyla tükettiği, yeniden kullanılabilir Workload şablon parçalarından oluşan bir koleksiyon. Katman 3 — Recipe’ler arası workload yeniden kullanımına ihtiyaç duyan kataloglar için isteğe bağlıdır. Tek yazım modu: yalnızca Go şablonları.
WorkloadLibrary varlıklarının yazımına ilişkin açıklayıcı rehberlik için WorkloadLibrary yazım başvurusuna bakın; bu sayfa, o başvurunun anlattığı 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 “WorkloadLibrary” | evet | Sabit: "WorkloadLibrary" |
metadata | object | evet | |
spec | object | evet | WorkloadLibrary’nin içeriği. spec.workloads zorunludur ve en az bir girdi bildirmelidir. spec, additionalProperties: false taşır — zarf düzeyinde paralel yazım modları kabul edilmez. Tek yazım modu yaklaşımı, Recipe render işlemini tek biçimli tutar (baştan sona Go şablonu) ve içe aktarılan parçalar tüketilirken yazarların render ortasında değerlendirme modeli değiştirmek zorunda kalmasını önler. |
Ek özelliklere izin verilmez.
workloadlibrary.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 alt sınırı olarak belirtebilir; çö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.
workloadlibrary.spec
WorkloadLibrary’nin içeriği. spec.workloads zorunludur ve en az bir girdi bildirmelidir. spec, additionalProperties: false taşır — zarf düzeyinde paralel yazım modları kabul edilmez. Tek yazım modu yaklaşımı, Recipe render işlemini tek biçimli tutar (baştan sona Go şablonu) ve içe aktarılan parçalar tüketilirken yazarların render ortasında değerlendirme modeli değiştirmek zorunda kalmasını önler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workloads | string eşlemi | evet | Yeniden kullanılabilir Workload şablon parçalarının adlandırılmış eşlemi. Her girdinin 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 (#/workloads/<name>) görünür; zarf düzeyindeki kısıtlama, PascalCase olmayan anahtarların katalog ekosistemine yayılmasını önler. Desen: ^[A-Z][A-Za-z0-9]*$. En az 1 girdi. |
Ek özelliklere izin verilmez.