İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

ÖzellikTürZorunluAçıklama
contextobjectevetDerleyicinin oluşturduğu, kimlik, topoloji ve teslim verilerini sağlayan yürütme bağlamı.
valuesobjectevetBu 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.
infraobjectevetBu düğüm için Release’ten enjekte edilen fiziksel boyutlandırma yükü. Geliştiriciyi tamamen atlar.
localsstring eşlemievetRecipe’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.’ başvurusu derlemeyi durdurur. Denetim tuş vuruşlarını değil, bir başvurunun ÇÖZÜMLENDİĞİ yolu okur; böylece doğrudan biçimi, bir ’{{ with .locals }}’ bloğu içindeki okumayı, doğrudan ‘.locals’a bağlanmış bir değişken üzerinden okumayı ve parantez içindeki bloktan okunan bir anahtarı, yani ‘(.locals).’ veya ’($.locals).’ biçimini aynı şekilde kapsar. Kapsamadığı tek bir yazım vardır: yolunu şablon metninin belirlemediği bir başvuru (bir fonksiyon üzerinden, örneğin ‘index .locals’ veya ‘(default dict .locals).’ ile, ya da ardışık düzeni böyle bir fonksiyon uygulayan bir ‘with’ bloğu veya değişken bağlaması üzerinden ulaşılan). Böyle bir başvuru analiz edilmez ve bu yoldan ulaşılan eksik bir anahtar derlemeyi durdurmaz: hiçbir şey yerine '' metnini olduğu gibi işler. Tek istisna ‘index’in kendisidir: her şablon yüzeyinde, okuduğu eşlem istenen anahtarı içermediğinde anahtarı belirterek derlemeyi durdurur; bu nedenle ‘index .locals’ üzerinden ulaşılan eksik bir anahtar derlemeyi durdurur. Bir locals girdisi ‘.provides’ı okuyamaz. provides (ön bölümden sonra, provides değerlendirmesinde), source, valuesMapping, workload, artifacts, assertions içinde ve pipeline[].with (ve pipeline[].when) aracılığıyla aşağı akıştaki Wasm eklentilerinde kullanılabilir. Çağıranlara asla açılmaz.
providesstring eşlemihayırRecipe’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.
featurestemplate_attachment eşlemihayırBu 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..features. konumunda okunur; böylece bu sütunu dolaşan bir şablon yalnızca düğümün kendi ekleriyle karşılaşır.
metadataobjecthayırBelirlenimci 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_namestringhayırYalnı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 }}’.
injectobjecthayırYalnı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_rawobject veya nullhayırinject 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.
stepsobject eşlemihayırArdışı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.
sourcestring veya object veya nullhayı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ı).
workloadworkload-v1beta1.schema.json veya nullhayırBu 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.
boundaryobjecthayırSı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ı.

ÖzellikTürZorunluAçıklama
instance_idstringevetGeç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_namestringhayırBu 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.
labelsstring eşlemihayırGeç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.
annotationsobjecthayırGeçerli düğüm için kökene göre ayrılmış üç kademeli annotation kümesi.
injectobjectevetÖ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.
usesenriched_edge eşlemievetZenginleş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_injectobjectevetGeliş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..inject’in bir bağlantının adlarını okudukları anahtarlara eşlemesi gibi: from: ile yazılmış bir girdi için ‘provides.’; value: şablonu bileşenin kendi values değerlerinden tam olarak birini okuyan ve başka hiçbir şeyi okumayan bir girdi için ‘values.’ — burada , okumayı hangi metin ya da işlevler çevrelerse çevrelesin ve okuma değerin ne kadar derinine inerse insin, o değerin en üst düzey anahtarıdır; ’{{ .values.config.port }}’, ’{{ index .values.config “port” }}’ ve ’{{ (default dict .values.config).port }}’ hepsi ‘values.config’ değerine eşlenir; diğer her girdi için ise boş bir dize — bir sabit değer, iki değer okuyan bir şablon, values dışında herhangi bir şey okuyan bir şablon ya da values okumasını metnin tek bir en üst düzey anahtara bağlamadığı bir şablon; örneğin ’{{ index .values “role” }}’, values’un bütün olarak okunması ya da bağlamın tamamının bir işleve verilmesi. Dolayısıyla kendi değerini varsayılan bir ad altında teslim eden bir Recipe, bir girdinin zaten ‘values.’ değerine eşlenip eşlenmediğini sınar ve eşlenmişse kendi varsayılan adını atlar; ör. {{ range $name, $key := .context.self_inject.env }}{{ if eq $key “values.role” }}…{{ end }}{{ end }}. Geliştirici hiçbir blok yazmadığında mevcuttur ve boştur; bir mekanizma yalnızca blok onu adlandırdığında görünür ve bir şablon, adları nasıl okursa okusun sıralanmış olarak karşılar. Asla çözümlenmiş bir değerden değil, geliştiricinin yazdığı metinden okunur.
used_byinbound_edge[]hayırBunu 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_factsrender_factshayırBu 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.

