Aggrega şablon bağlamı şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/template-context-v1beta1.schema.json
Derleyicinin işleme sırasında oluşturduğu ve Recipe ve FeatureRecipe şablonlarına aktardığı görünüm. Bir ek FeatureRecipe işlenirken derleyici ayrıca .attachment_name ve .inject alanlarını eke özgü bağlamla, .context.render_facts alanını ekin barındırıcısının provider’ının barındırıcının işlenmesi hakkında bildirdikleriyle ve ekin kendi kaynaklarını üreten şablonlarda .context.used_by alanını barındırıcıyı kullanan bileşenlerle doldurur. Sınır kapsamlı bir FeatureRecipe için (spec.executionScope: boundary), sınır için bir kez çalıştırdığı şablonlar — aralarında locals, provides, source, valuesMapping, artifacts ve pipeline adımları da vardır — .context, .workload, .attachment_name, .inject ve .inject_raw sütunlarının bulunmadığını, onların yerine bir .boundary.* sütununun doldurulduğunu görür — özelliklerin en altındaki boundary bloğuna bakın; injectMapping’i ise ekin ulaştığı her bileşen için o bileşenin bağlamında bir kez çalışır, bu nedenle .context.* ve .attachment_name alanlarını okur ve orada .boundary ayarlanmaz. Bu görünüm diske KALICI OLARAK YAZILMAZ; yalnızca işleme sırasında derleyici belleğinde bulunur. Bu şema, derleyici ile Ops şablon yazarları arasındaki sözleşmeyi belgeler.
Temel işleme aşamalarında kullanılabilirlik, aşamaların çalışma sırasıyla:
- Provides değerlendirmesi (locals ön bölümü, ardından provides): yalnızca düğüme yerel sütunlar. Bir locals girdisi kendi bloğunda üstündeki girdileri okur; bir provides şablonu düğümün çözümlenmiş .locals değerinin tamamını okur. Kendine başvuru yasaktır (hiçbir provides girdisi başka birini okumaz).
- Kaynak çözümleme (locals yayımlama + source değerlendirmesi): tüm sütunlar; .source ve .workload yoktur. Bu locals değerleri burada .locals üzerine yayımlanır, ardından source: bunlara göre değerlendirilir.
- Değer eşleme (valuesMapping): tüm sütunlar + .source; .workload yoktur.
- Workload sentezi (workload değerlendirmesi): tüm sütunlar + .source; .workload değerlendirilmektedir (kendine başvuruda yoktur).
- Artefakt değerlendirmesi (artifacts): tüm sütunlar + .source + .workload (en kapsamlı bağlam).
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
context | object | evet | Derleyicinin oluşturduğu, kimlik, topoloji ve teslim verilerini sağlayan yürütme bağlamı. |
values | object | evet | Bu düğümün opak bilişsel yükü; çözümleme sırasında şema doğrulayıcısı tarafından zaten doğrulanmıştır. Dokunulmadan aktarılır. |
infra | object | evet | Bu düğüm için Release’ten enjekte edilen fiziksel boyutlandırma yükü. Geliştiriciyi tamamen atlar. |
locals | string eşlemi | evet | Recipe’nin kendi özel durumu (ör. primary_compute, volumes_path). locals ön bölümünde, o düğümün provides’ından önce değerlendirilir ve kaynak çözümlemesinde bu sütuna yayımlanır. Her girdi, aynı bloğun o ana kadar çözümlenmiş girdilerini taşıyan, kendi içinde kapalı, düğüme yerel bir bağlamda değerlendirilen bir Go şablonudur; bu nedenle bir girdi kendisinin ÜSTÜNDE tanımlanmış bir kardeşini OKUYABİLİR ve o kardeşin çözümlenmiş değerini alır. Bir girdinin başka birini okuduğu her yerde yazım sırası sözleşmenin parçasıdır: bir tanımı okuyucusunun altına taşımak derlemeyi bozar. Daha sonraki bir girdiye ya da bloğun bildirmediği bir anahtara yapılan ‘.locals. |
provides | string eşlemi | hayır | Recipe’nin genel API sözleşmesi. provides değerlendirmesinden doldurulur. Öz başvuru için temel işlemedeki valuesMapping içinde kullanılabilir (ör. {{ .provides.host }}). provides şablonunun kendisi içinde KULLANILAMAZ (provides kendi içinde kapalılık değişmezi). Çağıranlar inject anahtarlarını bu değerlere göre çözümler. |
features | template_attachment eşlemi | hayır | Bu düğümdeki her ek; yazarın ona verdiği örnek adına göre anahtarlanır. Ne ürettiklerinden bağımsız olarak hepsini tek bir sütun taşır (operasyonel bir Feature, kimlik bilgisi Feature’ı, kimlik Feature’ı), çünkü ekler arasında farklı olan, bir şablonun onları nasıl okuduğu değil, ne ürettikleridir. Bir Recipe, işlemesini eklenen yeteneklere uyarlamak ve bir ekin yayımladığını tüketmek için onları okur. Düğümün bağlantılarından birine yazılan bir ek bunların arasında değildir: o bağlantı altında, .context.uses. |
metadata | object | hayır | Belirlenimci adlandırma için genel kimlik sağlayan Release ve derleme meta verileri. Tüm şablon bloklarında kullanılabilir (valuesMapping, injectMapping, pipeline with). |
attachment_name | string | hayır | Yalnızca bir ek FeatureRecipe’si işlenirken doldurulur. Ekin örnek adını içerir: sahip varlığın featuresSchema’sında doldurduğu yuva ya da yazarın ona verdiği serbest ad (ör. ‘admin_password’, ‘db_credentials’). Eke göre farklılaşan, ana bileşenin adından sonra oluşturulan belirlenimci kaynak adları kurmak için kullanılır: ana bileşenin sağlayıcısı, helm’in yaptığı gibi işlenmiş bir ad bildirdiğinde ’{{ .context.rendered_name }}-{{ .attachment_name | replace ”_” ”-” }}’ (ana bileşenin adı bir Kubernetes adının izin verdiği karakterlerle yazılır, ek adındaki alt çizgiler kısa çizgiye dönüştürülür), ana bileşenin sağlayıcısı hiçbir ad bildirmediğinde ise ’{{ .context.instance_id }}-{{ .attachment_name }}’. |
inject | object | hayır | Yalnızca yazılmış bir inject bloğu taşıyan bir ek FeatureRecipe’si işlenirken doldurulur (ör. { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). uses kenarlarından gelen, temel bileşenin önceden doldurulmuş teslim hattı olan .context.inject’ten farklıdır. Yazılmış inject’i olmayan ekler ve temel Recipe’ler için null/yok olarak değerlendirilir. |
inject_raw | object veya null | hayır | inject bloğu için değişmez, değiştirilmemiş Geliştirici niyeti. Bloğun adlandırdığı her mekanizma — env, file, arg ya da ssm_param gibi özel bir mekanizma — kendi adı altında yer alır ve girdileri tam yazıldığı gibi (in, from veya value ile), yazıldıkları sırayla tutar; böylece .inject_raw.ssm_param özel bir mekanizmayı, .inject_raw.env’nin temel bir mekanizmayı okuduğu şekilde okur. Geliştirici inject bloğunu tamamen atladıysa null olarak değerlendirilir. Ops tarafından, inject eşlemesinin değişikliklerinden önce atlamayı saptamak için mantıksal denetimlerde kullanılır (ör. {{ if not .inject_raw }}). Her girdinin, bileşenin kendi values ya da provides değerlerinden hangisini teslim ettiği, girdilerin metninden değil, .context.self_inject üzerinden okunur. |
steps | object eşlemi | hayır | Ardışık düzen adımları arası iletişim. Yalnızca Wasm ardışık düzeni ‘with:’ blokları içinde kullanılabilir. Her anahtar bir ardışık düzen adımı kimliğidir ve o adımın dışa aktardığı çıktıları içerir. |
source | string veya object veya null | hayır | Çözümlenmiş source alanı içeriği. Bir Recipe’nin şablonlarında: kaynak çözümlemesinde, Go şablonu değerlendirmesinden sonra Recipe’nin source: alanından doldurulur, değer eşlemesinden itibaren kullanılabilir (valuesMapping, workload, artifacts) ve Recipe’nin source:‘u yoksa null olur. Bir FeatureRecipe’nin şablonlarında: Go şablonu değerlendirmesinden sonra FeatureRecipe’nin kendi source: alanıdır; valuesMapping’inden önce değerlendirilir, orada ve ondan sonra değerlendirilen her şablonda (omits, workload, artifacts, pipeline adımları) okunur ve asla ana bileşeninki değildir; FeatureRecipe’nin source:‘u yoksa null olur. Bir FeatureRecipe’nin injectMapping’i kaynağından önce değerlendirilir ve ana bileşeninkini okur. String biçimi = URI yolu; object biçimi = yapılandırılmış kaynak (ör. çözümlenmiş sürümlü OCI tanımlayıcısı). |
workload | workload-v1beta1.schema.json veya null | hayır | Bu düğüm için ayrıştırılmış Workload belirtimi. Workload sentezinde, Go şablonu değerlendirmesi + Workload JSON şeması doğrulamasından (workload-v1beta1.schema.json’a karşı) sonra Recipe’nin workload: alanından doldurulur. Yapıt değerlendirmesinden itibaren kullanılabilir (artifacts); böylece yapıtlar workload alanlarına yineleme olmadan başvurabilir (ör. .workload.services.metrics.ports.prom okuyan bir ServiceMonitor). Recipe’nin workload: bloğu yoksa null olarak değerlendirilir. Null bir değer üzerinde .workload.* başvurusunu çözmeye çalışan şablonlar, şablon değerlendirme anında açık bir hatayla başarısız olur. |
boundary | object | hayır | Sınır kapsamlı bağlam — yalnızca spec.executionScope değeri ‘boundary’ olan bir FeatureRecipe’nin sınır için bir kez çalıştırdığı bir şablon değerlendirilirken doldurulur. Component kapsamlı FeatureRecipes bu sütunu almaz; bunların yerine context.instance_id, context.inject, context.uses ve .workload sütunu bileşen başına veri taşır. Sınır kapsamlı bir FeatureRecipe’nin sınır için çalıştırılan şablonları, bu bileşen başına sütunların yerine .boundary.* alır; injectMapping’i ise ekin ulaştığı her bileşenin bağlamında çalışır, bu bileşen başına sütunları okur ve bu sütunu almaz. |
Ek özelliklere izin verilmez.
template-context.context
Derleyicinin oluşturduğu, kimlik, topoloji ve teslim verilerini sağlayan yürütme bağlamı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
instance_id | string | evet | Geçerli düğümün mutlak, düzleştirilmiş kimliği (ör. ‘backend’ veya data-layer modül örneğinin main-db bileşeni için ‘data-layer-zdmain-db’); yazılan her bileşen adının uyduğu alfabeyle yazılır. Aynı Aggregate için derlemeler arasında deterministik ve kararlıdır. Bu düğüm için oluşturulan ve hiçbir sağlayıcının ad türetmediği kaynakların adıdır — Recipe’ten yerleştirilen bir artifact kümesi ve onu kimliğe göre adlandıran bir sağlayıcının sentezlediği bir workload — bu nedenle bunlardan biri için yayımlanan bir adres bu değerden oluşturulur. |
rendered_name | string | hayır | Bu düğüme bağlı sağlayıcının, düğüm için işlediği kaynaklara verdiği ad — yazarın sağladığı kaynak için, sağlanan şablonların kendilerinin işlendiği ad, örneğin bir chart’ın okuduğu release adı; sentezlediği bir workload için, düğümün kimliğini yazmak yerine bir ad türettiği durumda o workload’un kaynaklarına verdiği ad; helm sağlayıcısının aynı release adıyla yaptığı gibi. Bu Recipe, sağlanan bir chart’ın veya modülün bildirdiği ya da böyle bir sağlayıcının sentezlediği bir kaynağı nerede adlandırıyorsa — bir provides girdisinde, bir valuesMapping’de, bir workload’da, bir artifacts girdisinde veya bir pipeline adımının with ya da when alanında — bunu okuyun; çünkü sağlayıcı bu adı, yazılan bir bileşen adının yazıldığından daha dar bir alfabeyle yazabilir ve bu durumda ikisi farklı olur. Bağlı sağlayıcı böyle bir ad türetmediğinde boştur: yerleştirilen bir artifact kümesinin ve onu kimliğe göre adlandıran bir sağlayıcının sentezlediği bir workload’un kaynakları düğümün kimliğini taşır; bu nedenle bunlar için ’{{ .context.instance_id }}’ okuyun; kendi kaynak adlarını yazan bir Recipe ise bunları zaten bilir. Bağlı sağlayıcının ad bildirmediği yerde bu anahtarı okumak derlemeyi durdurur ve bunun yerine neyin yazılacağını söyler. Bu ret, bir Recipe’in satır içi yazdığı şablonları kapsar; ‘$import’ ile sağlanan bir valuesMapping, workload veya artifacts girdisi yalnızca işleme ona ulaştığında çözümlenir, bu nedenle bunlardan birinin içindeki bir başvuru durdurmak yerine boş bir değer olarak işlenir. Bir bileşenin eklentisine bağlı bir FeatureRecipe’in şablonlarında bu, HOST bileşenin, host’un kendi sağlayıcısının bildirdiği adıdır — host’un kendi Recipe’inin okuduğu değer; tıpkı oradaki instance_id’nin host’un kimliği olması gibi — böylece bir eklenti bir kaynağı bundan yararlanarak host’unun adıyla adlandırır ve host’un platformunun kabul ettiği bir ad elde eder. Host’un sağlayıcısı ad bildirmediğinde boştur ve bunu eklentinin injectMapping dışındaki bir satır içi şablonundan okumak derlemeyi durdurur; orada bunun yerine ’{{ .context.instance_id }}’ okuyun. |
labels | string eşlemi | hayır | Geçerli düğümün duck-typing ve ontoloji etiketleri; topoloji oluşturma sırasında label-transform rolünde eklenmiş bir yönetişim plugin’inin yaptığı tüm değişiklikler dahil. |
annotations | object | hayır | Geçerli düğüm için kökene göre ayrılmış üç kademeli annotation kümesi. |
inject | object | evet | Önceden doldurulmuş ve araya girilmiş teslim hattı. Developer inject anahtarlarını Target provides değerlerine çözümleyen, derleyicinin ürettiği bir eşlem olarak başlar. injectMapping derin birleştirmeleriyle yerinde değiştirilir. Base Recipe işlendiğinde bu, tamamen çözümlenmiş fiziksel string’leri içerir. |
uses | enriched_edge eşlemi | evet | Zenginleştirilmiş topolojik kenar eşlemi. Developer’ın takma adına göre anahtarlanır (ör. ‘my_db’, ‘my_api’). Her girdi; hedef düğümün kimliğinin, çözümlenmiş provides değerlerinin, enjeksiyon eşlemesinin ve kademelenmiş annotation’larının ve o bağlantıda yazılan eklentilerin derleyici tarafından derlenmiş bir görünümüdür — ve readsTargetRenderFacts bildiren bir FeatureRecipe için, hedefin işlemelerinin bildirdiklerinin de. Bu ham IR kenarı DEĞİLDİR — derleyicinin özellikle şablon tüketimi için oluşturduğu zenginleştirilmiş bir izdüşümdür. Bu eşlem üzerinde dolaşan bir şablon bağlantıları yazıldıkları sırayla değil, anahtar sırasıyla — takma ada göre sıralanmış olarak — görür. |
self_inject | object | evet | Geliştiricinin, bileşenin kendi values ve provides değerlerinden hangilerine zaten bir teslim adı verdiği; bileşenin kendisi üzerine yazılmış inject: bloğundan okunur — .inject_raw’un yazıldığı gibi, .context.inject’in ise çözümlenmiş olarak tuttuğu blok. Bloğun adlandırdığı her mekanizma (env, file, arg ya da ssm_param gibi özel bir mekanizma), geliştiricinin yazdığı her adı o girdinin teslim ettiği kendi anahtarına eşler; tıpkı .context.uses. |
used_by | inbound_edge[] | hayır | Bunu kullanan bileşenler: başka bir bileşenin buna yaptığı her uses bağlantısı için bir girdi; bağlanan bileşenlerin yazıldığı sırayla, ardından her birinin kendi uses girdilerinin sırasıyla. İki kez bağlanan bir bileşen iki kez görünür. Yalnızca bileşene eklenmiş bir FeatureRecipe tarafından ve yalnızca eklentinin kendi kaynaklarını üreten şablonlarda — valuesMapping, workload ve artifacts — okunur. Bileşenin kendi Recipe şablonlarında, bir injectMapping’de ve bir pipeline adımının with ve when alanlarında yoktur; çünkü bunların her birinin çıktısı, bileşene kim bağlanırsa bağlansın aynı kalan, bileşenin kendi işlenmiş çıktısına düşebilir. Her girdi bir anahtar değil bir liste öğesidir; bu nedenle üzerinde dolaşan bir şablon çağıranlarla bu sırayla karşılaşır. |
render_facts | render_facts | hayır | Bu bileşeni işleyen sağlayıcının ürettiği çıktı hakkında bildirdikleri — bildirdiği işleme olguları — olgu adına göre anahtarlanmış olarak. Bir sağlayıcının hangi adları bildirdiği ve her girdinin ne içerdiği, o sağlayıcının kendi belgelenmiş sözleşmesidir. Her değer, tek girdili olsa bile bir listedir; böylece bir şablon her zaman onun üzerinde dolaşır; bileşenin işlenmesi birden fazla sağlayıcı çağrısı gerektirdiğinde ve bir ad bunların birkaçı tarafından bildirildiğinde, listeleri çağrıların çalıştığı sırayla tek listede birleştirilir. Bileşen işlendikten sonra, bileşene eklenmiş bir FeatureRecipe’in her şablonunda — valuesMapping, workload, artifacts ve pipeline adımlarının with ve when alanları — bulunur ve sağlayıcısı hiçbir şey bildirmediğinde boştur; böylece kimsenin bildirmediği bir ad boş liste olarak okunur. Bileşen işlenmeden önce çalışan bileşenin kendi Recipe şablonlarında ve bir injectMapping’de yoktur. |
Ek özelliklere izin verilmez.
template-context.context.annotations
Geçerli düğüm için kökene göre ayrılmış üç kademeli annotation kümesi.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
release | string eşlemi | hayır | Release sınırlarından kademelenen fiziksel topoloji string’leri. |
catalog | string eşlemi | hayır | Platform Mimarı tarafından Alan 2’de yazılan, değiştirilemez içsel özellikler. |
aggregate | string eşlemi | hayır | Aggregate alt sistemlerinden kademelenen bilişsel meta veriler. |
Ek özelliklere izin verilmez.
template-context.context.inject
Önceden doldurulmuş ve araya girilmiş teslim hattı. Developer inject anahtarlarını Target provides değerlerine çözümleyen, derleyicinin ürettiği bir eşlem olarak başlar. injectMapping derin birleştirmeleriyle yerinde değiştirilir. Base Recipe işlendiğinde bu, tamamen çözümlenmiş fiziksel string’leri içerir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
env | string eşlemi | hayır | Ortam değişkeni teslimi. Anahtarlar Developer’ın yerel değişken adları, değerler çözümlenmiş hedef string’lerdir. |
file | string eşlemi | hayır | Dosya bağlama teslimi. Anahtarlar yerel dosya yolları, değerler çözümlenmiş hedef string’lerdir. |
arg | string eşlemi | hayır | Komut satırı argümanı teslimi. Anahtarlar bayrak önekleri, değerler çözümlenmiş hedef string’lerdir. |
all | string eşlemi | hayır | env + file + arg + özel mekanizmaların önceden hesaplanmış düz birleşimi. uses-inject çözümlemesinden sonra doldurulur ve inject eşlemesinden sonra yeniden hesaplanır. Şablonlar evrensel serileştirme için {{ toJson .context.inject.all }} kullanır. |
template-context.context.self_inject
Geliştiricinin, bileşenin kendi values ve provides değerlerinden hangilerine zaten bir teslim adı verdiği; bileşenin kendisi üzerine yazılmış inject: bloğundan okunur — .inject_raw’un yazıldığı gibi, .context.inject’in ise çözümlenmiş olarak tuttuğu blok. Bloğun adlandırdığı her mekanizma (env, file, arg ya da ssm_param gibi özel bir mekanizma), geliştiricinin yazdığı her adı o girdinin teslim ettiği kendi anahtarına eşler; tıpkı .context.uses.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
env | string eşlemi | hayır | Ortam değişkeni teslimi: anahtarlar geliştiricinin değişken adlarıdır, değerler her girdinin teslim ettiği kendi anahtardır. |
file | string eşlemi | hayır | Dosya bağlama teslimi: anahtarlar geliştiricinin dosya yollarıdır, değerler her girdinin teslim ettiği kendi anahtardır. |
arg | string eşlemi | hayır | Komut satırı argümanı teslimi: anahtarlar geliştiricinin bayrak önekleridir, değerler her girdinin teslim ettiği kendi anahtardır. |
template-context.metadata
Belirlenimci adlandırma için genel kimlik sağlayan Release ve derleme meta verileri. Tüm şablon bloklarında kullanılabilir (valuesMapping, injectMapping, pipeline with).
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
release_name | string | hayır | Derlenmekte olan Release’in adı (ör. ‘prod-billing’). Ops tarafından genel olarak benzersiz bulut kaynak adları (S3 bucket’ları, IAM rolleri) oluşturmak için kullanılır. Ortamlar arasında benzersizliği sağlamak için .context.instance_id ile birleştirilir. |
release_version | string | hayır | Release’in anlamsal sürümü. |
environment | string | hayır | Release meta verisindeki ortam string’i (ör. ‘production’, ‘local’). |
aggregate_name | string | hayır | Derlenen kök Aggregate’in adı. |
Ek özelliklere izin verilmez.
template-context.inject
Yalnızca yazılmış bir inject bloğu taşıyan bir ek FeatureRecipe’si işlenirken doldurulur (ör. { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). uses kenarlarından gelen, temel bileşenin önceden doldurulmuş teslim hattı olan .context.inject’ten farklıdır. Yazılmış inject’i olmayan ekler ve temel Recipe’ler için null/yok olarak değerlendirilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
env | string eşlemi | hayır | Eke kapsamlı ortam değişkeni teslimi. |
file | string eşlemi | hayır | Eke kapsamlı dosya bağlama teslimi. |
arg | string eşlemi | hayır | Eke kapsamlı argüman teslimi. |
all | string eşlemi | hayır | Ekin tüm inject paradigmalarının derleyici tarafından üretilen kolaylık birleşimi. |
template-context.boundary
Sınır kapsamlı bağlam — yalnızca spec.executionScope değeri ‘boundary’ olan bir FeatureRecipe’nin sınır için bir kez çalıştırdığı bir şablon değerlendirilirken doldurulur. Component kapsamlı FeatureRecipes bu sütunu almaz; bunların yerine context.instance_id, context.inject, context.uses ve .workload sütunu bileşen başına veri taşır. Sınır kapsamlı bir FeatureRecipe’nin sınır için çalıştırılan şablonları, bu bileşen başına sütunların yerine .boundary.* alır; injectMapping’i ise ekin ulaştığı her bileşenin bağlamında çalışır, bu bileşen başına sütunları okur ve bu sütunu almaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path | string | hayır | FeatureRecipe’nin eklendiği Release sınırının yolu: en dıştan içe doğru sınır adları, ’/’ ile birleştirilmiş (örn. ‘bridge’, ‘bridge/frontend’). Sınırı adlandırır, çıktısının yazıldığı dizini değil; o dizini sınırın directory: alanı ayarlar. |
assembly_path | string | hayır | Bu ekin kendi çıktısının birleştirildiği, derlemenin çıktı dizinine göreli dizin: sınırının değerlendirilmiş directory: ve subDirectory: değerleri, yani derlemenin bu çıktıyı yönlendirdiği dizin (örn. ‘bridge/compose’). Bir bağlantı uç noktasının source_assembly_path ya da target_assembly_path değerine, ancak ve ancak o uç nokta aynı birleştirilmiş dosyaya işlendiğinde tam olarak eşittir; bu nedenle bir FeatureRecipe, kendi dosyası içindeki bir bağlantıyı başka bir dosyadakinden ayırmak için bunları karşılaştırır. Opak veri; çekirdek bunu yorumlamaz. |
boundary_name | string | hayır | Sınırın adı (release.spec.boundaries içindeki eşlem anahtarı). |
components | object | hayır | Sınırın alt ağacındaki her bileşen için instance_id’den bir girdiye eşlem (özyinelemeli, iç içe sınırlardaki bileşenleri de içerir). Her girdi, bileşenin çözümlenmiş tür URI’sini, örnek kimliğini ve bileşen başına provides değerlendirmesinden gelen sağlanan değerleri taşır. |
internal_uses_edges | object[] | hayır | Kaynağın VE hedefin her ikisinin de bu sınırın alt ağacında olduğu uses kenarları. |
outgoing_cross_boundary_uses_edges | object[] | hayır | Kaynağı bu sınırın alt ağacında, hedefi ise onun dışında olan uses kenarları. |
incoming_cross_boundary_uses_edges | object[] | hayır | Hedefin alt ağaçta, kaynağın dışarıda olduğu uses kenarları. İçeri kimin çağrı yaptığını bilmesi gereken ingress tarzı toplayıcılar tarafından kullanılır. |
cross_boundary_uses_edges | object[] | hayır | Giden ve gelen sınırlar arası kenarların kolaylık birleşimi. |
labels | string eşlemi | hayır | Alt ağaçtaki bileşenlerin etiketlerinin, yazar sırası korunarak birleşimi. |
annotations | string eşlemi | hayır | Kademelenme çözümlendikten sonra sınırın kendi ek açıklamaları. |
feature_attachments | template_attachment[] | hayır | Doğrudan bu sınıra eklenmiş ekler (sınır kapsamında ekler arası başvuru için), .features’ın taşıdığı ek biçiminin aynısıyla. |
Ek özelliklere izin verilmez.
Tanımlar
inbound_edge
Başka bir bileşenin, ekli bir FeatureRecipe’in render ettiği bileşene kurduğu tek bir bağlantı: kimin bağlandığı, hangi soket üzerinden bağlandığı, bağlanan bileşenin neyi yayımladığı ve yerleştirildiği namespace ile sınır. Her değer, derleyicinin yorumlamadan taşıdığı bir string’dir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
component_id | string | evet | Bağlanan bileşenin düzleştirilmiş örnek kimliği (ör. ‘frontend’ veya ‘data-layer.etl’) — bir subDirectory yol şablonunun .component_id olarak okuduğu değer; .context.uses. |
socket | string | evet | Bağlanan bileşenin bu bağlantıyı üzerinden kurduğu usesSchema kategorisi (ör. ‘databases’, ‘apis’). |
provides | string eşlemi | evet | Bağlanan bileşenin çözümlenmiş provides değerleri, Component’inin bildirdiği anahtarlarla daraltılmış olarak — o bileşenin bir tüketicisinin .context.uses. |
source_namespace | string | hayır | Bağlanan bileşenin yerleştirildiği namespace: bileşenin kendi render’ının aldığı aggrega.ai/namespace annotation’ı — sınırlarının annotation’ları, en son kendi Release girdisinin annotation’ları uygulanarak; böylece girdisi namespace’i ayarlayan veya temizleyen bir bileşen, sınırınınkini değil kendi ayarını taşır. Bu, boundary-scope bir FeatureRecipe’in .boundary uses-edge listelerinde aynı bağlantının girdisinde source_namespace olarak okuduğu değerdir. Bağlanan bileşene hiçbir namespace uygulanmadığında yoktur; yazdırmadan önce if veya with ile koruyun. |
source_boundary_path | string | hayır | Bağlanan bileşeni barındıran Release sınırının eğik çizgiyle ayrılmış yolu (ör. ‘edge’ veya ‘aws-prod/payments’) — boundary-scope bir FeatureRecipe’in .boundary uses-edge listelerinde aynı bağlantının girdisinde source_boundary_path olarak okuduğu değer. |
render_facts | render_facts | hayır | Bağlanan bileşenin render’larının ürettikleri çıktı hakkında bildirdikleri, olgu adına göre anahtarlanmış olarak: önce kendi provider çağrılarının bildirdiği olgular, ardından ona ekli olup onunla birlikte render edilen her Feature’ınkiler, render edildikleri sırayla; bir adın bunlardan birkaçından aldığı listeler bu sırayla tek listede birleştirilir. Her değer, tek girdili olsa bile bir listedir; bu nedenle bir şablon her zaman onun üzerinde range yapar. Yalnızca readsCallerRenderFacts bildiren bir FeatureRecipe için bulunur — bu FeatureRecipe’in ekleri her bileşen render edildikten sonra render edilir, böylece her çağıranın render’ı tamamlanmış olur — ve bu durumda her girdide bulunur; provider’ları hiçbir şey bildirmeyen bir çağıran için boştur. Diğer her FeatureRecipe için yoktur. |
Ek özelliklere izin verilmez.
render_facts
Ada göre anahtarlanmış render olguları: bir bileşeni render eden provider’ların ürettikleri çıktı hakkında bildirdikleri. Bir provider’ın hangi adları bildirdiği ve her girdinin ne içerdiği, o provider’ın kendi belgelenmiş sözleşmesidir; derleyici ikisi hakkında da her değerin bir liste olduğu dışında hiçbir şey öğrenmez. Bir liste girdilerinin sırasını korur. Bir nesne girdisi, anahtarları provider’ın yazdığı sırayla taşınır ve onun üzerinde range yapan bir şablon, bu bağlamdaki her anahtarlı eşlemde olduğu gibi anahtarlarla anahtar sırasında karşılaşır.
Serbest biçimli nesne; değerler any[] türündedir.
template_attachment
Bir şablonun okuduğu biçimiyle tek bir ek: ekli bir Feature’ın örnek başına görünümü. Her ek, ne ürettiğinden bağımsız olarak aynı alanları sunar; böylece .features.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
type | string | hayır | Ekli Feature’ın Catalog Feature URI’si. |
resolved_version | string | hayır | Ekli Feature’ın Manifest çözümlemesinden sonraki sürümü — bu derleme için fiilen bağlanan sürüm; .features. |
labels | string eşlemi | hayır | Ekli Feature’ın Catalog etiketleri, Feature’ın bildirdiği sırayla olduğu gibi taşınır — hiçbiri süzülmez, yeniden adlandırılmaz veya öneki kaldırılmaz; böylece bir şablon tam olarak Feature’ın yazarının yazdığını okur. Bir şablonun, ekli Feature’ın adına veya URI’sine göre değil, ne olduğuna göre dallanmasını sağlar. .context.uses.if ile koruyun veya eşlem üzerinde range yapın. |
values | object | hayır | Ekin kendi geliştirici niyeti sütunu, ek bildiriminden olduğu gibi taşınır. |
infra | object | hayır | Ekin kendi operasyonel boyutlandırma sütunu, ek bildiriminden olduğu gibi taşınır. |
provides | string eşlemi | hayır | Bu eke bağlanan FeatureRecipe’in çözümlenmiş genel sözleşmesi — üretilen kaynağın adı, anahtarı, bir kimlik ve üretilen ek anahtarlar — tüketiciye .features. |
Ek özelliklere izin verilmez.
enriched_edge
Derleyicinin oluşturduğu tek bir zenginleştirilmiş topolojik kenar. Hedefin çözümlenmiş kimliğini, provides değerlerini ve basamaklı açıklamalarını (annotations) içerir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
target | string | evet | Hedef düğümün mutlak düzleştirilmiş kimliği (ör. ‘data-layer.main-db’). |
socket | string | evet | Bu kenarın ait olduğu usesSchema kategorisi (ör. ‘databases’, ‘apis’). |
source | string | hayır | Kaynak (tüketici) düğümün mutlak düzleştirilmiş kimliği. Tüketici başına çıktıları tüketici düğüme göre anahtarlayan sınır kapsamlı görünümler için doldurulur. |
source_namespace | string | hayır | Kaynak uç noktasının ham aggrega.ai/namespace açıklaması (yoksa boş). source gibi yalnızca sınır kapsamlı görünümler için doldurulur; bir bileşenin kendi .context.uses girdisi bunu boş taşır. Bir provider’ın ağ kimliği çözümlemesi için opak veridir; çekirdek bunu yorumlamaz. |
source_boundary_path | string | hayır | Kaynak uç noktasının sınır yolu: onu barındıran Release sınırının eğik çizgilerle ayrılmış yolu (örn. ‘bridge/frontend’). source gibi yalnızca sınır kapsamlı görünümler için doldurulur; bir bileşenin kendi .context.uses girdisi bunu boş taşır. |
source_assembly_path | string | hayır | Kaynak uç noktasının birleştirme yolu: derlemenin çıktı dizinine göreli, çıktısının birleştirildiği dizin; sınırının değerlendirilmiş directory: ve subDirectory: değerlerinden oluşur (örn. ‘bridge/compose’). Aynı birleştirme yoluna sahip iki uç nokta tek bir birleştirilmiş dosyaya işlenir ve birleştirme yolu .boundary.assembly_path değerine eşit olan bir uç nokta, onu okuyan FeatureRecipe’nin kendi çıktısının birleştirildiği dosyaya işlenir. Uç noktaları ağlara yerleştiren sınır kapsamlı bir FeatureRecipe, hiçbir aggrega.ai/namespace uygulanmadığında bunu kaynak uç noktasının ağı olarak okuyabilir. source gibi yalnızca sınır kapsamlı görünümler için doldurulur; bir bileşenin kendi .context.uses girdisi bunu boş taşır. Opak veri; çekirdek bunu yorumlamaz. |
target_namespace | string | hayır | Hedef uç noktasının ham aggrega.ai/namespace açıklaması (yoksa boş). source gibi yalnızca sınır kapsamlı görünümler için doldurulur; bir bileşenin kendi .context.uses girdisi bunu boş taşır. Bir provider’ın ağ kimliği çözümlemesi için opak veridir. |
target_boundary_path | string | hayır | Hedef uç noktasının sınır yolu: onu barındıran Release sınırının eğik çizgilerle ayrılmış yolu (örn. ‘bridge/backend’). source gibi yalnızca sınır kapsamlı görünümler için doldurulur; bir bileşenin kendi .context.uses girdisi bunu boş taşır. |
target_assembly_path | string | hayır | Hedef uç noktasının birleştirme yolu: derlemenin çıktı dizinine göreli, çıktısının birleştirildiği dizin; sınırının değerlendirilmiş directory: ve subDirectory: değerlerinden oluşur (örn. ‘bridge/compose’). Birleştirme yolu .boundary.assembly_path değerine eşit olan bir uç nokta, onu okuyan FeatureRecipe’nin kendi çıktısının birleştirildiği dosyaya işlenir. Uç noktaları ağlara yerleştiren sınır kapsamlı bir FeatureRecipe, hiçbir aggrega.ai/namespace uygulanmadığında bunu hedef uç noktasının ağı olarak okuyabilir. source gibi yalnızca sınır kapsamlı görünümler için doldurulur; bir bileşenin kendi .context.uses girdisi bunu boş taşır. Opak veri; çekirdek bunu yorumlamaz. |
provides | string eşlemi | evet | Hedef düğümün tamamen çözümlenmiş provides sözlüğü. inject doldurulmasından önce, provides değerlendirmesi sırasında değerlendirilir. |
inject | object | evet | Geliştiricinin bu kenar için yazdığı özgün inject eşlemi (anahtarlar = yerel değişken adları, değerler = hedefin provides anahtarları). Bu, çözümlenmiş değerler değil HAM eşlemdir. |
labels | string eşlemi | hayır | Hedef düğümün duck-typing ve ontoloji etiketleri (topoloji oluşturmadaki değişiklik sonrası). |
annotations | object | hayır | Hedef düğümün üç basamaklı açıklama kümesi. |
component | string | hayır | Hedef düğümün Catalog bileşen türü URI’si (ör. ‘core/postgres’). |
resolved_version | string | hayır | Hedef düğümün çözümlenmiş SemVer sürümü. |
boundary_path | string | hayır | Hedef düğümün Release’ten gelen fiziksel uzamsal hiyerarşisi (ör. ‘aws-eks-cluster/backend-ns’). |
origin_feature | string | hayır | Bu kenar bir Feature tarafından kendiliğinden bildirildiyse (feature.aggrega.ai/kind: secret etiketli kimlik bilgisi Features dahil), Feature örneğinin adı. Geliştiricinin bildirdiği kenarlar için null/yok. |
origin_release | boolean | hayır | Bu bağlantıyı Aggregate bildirmek yerine Release bağladığında true. Aggregate’in bildirdiği bir bağlantı için yoktur. |
values | object | hayır | Bu bağlantı için Aggregate’in uses girdisinde yazılan, bağlantı başına geliştirici yapılandırması; olduğu gibi taşınır. Bağlantı hiçbirini taşımadığında yoktur. Yalnızca tüketen düğümün bağlamına ulaşır, hedefinkine asla. |
infra | object | hayır | Bu bağlantı için Release’in uses girdisinde yazılan, bağlantı başına operasyonel yapılandırma; olduğu gibi taşınır. Bağlantı hiçbirini taşımadığında yoktur. Yalnızca tüketen düğümün bağlamına ulaşır, hedefinkine asla. |
features | template_attachment eşlemi | hayır | Bu bağlantıya yazılan eklentiler; her biri, bağlantının soketinin onun için bildirdiği yuva adına göre anahtarlanır ve .features’ın taşıdığı eklenti biçimindedir: türü, çözümlenmiş sürümü, etiketleri, values, infra ve ona bağlı FeatureRecipe’nin çözümlenmiş provides değerleri. Bir Recipe, bir bağlantının kimlik bilgisini .context.uses. |
render_facts | render_facts | hayır | Hedefin render işlemlerinin ürettikleri çıktı hakkında bildirdikleri, olgu adına göre anahtarlanmış olarak ve bir çağıranın .context.used_by üzerindeki girdisinin taşıdığı biçimde: kendi provider çağrılarının bildirdiği olgular, ardından ona eklenip onunla birlikte render edilen her Feature’ın olguları, render edildikleri sırayla; bir adın bunların birkaçından aldığı listeler bu sırayla tek listede birleştirilir. Tek girdisi olsa bile her değer bir listedir; böylece bir şablon her zaman onun üzerinde dolaşır. Yalnızca readsTargetRenderFacts bildiren bir FeatureRecipe için .context.uses üzerinde bulunur (bu FeatureRecipe’nin eklentileri her bileşen render edildikten sonra render edilir, böylece her hedefin render işlemi tamamlanmış olur) ve o durumda her girdide bulunur; provider’ları hiçbir şey bildirmeyen bir hedef için boştur. Diğer her FeatureRecipe’de, bir pipeline adımının with ve when alanlarında, bileşenin kendi Recipe şablonlarında ve sınır kapsamlı bir FeatureRecipe’nin okuduğu kenar listelerinde yoktur. |
Ek özelliklere izin verilmez.
enriched_edge.inject
Geliştiricinin bu kenar için yazdığı özgün inject eşlemi (anahtarlar = yerel değişken adları, değerler = hedefin provides anahtarları). Bu, çözümlenmiş değerler değil HAM eşlemdir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
env | string eşlemi | hayır | Ortam değişkeni ile teslim: anahtarlar tüketicinin yerel değişken adlarıdır, değerler hedefin provides anahtarlarıdır. |
file | string eşlemi | hayır | Dosya bağlama ile teslim: anahtarlar tüketicinin yerel dosya yollarıdır, değerler hedefin provides anahtarlarıdır. |
arg | string eşlemi | hayır | Komut satırı argümanı ile teslim: anahtarlar tüketicinin bayrak önekleridir, değerler hedefin provides anahtarlarıdır. |
enriched_edge.annotations
Hedef düğümün üç basamaklı açıklama kümesi.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
release | string eşlemi | hayır | Hedef düğümün Release sınırlarından gelen fiziksel topoloji string’leri. |
catalog | string eşlemi | hayır | Hedef düğümün Catalog varlığından gelen değişmez özellikler. |
aggregate | string eşlemi | hayır | Hedef düğümün Aggregate alt sistemlerinden gelen bilişsel meta veriler. |
Ek özelliklere izin verilmez.