Aggrega yol şablonu bağlamı şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json
Aggrega Release’i derlerken Release.spec.boundaries[].directory ve Release.spec.boundaries[].subDirectory (ve Component başına subDirectory geçersiz kılması) üzerinde değerlendirilen Go şablonlarının kullandığı değişken izin listesi. Yol şablonları missingkey=error kullanır (değer şablonları için geçerli genel missingkey=zero düzeninden farklı olarak) ve buna ek olarak ayrıştırma zamanında doğrulama yapılır: bir yol şablonundaki her alan başvurusu, ilgili bağlam için (directory: veya subDirectory:) bu izin listesinde yer almalıdır; bilinmeyen alanlar render zamanında değil, her zaman ayrıştırma zamanında bir Loud Guardrail hatası üretir. Değer şablonlarıyla farkı, dil başvurusundaki Yol Şablonu Değişkenleri sayfası anlatır.
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
capability | string | hayır | directory: VE subDirectory: içinde kullanılabilir. Katkıda bulunan bileşenin Recipe’sinin spec.capability içinde bildirdiği render yeteneği; varsa sürüm sabitlemesi çıkarılmış olarak — örneğin ‘helm’, ‘helm-chart’ veya ‘compose’. subDirectory: varsayılan olarak {{ .capability }} değerini alır; her yeteneğin yapıtlarını sınırın dizini altındaki kendi alt klasörüne yerleştiren budur. Bir directory: şablonunda değer bileşen başına çözümlenir; bu nedenle alt ağacı birden fazla yetenek katkısı yapan bir sınır, yetenek başına bir dizin olarak değerlendirilir; .parent_boundary.directory değerini yayımlayan ayrı sınır başına dolaşım, herhangi bir bileşen bağlanmadan önce çalışır ve bu değeri boş bırakır. |
boundary_name | string | hayır | directory: VE subDirectory: içinde kullanılabilir. release.spec.boundaries. |
parameters | object | hayır | directory: VE subDirectory: içinde kullanılabilir. Release’ten gelen türlendirilmiş parametre eşlemesi. Yol şablonları, parameters tek geçişli yaşam döngüsünden bilinçli bir istisna olarak .parameters erişimi alır — değer şablonları .parameters ALMAZ; ortama özgü değerler değer şablonlarına önceden enterpolasyonu yapılmış Aggregate YAML’ı üzerinden akar. |
component_id | string | hayır | YALNIZCA subDirectory: içinde kullanılabilir. Yerleştirilen katkıda bulunanın kimliği. Bir bileşen için, düzleştirilmiş bileşen başına örnek kimliği (ör. ‘backend’ veya ‘data-layer.main-db’). FeatureRecipe’si sınır için bir kez çalışan (executionScope: boundary) bir sınıra eklenmiş bir Feature için, o ekin yaydığı her kaynağın aggrega.ai/component-id etiketinde taşıdığı oluşturulmuş bileşen kimliği (ör. ‘app’ sınırındaki ‘shared’ eki için ‘bfr—app—shared’); ekin işleme eklentisi adları sınırladığında kısaltılır, böylece adlandırdığı dizin o etiketle eşleşir. Sınır düzeyinde anlamsızdır ve directory: şablonlarında ayrıştırma zamanı doğrulamasıyla reddedilir. |
parent_boundary | object | hayır | directory: VE subDirectory: içinde kullanılabilir. Üst sınırın önceden çözümlenmiş değerleri. Her sınırın şablonlarını üst sınırının çözümlenmiş değerleriyle değerlendiren derinlik öncelikli bir dolaşımla doldurulur; alt sınırlar burada hiçbir zaman kendi değerlerini görmez. Üst düzey bir sınırın üst sınırı yoktur; bu nedenle orada parent_boundary altında bir anahtar okumak, sınırı, şablon alanını ve eksik anahtarı belirterek derlemeyi durdurur. |
manifest | object | hayır | directory: VE subDirectory: içinde kullanılabilir. Bileşen başına değerlendirildiği şekliyle çözümlenmiş Recipe meta verilerini taşır. |
Ek özelliklere izin verilmez.
path-template-context.parent_boundary
directory: VE subDirectory: içinde kullanılabilir. Üst sınırın önceden çözümlenmiş değerleri. Her sınırın şablonlarını üst sınırının çözümlenmiş değerleriyle değerlendiren derinlik öncelikli bir dolaşımla doldurulur; alt sınırlar burada hiçbir zaman kendi değerlerini görmez. Üst düzey bir sınırın üst sınırı yoktur; bu nedenle orada parent_boundary altında bir anahtar okumak, sınırı, şablon alanını ve eksik anahtarı belirterek derlemeyi durdurur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
directory | string | hayır | Üst öğenin değerlendirilmiş directory dizesi. |
boundary_name | string | hayır | Üst öğenin adı (release.spec.boundaries içindeki eşleme anahtarı). |
parameters | object | hayır | Release’in parametre eşlemi; .parameters’ın taşıdığı eşlemle aynıdır. |
annotations | string eşlemi | hayır | Basamaklama çözümlendikten sonra üst sınırın açıklamaları. |
Ek özelliklere izin verilmez.
path-template-context.manifest
directory: VE subDirectory: içinde kullanılabilir. Bileşen başına değerlendirildiği şekliyle çözümlenmiş Recipe meta verilerini taşır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
recipe_name | string | hayır | Bileşen başına aramadan elde edilen, çözümlenmiş Recipe’nin adı. |
Ek özelliklere izin verilmez.