ÖzellikTürZorunluAçıklama
releasestring eşlemihayırRelease sınırlarından kademelenen fiziksel topoloji string’leri.
catalogstring eşlemihayırPlatform Mimarı tarafından Alan 2’de yazılan, değiştirilemez içsel özellikler.
aggregatestring eşlemihayırAggregate 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.

ÖzellikTürZorunluAçıklama
envstring eşlemihayırOrtam değişkeni teslimi. Anahtarlar Developer’ın yerel değişken adları, değerler çözümlenmiş hedef string’lerdir.
filestring eşlemihayırDosya bağlama teslimi. Anahtarlar yerel dosya yolları, değerler çözümlenmiş hedef string’lerdir.
argstring eşlemihayırKomut satırı argümanı teslimi. Anahtarlar bayrak önekleri, değerler çözümlenmiş hedef string’lerdir.
allstring eşlemihayırenv + 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..inject’in bir bağlantının adlarını okudukları anahtarlara eşlemesi gibi: from: ile yazılmış bir girdi için ‘provides.’; value: şablonu bileşenin kendi values değerlerinden tam olarak birini okuyan ve başka hiçbir şeyi okumayan bir girdi için ‘values.’ — burada , okumayı hangi metin ya da işlevler çevrelerse çevrelesin ve okuma değerin ne kadar derinine inerse insin, o değerin en üst düzey anahtarıdır; ’{{ .values.config.port }}’, ’{{ index .values.config “port” }}’ ve ’{{ (default dict .values.config).port }}’ hepsi ‘values.config’ değerine eşlenir; diğer her girdi için ise boş bir dize — bir sabit değer, iki değer okuyan bir şablon, values dışında herhangi bir şey okuyan bir şablon ya da values okumasını metnin tek bir en üst düzey anahtara bağlamadığı bir şablon; örneğin ’{{ index .values “role” }}’, values’un bütün olarak okunması ya da bağlamın tamamının bir işleve verilmesi. Dolayısıyla kendi değerini varsayılan bir ad altında teslim eden bir Recipe, bir girdinin zaten ‘values.’ değerine eşlenip eşlenmediğini sınar ve eşlenmişse kendi varsayılan adını atlar; ör. {{ range $name, $key := .context.self_inject.env }}{{ if eq $key “values.role” }}…{{ end }}{{ end }}. Geliştirici hiçbir blok yazmadığında mevcuttur ve boştur; bir mekanizma yalnızca blok onu adlandırdığında görünür ve bir şablon, adları nasıl okursa okusun sıralanmış olarak karşılar. Asla çözümlenmiş bir değerden değil, geliştiricinin yazdığı metinden okunur.

ÖzellikTürZorunluAçıklama
envstring eşlemihayırOrtam değişkeni teslimi: anahtarlar geliştiricinin değişken adlarıdır, değerler her girdinin teslim ettiği kendi anahtardır.
filestring eşlemihayırDosya bağlama teslimi: anahtarlar geliştiricinin dosya yollarıdır, değerler her girdinin teslim ettiği kendi anahtardır.
argstring eşlemihayırKomut 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).

ÖzellikTürZorunluAçıklama
release_namestringhayırDerlenmekte 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_versionstringhayırRelease’in anlamsal sürümü.
environmentstringhayırRelease meta verisindeki ortam string’i (ör. ‘production’, ‘local’).
aggregate_namestringhayırDerlenen 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.

ÖzellikTürZorunluAçıklama
envstring eşlemihayırEke kapsamlı ortam değişkeni teslimi.
filestring eşlemihayırEke kapsamlı dosya bağlama teslimi.
argstring eşlemihayırEke kapsamlı argüman teslimi.
allstring eşlemihayırEkin 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.

ÖzellikTürZorunluAçıklama
pathstringhayırFeatureRecipe’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_pathstringhayırBu 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_namestringhayırSınırın adı (release.spec.boundaries içindeki eşlem anahtarı).
componentsobjecthayırSı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_edgesobject[]hayırKaynağın VE hedefin her ikisinin de bu sınırın alt ağacında olduğu uses kenarları.
outgoing_cross_boundary_uses_edgesobject[]hayırKaynağı bu sınırın alt ağacında, hedefi ise onun dışında olan uses kenarları.
incoming_cross_boundary_uses_edgesobject[]hayırHedefin 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_edgesobject[]hayırGiden ve gelen sınırlar arası kenarların kolaylık birleşimi.
labelsstring eşlemihayırAlt ağaçtaki bileşenlerin etiketlerinin, yazar sırası korunarak birleşimi.
annotationsstring eşlemihayırKademelenme çözümlendikten sonra sınırın kendi ek açıklamaları.
feature_attachmentstemplate_attachment[]hayırDoğ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.

ÖzellikTürZorunluAçıklama
component_idstringevetBağ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..target bir bağlantının diğer ucunu nasıl yazıyorsa o biçimde yazılır.
socketstringevetBağlanan bileşenin bu bağlantıyı üzerinden kurduğu usesSchema kategorisi (ör. ‘databases’, ‘apis’).
providesstring eşlemievetBağlanan bileşenin çözümlenmiş provides değerleri, Component’inin bildirdiği anahtarlarla daraltılmış olarak — o bileşenin bir tüketicisinin .context.uses..provides konumunda okuduğu değerlerin aynısı. Hiçbir şey yayımlamadığında boştur.
source_namespacestringhayırBağ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_pathstringhayırBağ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_factsrender_factshayırBağ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., o ad varlığın bildirdiği bir yuva da olsa serbest bir ek de olsa aynı şekilde okunur.

ÖzellikTürZorunluAçıklama
typestringhayırEkli Feature’ın Catalog Feature URI’si.
resolved_versionstringhayırEkli Feature’ın Manifest çözümlemesinden sonraki sürümü — bu derleme için fiilen bağlanan sürüm; .features..resolved_version olarak okunur. .context.uses..resolved_version ile aynıdır; böylece bir ek ve bir kenar bağlanan sürümü aynı şekilde bildirir. Ekin türü hiçbir Catalog varlığına çözümlenmediğinde boştur.
labelsstring eşlemihayırEkli 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..labels ile aynıdır. Feature hiçbir etiket bildirmediğinde ve ekin türü hiçbir Catalog varlığına çözümlenmediğinde anahtar tamamen yoktur; bu nedenle tek bir etikete erişmeden önce if ile koruyun veya eşlem üzerinde range yapın.
valuesobjecthayırEkin kendi geliştirici niyeti sütunu, ek bildiriminden olduğu gibi taşınır.
infraobjecthayırEkin kendi operasyonel boyutlandırma sütunu, ek bildiriminden olduğu gibi taşınır.
providesstring eşlemihayırBu 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..provides. olarak sunulur. Tüketici, ekin fiziksel kimliğini yeniden türetmek yerine bu değerleri okur. Bağlı FeatureRecipe’i hiçbir şey yayımlamayan bir ek, boş bir eşlem yerine hiç provides anahtarı taşımaz; bu nedenle bir şablon tek bir anahtara erişmeden önce koruma uygular.

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.

ÖzellikTürZorunluAçıklama
targetstringevetHedef düğümün mutlak düzleştirilmiş kimliği (ör. ‘data-layer.main-db’).
socketstringevetBu kenarın ait olduğu usesSchema kategorisi (ör. ‘databases’, ‘apis’).
sourcestringhayırKaynak (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_namespacestringhayırKaynak 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_pathstringhayırKaynak 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_pathstringhayırKaynak 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_namespacestringhayırHedef 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_pathstringhayırHedef 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_pathstringhayırHedef 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.
providesstring eşlemievetHedef düğümün tamamen çözümlenmiş provides sözlüğü. inject doldurulmasından önce, provides değerlendirmesi sırasında değerlendirilir.
injectobjectevetGeliş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.
labelsstring eşlemihayırHedef düğümün duck-typing ve ontoloji etiketleri (topoloji oluşturmadaki değişiklik sonrası).
annotationsobjecthayırHedef düğümün üç basamaklı açıklama kümesi.
componentstringhayırHedef düğümün Catalog bileşen türü URI’si (ör. ‘core/postgres’).
resolved_versionstringhayırHedef düğümün çözümlenmiş SemVer sürümü.
boundary_pathstringhayırHedef düğümün Release’ten gelen fiziksel uzamsal hiyerarşisi (ör. ‘aws-eks-cluster/backend-ns’).
origin_featurestringhayırBu 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_releasebooleanhayırBu bağlantıyı Aggregate bildirmek yerine Release bağladığında true. Aggregate’in bildirdiği bir bağlantı için yoktur.
valuesobjecthayırBu 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.
infraobjecthayırBu 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.
featurestemplate_attachment eşlemihayırBu 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..features..provides. olarak okur; böylece birden çok hedefe ulaşan bir tüketici her hedefin kendi kimlik bilgisini okur. Bu eklentiler hiçbir zaman tüketen düğümün kendi .features’ının parçası değildir; bu nedenle düğümün eklentilerini türe göre bulmak için .features üzerinde dolaşan bir şablon bir bağlantınınkilerle karşılaşmaz. Bir şablonda dolaşıldığında yuvalar anahtar sırasıyla gelir. Bağlantı hiçbirini taşımadığında yoktur.
render_factsrender_factshayırHedefin 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.

ÖzellikTürZorunluAçıklama
envstring eşlemihayırOrtam değişkeni ile teslim: anahtarlar tüketicinin yerel değişken adlarıdır, değerler hedefin provides anahtarlarıdır.
filestring eşlemihayırDosya bağlama ile teslim: anahtarlar tüketicinin yerel dosya yollarıdır, değerler hedefin provides anahtarlarıdır.
argstring eşlemihayırKomut 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.

ÖzellikTürZorunluAçıklama
releasestring eşlemihayırHedef düğümün Release sınırlarından gelen fiziksel topoloji string’leri.
catalogstring eşlemihayırHedef düğümün Catalog varlığından gelen değişmez özellikler.
aggregatestring eşlemihayırHedef düğümün Aggregate alt sistemlerinden gelen bilişsel meta veriler.

Ek özelliklere izin verilmez.