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

Aggrega Wasm Provider render soketi şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/wasm-provider-v1beta1.schema.json

Bir Provider render plugin soketinin tükettiği ve ürettiği aktarım biçimleri. Bir Provider konuğu, render_node dışa aktarımında bir IR düğümünü çıktı dosyalarına render eder (RenderNodeInput’tan RenderNodeOutput’a) ve isteğe bağlı olarak, assemble_boundary dışa aktarımında bir sınırdaki düğüm başına çıktıları tek bir birleştirilmiş yapıta birleştirir (AssembleBoundaryInput’tan AssembleBoundaryOutput’a). AssembleBoundaryOutput, birleştirilmiş dosyaları ve varsa tanılamaları taşır; her katkıda bulunanın dosyalarının nerede durduğu bu yanıtta değil, konuğun describe() sözleşmesinde bir kez bildirilir. Bir konuk ayrıca, render dağıtımından önce bir düğümün çözümlenmiş girdisini yapısal olarak denetleyen isteğe bağlı bir validate_node_input dışa aktarımı bildirebilir: bu dışa aktarım, render_node’un aldığı RenderNodeInput izdüşümünün aynısını tüketir ve yalnızca tanılamaları taşıyan bir ValidateNodeOutput döndürür; halt önem derecesindeki bir tanılama derlemeyi açıkça durdurur, warn önem derecesindeki bir tanılama ise derleme sonucunda görünür. Hedefi kabul ettiği adları sınırlayan veya kısıtlayan bir konuk, isteğe bağlı bir name_bound dışa aktarımı da bildirebilir; ana makine, bir düğümün component kimliğini belirlemeden önce buna danışır: bu dışa aktarım, önerilen tek bir adı taşıyan bir NameBoundInput tüketir ve konuğun bundan türeteceği her ad türü için bir karar taşıyan bir NameBoundOutput döndürür. Bir karar bir kısıt taşır (kullanılabilir ya da daha kısa bir uzunlukla sınırlı) ve hiçbir zaman konuğun oluşturduğu bir adı taşımaz; böylece hedefin neyi kabul ettiğine ilişkin bilgi konukta kalır. Bundan ayrı olarak, hedefi render ettiği kaynaklar için kendine ait bir ad türeten bir konuk (yazarın sağladığı kaynaktan ya da sentezlediği bir workload’dan), isteğe bağlı bir rendered_name dışa aktarımı bildirebilir; ana makine buna, bir Recipe yazarının bu adı okuyup ondan oluşturulmuş bir adres yayımlayabilmesi için danışır: bu dışa aktarım, hedefin türetmede dayandığı kimlikleri ve düğümün Recipe’sinin bildirdiği girdi türlerini taşıyan bir RenderedNameInput tüketir ve konuğun kendisinin altında render edeceği adı, ya da hiçbir ad türetmediği yerde ad olmadığını taşıyan bir RenderedNameOutput döndürür. Bu iki dışa aktarım tek bir konunun karşıt yönleridir ve hiçbiri diğerinin yerini tutmaz: name_bound konuktan ana makinenin önerdiği bir adı değerlendirmesini ister, rendered_name ise konuğun oluşturduğu ve ana makinenin okumadan taşıdığı bir adı bildirir. Bir konuk ayrıca, kendi çıktısını bir pipeline adımı için adreslenebilir birimlere bölen ve yamalanmış birimleri geri birleştiren carve ve reassemble ile uçları farklı dağıtım gruplarına birleştirilen bir uses kenarını bağlayan link_publish ve link_resolve dışa aktarımlarını da bildirebilir. Her yükün biçimi, dışa aktarımının adlandırdığı tanımdır: x-aggrega-exports tablosu, ana makinenin bir konuğu çağırdığı her dışa aktarımı (carve ve reassemble dahil) girdisinin tanımına ve çıktısının tanımına eşler; her biri bu belgenin $defs’ine işaret eden bir JSON Pointer’dır, dolayısıyla bir yükü doğrulayan bir araç tanımını orada arar. Belge kökü kendine ait bir biçim bildirmez, çünkü tek bir belge birden çok dışa aktarımın geçerli yükü olabilir (boş bir nesne validate_node_input, name_bound ve rendered_name için aynı şekilde geçerli bir yanıttır). Konuk her çıktı dosyasının serileştirilmiş baytlarını döndürür; ana makine bunları olduğu gibi yazar ve hiçbir serileştirici çalıştırmaz, dolayısıyla belirlenimcilik konuğun sorumluluğundadır: aynı girdi aynı baytları üretmelidir. Go, Rust ve TypeScript yük türleri bu şemadan plugin-ABI paketlerine üretilir; böylece üç dil tek bir aktarım biçimini okur ve yazar; bir konuk bunları bu paketlerden ya da kit bunları yeniden dışa aktarıyorsa eklenti kiti üzerinden içe aktarır.

Dışa aktarımlar

Şemanın x-aggrega-exports tablosu, ana makinenin bir konuğu çağırdığı her dışa aktarımı girdisinin tanımına ve çıktısının tanımına eşler. Bir yükün biçimi, dışa aktarımının adlandırdığı tanımdır.

Dışa aktarımGirdiÇıktı
render_nodeRenderNodeInputRenderNodeOutput
validate_node_inputRenderNodeInputValidateNodeOutput
assemble_boundaryAssembleBoundaryInputAssembleBoundaryOutput
carveCarveInputCarveOutput
reassembleReassembleInputReassembleOutput
name_boundNameBoundInputNameBoundOutput
rendered_nameRenderedNameInputRenderedNameOutput
link_publishLinkPublishInputLinkPublishOutput
link_resolveLinkResolveInputLinkResolveOutput

Tanımlar

RenderNodeInput

Bir Provider konuğunun render_node dışa aktarımında aldığı yük: konuğun işlediği düğüm başına IR izdüşümü, işleme zamanı bağlamı, düğümün bağlı Recipe’inin bildirdiği önceden değerlendirilmiş girdiler (edinilmiş kaynak listesi, bir iş yükü, bir yapıt kümesi; her biri yalnızca o Recipe onu bildirdiğinde bulunur) ve konuğun bir kaynak işlemesinin dışında bıraktığı işlenmiş birimleri adlandıran girdiler.

ÖzellikTürZorunluAçıklama
nodeIRNodeProjectionevetBir Provider konuğunun işlediği düğüm başına IR verisi: tam IR düğümünün, düğüm başına kimliği ve konuğun yayımlanan her manifeste damgaladığı kökeni taşıyan sınırlı bir izdüşümü. Bunlar şunlardır: kimliği, türü, çözümlenmiş recipe, değerler, bu değerleri bir değer eşlemesinin üretip üretmediği, feature ekleri, işlenmiş anahtarları ve değerlerin bütünü üzerindeki hassasiyet işaretlemesi, giden uses kenarları, sınır yolu, eşitleme dalgası, Recipe kimliği, component-id geçersiz kılması, türetilmiş ad temeli ve derleme kökeni. Kimlik ve türetilmiş ad temeli iki ayrı taşınan veridir, çünkü iki soruyu yanıtlarlar: bir kaynağın neye ait olduğu ve bir yazarın kendi kaynağının neye göre işlendiği. Yazarının yazdığı kaynağı teslim eden bir Feature eki, iki yanıtın ayrıştığı yerdir. Kaynak dosya içeriği burada taşınmaz; kaynak izdüşümünde ayrı olarak iletilir. Buradaki her anahtar kümesinin sabit bir sırası vardır (features ve uses yazar sırasıyla, değerler ve hassasiyet işaretlemesi sıralı anahtar sırasıyla), böylece aktarım yükü özdeş girdinin çalıştırmaları arasında bayt bayt aynıdır.
contextobjectevetAna makinenin konuğa verdiği, JSON belgesinin baytları olarak taşınan render zamanı bağlamı; bu şema nesneyi bildirmeden bırakır. Aynı düğümün bir pipeline adımının aldığı bağlamdır, artı girinti genişliği: parameters, yani ada göre sıralanmış Release parametre değerleri, hiç yoksa bulunmaz; annotations, yani düğümün ek açıklamaları, her birinin yazıldığı yere göre aggregate, release ve catalog olarak ayrılmış, boş olduğunda her biri bulunmaz; boundary, yani düğümün içinde bulunduğu sınır: name, path (kesimleri), sync_wave (0 olduğunda bulunmaz), directory, sub_directory (yoksa bulunmaz) ve annotations (Release’in sınırlarının düğüme kademeli olarak aktardığı küme; kendi Release girdisininki en son katmanlanır; boşsa bulunmaz); ve yaml_indent, yani konuğun çıktısını serileştirdiği render genelindeki girinti genişliği. Ana makine bileşeni olmayan sınır kapsamlı bir FeatureRecipe’in render’ı, pipeline adımının aldığı bağlamı artı yaml_indent’i alır: parameters; yalnızca release kovasını, yani sınırın kendi ek açıklama kümesini taşıyan annotations; ve name, path ile aynı kümeyi annotations olarak taşıyan bir boundary. İyi bilinen aggrega.ai/* ek açıklamaları, üzerine release kovası yazılmış aggregate kovasından okunur, bu nedenle her ikisinin de taşıdığı bir anahtar Release’in değerini alır; standart kitaplık provider’ı bunları bu katmanlı kümeden okur ve catalog kovasından hiçbir zaman okumaz, böylece bir katalog değeri bunlardan hiçbirini belirlemez ve bağlamı aggregate kovası taşımayan sınır kapsamlı bir FeatureRecipe herhangi bir bileşenin değerlerine göre değil, sınırının değerlerine göre render edilir.
source_listingSourceListinghayırAna makinenin kaynaklı bir provider için konuğa verdiği edinilmiş kaynağın genel dökümü: kaynak kökü, bu kökün bir dizin olup olmadığı ve altındaki köke göreli sıralı girdiler. Ana makine burada hiçbir dosya içeriği okumaz; yalnızca adları listeler. Konuk, liste üzerinde kendi çözümleme mantığını uygular ve seçtiği bir kümeyi pack-source ana makine işlevi aracılığıyla paketlemesini ana makineden ister; böylece provider’a özgü tüm kaynak çözümleme zekâsı konukta bulunur. Kaynaklı provider’lar için bulunur; aksi halde yoktur.
workload_projectionWorkloadProjectionhayırAna makinenin, provider’a özgü manifestleri sentezlemesi için konuğa verdiği önceden değerlendirilmiş iş yükü; bağlı Recipe bir chart kaynağı yerine bir iş yükü bildirdiğinde bulunur, aksi halde yoktur.
artifacts_projectionArtifactsProjectionhayırAna makinenin, düğümün çıktısına yerleştirmesi için konuğa verdiği önceden değerlendirilmiş yapıt kümesi; bağlı Recipe yapıtlar bildirdiğinde bulunur. Ana makine her girdinin kaynağını zaten okumuş, onu işleme bağlamına karşı bir Go şablonu olarak değerlendirmiş ve derleme kökeni anahtar kümelerini hesaplamıştır; çıktı biçimine, köken yerleşimine, disk üzerindeki yola ve son baytlara konuk karar verir. Düğüm hiçbir yapıt bildirmediğinde yoktur.
omitsOmitEntry[]hayırKonuğun bu düğümün çıktısının dışında bıraktığı işlenmiş birimleri adlandıran girdiler, yazarın bildirdiği sırayla. Her girdi çözümlenmiş olarak gelir, alanları düz dizelerdir ve bu derlemeye uygulanmayan bir girdi taşınmaz. Bir girdinin kind, name, namespace ve subchart değerlerinin neyi seçtiği bu soketin değil, bu provider’ın kendi belgelenmiş sözleşmesidir: konuk her girdiyi kendi biçiminin terimleriyle işlediği şeye karşı eşleştirir, bir girdinin eşleştiği her birimi döndürdüğü her şeyin (dosyaları, derived_keys içinde bildirdiği adlar ve render_facts içinde bildirdiği olgular) dışında bırakır ve çıktının omitted alanında her girdinin kaç birimle eşleştiğini bildirir. Girdiler yalnızca bir kaynak listesine eşlik eder, başka hiçbir girdiye eşlik etmez: sentezlenmiş bir iş yükünün veya bir yapıt kümesinin işlenmesi onları asla taşımaz. Girdi olmadığında yoktur ve hiç girdi verilmeyen bir konuk, alan hiç olmasaydı nasıl işleyecekse tam olarak öyle işler.

Ek özelliklere izin verilmez.

IRNodeProjection

Bir Provider konuğunun işlediği düğüm başına IR verisi: tam IR düğümünün, düğüm başına kimliği ve konuğun yayımlanan her manifeste damgaladığı kökeni taşıyan sınırlı bir izdüşümü. Bunlar şunlardır: kimliği, türü, çözümlenmiş recipe, değerler, bu değerleri bir değer eşlemesinin üretip üretmediği, feature ekleri, işlenmiş anahtarları ve değerlerin bütünü üzerindeki hassasiyet işaretlemesi, giden uses kenarları, sınır yolu, eşitleme dalgası, Recipe kimliği, component-id geçersiz kılması, türetilmiş ad temeli ve derleme kökeni. Kimlik ve türetilmiş ad temeli iki ayrı taşınan veridir, çünkü iki soruyu yanıtlarlar: bir kaynağın neye ait olduğu ve bir yazarın kendi kaynağının neye göre işlendiği. Yazarının yazdığı kaynağı teslim eden bir Feature eki, iki yanıtın ayrıştığı yerdir. Kaynak dosya içeriği burada taşınmaz; kaynak izdüşümünde ayrı olarak iletilir. Buradaki her anahtar kümesinin sabit bir sırası vardır (features ve uses yazar sırasıyla, değerler ve hassasiyet işaretlemesi sıralı anahtar sırasıyla), böylece aktarım yükü özdeş girdinin çalıştırmaları arasında bayt bayt aynıdır.

ÖzellikTürZorunluAçıklama
idstringevetDüğümün topoloji grafiği içindeki mutlak kimliği.
typestringevetBildirilmiş ve kasıtlı olarak saklanmış: ana makine bunu her zaman boş dize olarak yayımlar. Düğümün bileşen türü etiketi bir davranış anahtarı değil, opak meta veridir; bu yüzden onu burada taşımak yalnızca bir konuğu ona göre dallanmaya davet ederdi. Konuk boş bir dize okur ve bunu bileşen türü ayarlanmamış bir düğüm olarak okumamalıdır. (Sınır birleştirme düğüm biçimi, farklı bir amaçla kendine ait bir tür taşır.)
resolved_recipestringevetBildirilmiş ve kasıtlı olarak saklanmış: ana makine bunu her zaman boş dize olarak yayımlar. Bağlı Recipe’in kimliği konuğa zaten kökene damgaladığı recipe adı ve sürümü olarak ulaşır; bu nedenle çözümlenmiş URI, bir konuğun işlemede kullandığı hiçbir şey eklemez. Çıktıyı bir Recipe’e atfetmesi gereken bir konuk bunun yerine o köken alanlarını okur.
valuesobjecthayırDüğümün işlenmiş değerler sözlüğü; konuğun işlemede kullandığı anahtar kümesi. Anahtarlar yazar sırasıyla değil, sıralı olarak gelir ve yükü özdeş girdinin çalıştırmaları arasında bayt bayt aynı kılan bu sıralamadır; başka bir sıralamaya ihtiyaç duyan konuk bunu kendisi uygular.
featuresobjecthayırDüğümün feature takma adına göre anahtarlanmış feature ekleri; IR’ın taşıdığı düğüm başına feature eki biçiminin aynısını taşır. Her girdi, ekin değerlerini, infra ve inject eşlemesini türetilmiş hassasiyet işaretlemesiyle birlikte taşır; böylece bir konuk, bir ekin hassas olarak bildirilmiş malzemeyle çalışıp çalışmadığını yalnızca yükten okur. Yazar sırasını korur, böylece yük özdeş girdinin çalıştırmaları arasında bayt bayt aynıdır. Bu şema katmanında opaktır; konuk feature girdisi biçimini IR aktarım sözleşmesi aracılığıyla okur.
sensitive_rendered_keysstring eşlemihayırKimliği, bir yazarın hassas olarak bildirdiği bir veriden geri kazanılan render edilmiş anahtarlar; her biri bu hassasiyeti devraldığı bildirimle eşlenir. Render girdisinde host’tan guest’e taşınır; bu, bir guest’in render çıktısında bildirdiği adların tersi yöndür. Bir anahtarın neyi adlandırdığı, bu yükün taşıdığı biçime bağlıdır: düğümün değerlerini taşıyan bir yükte o eşlemin anahtarlarından biridir; bir workload taşıyan bir yükte, düğümün değerlerinin boş olduğu durumda, workload’un kendi ek eşlemlerindeki bir girdiyi adlandırır. Bir anahtar yalnızca geri kazanımın tam olduğu yerde bulunur: bir bildirimi render edilmiş bir kimliğe, anahtarın kendi metninden hiçbir şey okunmadan ve tek tek anahtarlara yayılmış düğüm başına ya da ek başına bir işaretleme olmadan bağlar. Bu nedenle bir şablonun ürettiği anahtar bulunmaz, çünkü onu hiçbir bildirim adlandırmaz: bir recipe’nin valuesMapping’inin çıktı anahtarları ve bir artifact’in içeriği şablonla yazılmıştır, dolayısıyla ikisi de burada bir anahtar üretmez; böyle bir yükün hassas olarak bildirilmiş bir değerden üretilip üretilmediği bunun yerine sensitive_values ile ve bir artifact girdisinin kendi sensitive_content alanıyla taşınır. Bu nedenle yokluk, hiçbir anahtarın kimliğinin geri kazanılamadığını belirtir; bu yükteki hiçbir şeyin hassas malzeme taşımadığını asla belirtmez. Bulunmayan bir anahtarı bir değeri açık olarak gösterme ya da yayma izni olarak okuyan bir guest, onu ters okumuştur. Anahtarlar sıralı olarak gelir ve yükü özdeş girdinin çalıştırmaları arasında bayt bayt aynı kılan budur.
sensitive_valuesbooleanhayırBu yükün taşıdığı değerler, bir yazarın hassas olarak bildirdiği bir değeri ya da ona izlenen bir değeri okuyan bir şablon tarafından üretildiğinde true olur: bir Recipe’nin ya da bir FeatureRecipe’nin valuesMapping’i, çıktı anahtarları ve değerleri kendi ürünü olan tek bir şablondur; bu yüzden o çıktının hiçbir anahtarı geldiği veriye kadar izlenemez ve bunun yerine eşlemin tamamı işaretlenir. Şablonun bildirimlere karşı kendi başvurularından okunur (bildirilmiş bir değere ulaşan bir başvuru, verisinin tamamını aktaran bir şablon ya da ayrıştırılamayan bir şablon, hepsi sayılır) ve asla bir değerin içeriğinden ya da bir anahtarın adından okunmaz. Bir kişinin okuyacağı bir metni, bir reddi ya da bir uyarıyı oluşturan bir guest, bu true olduğunda düğümün değerlerinin hiçbirini o metne koymaz ve bu true olsun olmasın sensitive_rendered_keys’in adlandırdığı herhangi bir anahtarın altındaki değeri de metin dışında tutar: ikisi birlikte çalışır; biri kimliği tam olarak geri kazanılan anahtarları adlandırır, bu ise hiçbirinin geri kazanılamadığı eşlemi kapsar. Böyle bir şablon böyle bir değeri okumadığında bulunmaz; buna bildirilmiş yaprakların kendisi olan ve bunun yerine sensitive_rendered_keys içinde anahtar başına işaretlenen değerler de dahildir; değer taşımayan bir yükte de bulunmaz. Yokluk, hiçbir değerin hassas olmadığını asla belirtmez.
values_mappedbooleanhayırBu yükün taşıdığı değerler, düğümün değerlerinin yazarın yazdığı şekilde aktarılması yerine bağlı Recipe’nin ya da FeatureRecipe’nin valuesMapping’inin çıktısı olduğunda true olur. Kendi sözleşmesi, kaynağının bildirdiği girdilere yalnızca bir eşlemenin ürettiği değerleri bağlayan bir guest bunu okur ve Recipe’nin artifact’leri gibi başka bir şey için yazılmış değerleri okumadan bırakır; düğümün değerlerini nasıl üretilmiş olursa olsun kaynağına bağlayan bir guest bunu okumaz. Değerlerin nasıl üretildiğini kaydeder ve asla bir anahtarın adından ya da bir değerin içeriğinden türetilmez. Hiçbir valuesMapping çalışmadığında ve değer taşımayan bir yükte bulunmaz.
usesstring[] eşlemihayırBildirilmiş ve bilerek esirgenmiştir: host bunu hiçbir zaman doldurmaz, bu yüzden eşlem her render yükünde bulunmaz. Dışa giden bir kenar gönderimden önce tüketilir (kenarın yayımlanan değerleri düğümün kendi inject borusuna yeniden yüklenir; Recipe bu boruyu guest’in aldığı değerlere ve workload’a zaten değerlendirmiştir) ve bir sınırı birleştiren guest, kenar listesini bunun yerine kendi girdisinde alır. Doldurulmuş olsaydı, düğümün dışa giden uses kenarlarını soket takma adına göre anahtarlar, her biri o soketin sıralı hedef düğüm kimliklerini yazar sırasıyla taşırdı.
boundary_pathstringhayırDüğümün sınır yolu; bir metadata bloğu taşıyan her yayımlanan manifest’e aggrega.ai/boundary-path ek açıklaması olarak damgalanır.
sync_waveintegerhayırBu düğümün kendisini içeren sınırdan devraldığı dağıtım dalgası (varsayılan 0; negatif değere izin verilir); IR düğümünün sync_wave olarak tuttuğu değeri taşır. Bir guest’in bununla ne yapacağı guest’in kendi seçimidir ve değeri kaydetmek ile ona göre sıralamak birbirinin alternatifi değil, birbirinden bağımsızdır: bir guest bunlardan birini, ikisini ya da hiçbirini yapabilir. Standart kitaplık sağlayıcıları arasında: helm ve helm-chart bunu render edilen her kaynakta bir argocd.argoproj.io/sync-wave ek açıklaması olarak, ayrıca chart’ın zaten bir Helm hook’u olarak işaretlediği bir kaynakta helm.sh/hook-weight olarak yayar; compose bunu hem bir servis etiketi olarak kaydeder hem de render ettiği dosyanın servislerini aralarındaki depends_on aracılığıyla sıralar; cloudformation birleştirilmiş yığının sağlanmasını sıralar ve bir dalgadaki her kaynağın bir önceki dalganın kaynaklarına bağlı olduğunu bildirir; terraform bir sınırın birleştirildiği kök yapılandırmanın modül bloklarını sıralar, bir dalgadaki her modülün bir önceki dalganın modüllerine bağlı olduğunu bildirir ve bunu ayrıca düğümün derleme kökeniyle birlikte kaydeder.
recipe_namestringhayırBağlı Recipe’nin adı; aggrega.ai/recipe-uri ek açıklamasını oluşturmak için recipe_version ile eşleştirilir; yarılardan biri boş olduğunda ek açıklama damgalanmaz.
recipe_versionstringhayırBağlı Recipe’nin sürümü; aggrega.ai/recipe-uri ek açıklamasını oluşturmak için recipe_name ile eşleştirilir; yarılardan biri boş olduğunda ek açıklama damgalanmaz.
label_component_idstringhayırKubernetes için güvenli bileşen kimliği: bu düğümün yaydığı bir kaynağın neye AİT olduğu; kökenin kaydettiği ve bir seçicinin sorguladığı budur. Boş olmadığında, app.kubernetes.io/name ve aggrega.ai/component-id etiket değeri olarak düğüm kimliğini geçersiz kılar; boş olması, düğüm kimliğinin zaten etiket için geçerli olduğu ve doğrudan kullanıldığı anlamına gelir. Bir Feature ekinin yaydığı her kaynak için, ek bunları hangi yolla teslim ederse etsin taşınır; böylece bir ekin kaynakları, ana bileşeninin kaynaklarından yalnızca etiketle ayırt edilebilir. Bir guest’in kendi adlarını neyden türettiği ayrı bir taşımadır, derived_name_basis; ikisi farklı soruları yanıtlar.
derived_name_basisstringhayırBir guest’in kendi adlarını türettiği kimlik: bir chart yükleyicisinin şablonlarının okuduğu sürüm adı, böyle bir guest’in bir bileşen için sentezlediği kaynakları da ona göre adlandırabileceği ad ve bir kaynak render’ının yaydığı dosyalardaki önek. Boş olması, düğüm kimliğinin doğrudan kullanıldığı anlamına gelir; sıradan bir bileşen ve bileşen başına bir Feature eki için değer budur: yazarının yazdığı bir chart’ı ya da bir parçayı teslim eden bir ek, onu ANA bileşenin adına göre render eder, çünkü yazarın kendi şablonları kaynakları o ada göre adlandırır ve farklı bir ad zaten dağıtılmış kaynakları yeniden adlandırırdı. Kimliği, bir hedefin ad alfabesinin reddettiği işaret sözdizimi taşıyan bir düğüm bunun yerine bunu açıkça taşır; böylece bir guest’in türettiği ad hedefin kabul ettiği bir ad olarak kalır. label_component_id’den bilerek ayrıdır: bir Feature eki için yazarının kaynağını render etmek yerine kaynakları KURAN bir guest, onları kimliğe göre adlandırır; böylece ekin kendi kaynakları ana bileşeninkilerle çakışamaz, bir yazarın kaynağının render edildiği ad ise yerinde kalır. Bir düğümün kimliği aynı zamanda kaynağının render edildiği ad olduğunda ikisi aynı değeri taşır.
output_labelsstring eşlemihayırKonuğun, derleme kimliği kökeniyle birlikte yayımlanan her manifeste damgaladığı, recipe yazarının bildirdiği çıktı etiketleri; etiket adına göre anahtarlanır. Yazılan iki blok bu tek eşlemde birleşir: bir recipe’nin outputLabels içinde yazdığı değişmez anahtar-değer çiftleri ve bir recipe’nin outputComponentLabels içinde adlandırdığı her anahtar için, değeri işlenen component’in kendi etiketlerindeki o anahtardan okunan bir girdi; böylece yükseltilen bir değer recipe’de tekrarlanmak yerine geldiği component’i izler. Her iki blok da yükleme zamanı doğrulamasıyla köken anahtar uzayından ayrıktır (aggrega.ai/ veya app.kubernetes.io/ anahtarı yoktur), bu nedenle damgalama hiçbir zaman bir köken etiketiyle çakışmaz. Component’in bildirmediği yükseltilmiş bir anahtar hiçbir şey damgalamaz ve boş bir etiket yerine bir uyarı üretir. Çıktısı Kubernetes YAML olmayan bir konuk bunları kendi etiket yüzeyine (Compose hizmet etiketleri) çevirir ya da yok sayar.
provenanceNodeProvenanceevetKonuğun, yayımlanan her manifeste aggrega.ai etiketleri olarak damgaladığı derleme kimliği kökeni.

Ek özelliklere izin verilmez.

NodeProvenance

Bir düğümün derleme kimliği kökeni: konuğun, yayımlanan her manifeste aggrega.ai etiketleri olarak damgaladığı derleyici, aggregate ve ortam kimliği. Her alan boş olduğunda çıkarılır; böylece kısmi bir kimlik yalnızca taşıdığı etiketleri damgalar.

ÖzellikTürZorunluAçıklama
compiler_versionstringhayırDerleyici sürümü; boş değilse aggrega.ai/compiler-version etiketi olarak damgalanır.
aggregate_namestringhayırAggregate adı; boş değilse aggrega.ai/aggregate-name etiketi olarak damgalanır.
environmentstringhayırOrtam adı; boş değilse aggrega.ai/environment etiketi olarak damgalanır.
provider_namestringhayırYalın provider türü; boş değilse aggrega.ai/provider etiketi olarak damgalanır.
provider_versionstringhayırÇözümlenmiş provider işleme eklentisi sürümü; boş değilse aggrega.ai/provider-version etiketi olarak damgalanır.

Ek özelliklere izin verilmez.

RenderNodeOutput

Bir Provider konuğunun render_node dışa aktarımından döndürdüğü yük: konuğun ürettiği her çıktı dosyasının serileştirilmiş baytları, kendi anahtar uzaylarının her birine türettiği adlar, ürettikleri hakkında bildirdiği olgular, kendisine verilen her omit girdisinin kaç işlenmiş birimle eşleştiği ve konuğun işleme sırasında ürettiği tüm tanılamalar. Konuk her dosyanın serileştirilmiş baytlarını döndürür; ana makine bunları olduğu gibi yazar ve hiçbir serileştirici çalıştırmaz. Determinizm konuğun sorumluluğundadır: özdeş girdi özdeş baytlar üretmelidir.

ÖzellikTürZorunluAçıklama
filesRenderedFile[]evetKonuğun ürettiği çıktı dosyaları, üretim sırasıyla. Her biri diskteki yolunu belirtir ve ana makinenin olduğu gibi yazdığı serileştirilmiş baytları taşır.
derived_keysstring[] eşlemihayırKonuğun bu düğümü işlerken türettiği adlar; onları türettiği anahtar uzayına göre anahtarlanır ve her uzay adlarını türetme sırasıyla taşır. Çıktısının bir kaynağa hitap ettiği adı türeten bir konuk, o adı ana makinenin olduğu gibi yazdığı dosya baytlarının içine koymuştur; ana makine onu orada göremez. Adı burada bildirmek, konuğun ana makineden hiçbir iki türetmenin aynı ada düşmediğini doğrulamasını istemesinin yoludur. Ana makine bildirilen adları yalnızca bildirilen tek bir uzay içinde eşitlik açısından karşılaştırır ve başka bir şey yapmaz: bir adı ayrıştırmaz, bir uzayın ya da adın ne anlama geldiğini öğrenmez ve hiçbir zaman kendisi ad türetmez. Aynı birleştirilmiş çıktıya katkıda bulunan ve aynı uzayda aynı adı bildiren iki katkıcı derlemeyi durdurur; durdurma uzayı, adı ve her iki katkıcıyı belirtir. Hem uzay adları hem de içlerindeki adlar konuğun kendi sözcük dağarcığıdır: bir birleştirilmiş çıktıdan daha dar ya da daha geniş bir kapsamda benzersizlik isteyen bir konuk, bu kapsamı bildirdiği uzay adında ifade eder. Yükün özdeş girdinin çalıştırmaları arasında bayt bayt aynı olması için bildirim sırasını korur. Konuk denetlenmesini istediği hiçbir ad türetmediğinde bulunmaz; bu da denetimi o konuk için etkisiz bırakır.
render_factsRenderFact[]hayırKonuğun bu düğüm için ürettikleri hakkında bildirdiği olgular, konuğun listelediği sırayla. Her olgu bir adı bir değerle eşler ve ikisi de konuğun kendi sözcük dağarcığıdır: bir provider’ın hangi olguları bildirdiği, her adın ne anlama geldiği ve girdilerinin ne taşıdığı bu soketin değil, o provider’ın belgelenmiş sözleşmesinin parçasıdır. Her olgunun değeri, tek bir girdi taşısa bile bir listedir: ana makine değeri başka herhangi bir şey olan bir olguyu, provider’ı ve olguyu belirterek reddeder ve derlemeyi durdurur. Ana makinenin bir değer hakkında öğrendiği tek şey budur. Olguları ada göre anahtarlar ve her listeyi onu okuyan şablonlara verir; aynı düğümün birden fazla işlemesinin bildirdiği aynı adlı listeleri bu işlemelerin çalıştığı sırayla birleştirir ve bir adın ya da girdinin ne anlama geldiğini hiçbir zaman öğrenmez, kendisi de olgu türetmez. Böylece bir provider, yazdığı belgelerin bir özelliği gibi yalnızca kendi biçim bilgisinin görebileceği bir şeyi, ana makine o biçimi öğrenmeden bildirebilir. Olgu bildirmek yazılanı hiçbir zaman değiştirmez: ana makinenin yazdığı dosyalar, olgular eşlik etsin ya da etmesin, konuğun döndürdüğü dosyalardır. Konuk, yükün özdeş girdinin çalıştırmaları arasında bayt bayt aynı olması için olgularını sabit bir sırayla listeler. Konuk hiçbir şey bildirmediğinde bulunmaz; bu eksik değil, eksiksiz bir yanıttır.
omittedinteger[]hayırGirdinin omits alanındaki her girdinin kaç işlenmiş birimle eşleştiği: konuğa verilen her girdi için aynı sırayla bir sayı; her biri, başka bir girdi de o birimlerle eşleşmiş olsun ya da olmasın, o girdinin eşleştiği birim sayısıdır. Sıfır sayısı eksiksiz bir yanıttır: girdi, konuğun işlediği hiçbir şeyle eşleşmemiştir. Sayılar, soketin dışarıda bırakılanlar hakkında geri taşıdığı tek şeydir: birimlerin kendisi konuğun döndürdüklerinde basitçe bulunmaz. Konuğa hiçbir girdi verilmediğinde bulunmaz.
diagnosticsDiagnostic[]hayırKonuğun işleme sırasında ürettiği tanılamalar. Her öğe, paylaşılan Wasm eklentisi tanılama biçimindedir.
errorstringhayırKonuk çalıştığı hâlde işlemi tamamlayamadığında ayarlanan bir hata mesajı; başarı durumunda bulunmaz. Çıktının taşıdığı tanılamalardan farklıdır: tanılamalar yine de bir sonuç üreten bir çalıştırma sırasında bulunan sorunları bildirirken error, işlemin kendisinin tamamlanmadığını bildirir. Ana makine, mevcut bir error’u başarısız bir eklenti çağrısı olarak yansıtır.
condition_codestringhayırHatanın belirttiği koşulun açıklayıcı, makinece eşleştirilebilir kimliği: koşulun kayıtlı olduğu kod; derleyicinin kendi durdurucu koşullarını kaydettiği aynı açık kümededir ve bir yanıt zarfının hostfunc_error_code alanının aldığı kapalı ana makine işlevi hata kodu kataloğunun bir üyesi değildir. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Duran bir konuk, mesajının belirttiği koşulun tanımlayıcısını burada bildirir; böylece bir tüketici, mesajı okuyarak bir kimlik çıkarmak yerine buna göre dallanır. Ana makine bu tanımlayıcıyı derleyicinin bildirdiği koşullara karşı çözümler ve çözümlenen koşulun kendi tanımlayıcılarını yapılandırılmış tanılamada yayımlar; böylece bir okuyucuya ulaşan kod her zaman çözümlenir. Böyle bir koşulu belirtmeyen ya da numaralandırmanın kullanımdan kaldırdığı bir tanımlayıcı derlemeyi durdurur. Belirtecek kesin bir koşulu olmayan bir konuk, bunun yerine derleyicinin bu amaçla bildirdiği genel eklenti hatası koşullarından birine başvurur ve ayrıntıları kendi mesajına koyar. Bu tanımlayıcı ve condition_short_code birlikte bildirilir, çünkü tek bir koşulu iki biçimde belirtirler: birini ayarlayıp diğerini ayarlamayan bir konuk, ana makinenin çözümleyemediği bir koşul belirtmiş olur; ana makine de bu durumda kendi genel eklenti hatası koşulunu bildirir, mesaj ise hatanın tamamını taşımaya devam eder.
condition_short_codestringhayırAynı koşulun kısa tanımlayıcısı: E harfi ve dört rakam; bir okuyucunun alıntıladığı, aradığı ve bir rapora yapıştırdığı biçim. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Ana makine bunu, bu hata için oluşturduğu tanılamanın köşeli parantezli başlığında yazdırır; böylece bir konuğun ortaya çıkardığı koşul, derleyicinin ortaya çıkardığı bir koşul gibi aynen alıntılanabilir. Ana makine değeri güvene dayanarak taşımak yerine derleyicinin bildirdiği koşullara karşı çözümler: böyle bir koşulu belirtmeyen bir değer, numaralandırmanın kullanımdan kaldırdığı bir değer ya da kaydın taşımadığı bir yazım derlemeyi durdurur ve sorunlu değeri alıntılar; konuğun kendi mesajı da yine bildirilir. Orada belirtilen nedenle condition_code ile birlikte bildirilir.

Ek özelliklere izin verilmez.

ValidateNodeOutput

Bir Provider konuğunun isteğe bağlı validate_node_input dışa aktarımından döndürdüğü yük: düğümün çözümlenmiş girdisinin yapısal denetiminin ürettiği tanılamalar. Dışa aktarım, render_node’un aldığı RenderNodeInput izdüşümünün aynısını tüketir ve hiçbir dosya üretmez; yalnızca tanılama bildirir. Halt önem düzeyindeki bir tanılama, düğümü ve sağlayıcıyı adlandırarak derlemeyi açıkça durdurur; warn ya da info önem düzeyindeki bir tanılama, işlenen çıktıyı değiştirmeden derleme sonucuna yansır. Boş bir tanılama listesi, girdinin yapısal denetimi geçtiği anlamına gelir.

ÖzellikTürZorunluAçıklama
diagnosticsDiagnostic[]hayırKonuğun düğümün girdisini doğrularken ürettiği tanılamalar. Her öğe, paylaşılan Wasm eklentisi tanılama biçimidir. Girdi yapısal denetimi geçtiğinde boştur.
errorstringhayırKonuk çalıştığı hâlde işlemi tamamlayamadığında ayarlanan bir hata mesajı; başarı durumunda bulunmaz. Çıktının taşıdığı tanılamalardan farklıdır: tanılamalar yine de bir sonuç üreten bir çalıştırma sırasında bulunan sorunları bildirirken error, işlemin kendisinin tamamlanmadığını bildirir. Ana makine, mevcut bir error’u başarısız bir eklenti çağrısı olarak yansıtır.
condition_codestringhayırHatanın belirttiği koşulun açıklayıcı, makinece eşleştirilebilir kimliği: koşulun kayıtlı olduğu kod; derleyicinin kendi durdurucu koşullarını kaydettiği aynı açık kümededir ve bir yanıt zarfının hostfunc_error_code alanının aldığı kapalı ana makine işlevi hata kodu kataloğunun bir üyesi değildir. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Duran bir konuk, mesajının belirttiği koşulun tanımlayıcısını burada bildirir; böylece bir tüketici, mesajı okuyarak bir kimlik çıkarmak yerine buna göre dallanır. Ana makine bu tanımlayıcıyı derleyicinin bildirdiği koşullara karşı çözümler ve çözümlenen koşulun kendi tanımlayıcılarını yapılandırılmış tanılamada yayımlar; böylece bir okuyucuya ulaşan kod her zaman çözümlenir. Böyle bir koşulu belirtmeyen ya da numaralandırmanın kullanımdan kaldırdığı bir tanımlayıcı derlemeyi durdurur. Belirtecek kesin bir koşulu olmayan bir konuk, bunun yerine derleyicinin bu amaçla bildirdiği genel eklenti hatası koşullarından birine başvurur ve ayrıntıları kendi mesajına koyar. Bu tanımlayıcı ve condition_short_code birlikte bildirilir, çünkü tek bir koşulu iki biçimde belirtirler: birini ayarlayıp diğerini ayarlamayan bir konuk, ana makinenin çözümleyemediği bir koşul belirtmiş olur; ana makine de bu durumda kendi genel eklenti hatası koşulunu bildirir, mesaj ise hatanın tamamını taşımaya devam eder.
condition_short_codestringhayırAynı koşulun kısa tanımlayıcısı: E harfi ve dört rakam; bir okuyucunun alıntıladığı, aradığı ve bir rapora yapıştırdığı biçim. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Ana makine bunu, bu hata için oluşturduğu tanılamanın köşeli parantezli başlığında yazdırır; böylece bir konuğun ortaya çıkardığı koşul, derleyicinin ortaya çıkardığı bir koşul gibi aynen alıntılanabilir. Ana makine değeri güvene dayanarak taşımak yerine derleyicinin bildirdiği koşullara karşı çözümler: böyle bir koşulu belirtmeyen bir değer, numaralandırmanın kullanımdan kaldırdığı bir değer ya da kaydın taşımadığı bir yazım derlemeyi durdurur ve sorunlu değeri alıntılar; konuğun kendi mesajı da yine bildirilir. Orada belirtilen nedenle condition_code ile birlikte bildirilir.

Ek özelliklere izin verilmez.

RenderedFile

Bir Provider konuğunun ürettiği bir çıktı dosyası: düğümün çıktı köküne göreli disk üzerindeki yolu ve konuğun ürettiği haliyle serileştirilmiş baytları. Ana makine bu baytları olduğu gibi yazar ve hiçbir serileştirici çalıştırmaz; böylece diskteki çıktı, konuğun ürettiğiyle bayt bayt aynıdır.

ÖzellikTürZorunluAçıklama
pathstringevetÇıktı dosyasının düğümün çıktı köküne göreli yolu (örneğin Chart.yaml ya da templates/deployment.yaml).
contentstringevetDosyanın, konuğun ürettiği haliyle serileştirilmiş baytları; ana makine bu baytları olduğu gibi yazar ve hiçbir serileştirici çalıştırmaz; böylece çıktı, konuğun ürettiğiyle bayt bayt aynıdır. Her kit bunları kendi alan türünde taşır: bu tür bir bayt türüyse ham olarak, konuğun baytları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak. Üretilen kodlayıcı, alan ile kablonun baytları taşıdığı biçim arasında dönüşüm yapar.
formatstringhayırKonuğun, üretilen dosyanın işlendiğini bildirdiği biçim; böylece ana makine dosyayı eşleşen bir ayrıştırıcıya yönlendirebilir. Konuk hiçbir biçim bildirmediğinde bulunmaz; bu durumda ana makine biçimi dosya uzantısından çıkarır.

Ek özelliklere izin verilmez.

RenderFact

Bir Provider konuğunun bir düğüm için ürettikleri hakkında bildirdiği bir olgu: her ikisi de sağlayıcı tarafından tanımlanan ve belgelenen bir ad ve bir girdi listesi. Ana makine olguyu konuğun yazdığı gibi taşır, değeri liste olmayan bir olguyu reddeder ve iki yarıdan hiçbiri hakkında başka bir şey öğrenmez.

ÖzellikTürZorunluAçıklama
namestringevetOlgunun, sağlayıcının kendi belgelenmiş söz dağarcığından gelen adı.
valuedizievetOlgunun değeri: bir JSON dizisi (tek girdisi olsa ya da hiç olmasa bile her zaman bir liste); girdileri, sağlayıcının o ad için belgelediği biçimde herhangi JSON değerleridir. Bir adın bir düğümün birden fazla işlemesi tarafından bildirilebilmesini sağlayan şey listedir: ana makine listeleri tek bir listede birleştirir. Konuğun yazdığı JSON belgesi olarak bayt bayt taşınır; bu nedenle listenin girdilerinin ve her nesnenin anahtarlarının sırası konuğun kendisine aittir.

Ek özelliklere izin verilmez.

OmitEntry

Bir Provider konuğunun bir düğümün çıktısının dışında bıraktığı işlenmiş birimleri adlandıran bir girdi; alanları önceden düz string’lere çözümlenmiş ve herhangi biri hassas olarak bildirilmiş bir değerden üretildiğinde işaretlenmiştir. Soket bunlara hiçbir anlam yüklemez: her sağlayıcı, kind, name, namespace ve subchart’ın kendi biçiminde neyi seçtiğini belgeler ve eşleştirmeyi kendisi yapar.

ÖzellikTürZorunluAçıklama
kindstringevetGirdinin adlandırdığı işlenmiş birimin türü, sağlayıcının kendi söz dağarcığıyla.
namestringevetGirdinin adlandırdığı işlenmiş birimin adı, sağlayıcının kendi söz dağarcığıyla.
namespacestringhayırAdlandırılan birimin bulunduğu namespace; biçimi birimleri bir namespace içine yerleştiren bir sağlayıcı için. Yazar hiçbir şey yazmadığında bulunmaz; namespace’i olmayan bir girdinin neyle eşleştiği sağlayıcının kendi sözleşmesidir.
subchartstringhayırAdlandırılan birimin geldiği iç içe kaynak; bir chart’ın alt chart’larından oluşturulması gibi, kaynağı iç içe kaynaklardan oluşturulan bir provider için. Yazar hiçbirini yazmadığında bulunmaz; subchart içermeyen bir girdinin neyle eşleştiği ve kaynağında iç içe kaynak bulunmayan bir provider’ın böyle bir kaynağı adlandıran bir girdiyle ne yaptığı, provider’ın kendi sözleşmesidir.
sensitivebooleanhayırGirdinin kind, name, namespace ya da subchart alanlarından herhangi birini üreten şablon, bir yazarın hassas olarak bildirdiği bir değeri ya da böyle bir değere izlenen bir değeri okuduğunda true olur. Her alanın şablonundan bildirimlere karşı okunur (bildirilmiş bir değere ulaşan bir başvuru, verisinin tamamını aktaran bir şablon ya da ayrıştırılamayan bir şablon, hepsi sayılır) ve hiçbir zaman çözümlenmiş string’lerden okunmaz. İşaret alanı adlandırmak yerine girdinin tamamını kapsar; bu nedenle bir konuk, işaretli bir girdiyi girdisindeki diğer her işaretli değer gibi ele alır: girdiyi yine alanlarına göre eşleştirir ve sayar, ki girdi bunun içindir, ve hiçbir alanını bir kişinin okuduğu herhangi bir metne (bir ret, bir uyarı ya da bir günlük satırı) koymaz. Hiçbir alanın şablonu böyle bir değer okumadığında bulunmaz; bulunmaması hiçbir zaman hiçbir alanın hassas olmadığını belirtmez.

Ek özelliklere izin verilmez.

SourceFile

Önceden paketlenmiş bir kaynak izdüşümünün bir dosyası: kaynak köküne göreli yolu ve ana makinenin derleme zamanında yerel kaynaktan okuduğu haliyle ham baytları.

ÖzellikTürZorunluAçıklama
pathstringevetDosyanın kaynak köküne göreli yolu (örneğin Chart.yaml ya da templates/deployment.yaml).
contentstringevetDosyanın, ana makinenin yerel kaynaktan okuduğu haliyle ham baytları. Her kit bunları kendi alan türünde taşır: bu tür bir bayt türüyse ham olarak, konuğun baytları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak. Üretilen kodlayıcı, alan ile kablonun baytları taşıdığı biçim arasında dönüşüm yapar.

Ek özelliklere izin verilmez.

SourceProjection

Ana makinenin bir pack-source isteğine yanıt olarak okuyup konuğa döndürdüğü paketlenmiş kaynak içeriği (ör. bir Helm chart’ının dosyaları, her biri kaynak köküne göreli yoluyla adlandırılmış, gezinme sırasıyla); böylece konuk seçilen kaynağı bellekte yeniden oluşturur ve hiçbir dosya sistemine dokunmaz. pack-source ana makine işlevinin başarı yüküdür.

ÖzellikTürZorunluAçıklama
filesSourceFile[]evetHer biri kaynak köküne göreli yoluyla adlandırılmış, ana makinenin deterministik gezinme sırasındaki kaynak dosyaları.

Ek özelliklere izin verilmez.

SourceEntry

Bir kaynak listesinin tek bir girdisi: kaynak köküne göreli yolu ve bir dizin olup olmadığı. Ana makine yalnızca adları listeler ve hiçbir içerik okumaz; bu nedenle bir girdi hiçbir bayt taşımaz.

ÖzellikTürZorunluAçıklama
pathstringevetGirdinin kaynak köküne göreli, eğik çizgiyle ayrılmış yolu (örneğin Chart.yaml veya templates/deployment.yaml).
is_dirbooleanevetGirdinin bir dizin olup olmadığı. Liste içinde bir chart kökünü veya tek bir kaynak dosyasını çözümleyen bir konuk, dosya sistemine dokunmadan dizinleri dosyalardan ayırt etmek için bunu okur.

Ek özelliklere izin verilmez.

SourceListing

Ana makinenin kaynaklı bir provider konuğuna verdiği, edinilmiş bir kaynağın genel dökümü: kaynak kökü, bu kökün bir dizin olup olmadığı ve altındaki, köke göreli sıralanmış girdiler. Ana makine edinilmiş kaynakta hiçbir alan bilgisi olmadan gezinir ve hiçbir dosya içeriği okumaz; yalnızca adları listeler. Konuk, liste üzerinde kendi çözümleme mantığını uygular (bir chart kökünü bulmak, tek bir compose belgesini seçmek, bir modül ağacını vendor’lamak) ve seçtiği bir seçimi pack-source ana makine işleviyle paketlemesini ana makineden ister. Girdiler yola göre sıralanır; böylece liste, özdeş girdinin çalıştırmaları arasında bayt bayt aynıdır.

ÖzellikTürZorunluAçıklama
rootstringevetAna makinenin döküm çıkardığı edinilmiş kaynak konumu. Konuk, kaynağı çözümleyemediğinde bunu kendi tanılamalarına taşır; böylece bir çözümleme durması, yazarın sağladığı kaynağı adlandırır.
root_is_dirbooleanhayırEdinilmiş kaynak kökünün bir dizin olup olmadığı. Tek dosyalı bir kaynak (tek başına bir compose belgesi, tek bir modül dosyası, bir arşiv) için false’tur; bu durumda entries boştur ve konuk kökün kendisini paketler.
entriesSourceEntry[]evetBir dizin kaynak kökü altındaki, yola göre sıralanmış, köke göreli girdiler. Tek dosyalı bir kaynak kökü için boştur.

Ek özelliklere izin verilmez.

SourcePackRequest

Bir konuğun, pack-source ana makine işleviyle edinilmiş kaynaktan paketlemesini ana makineden istediği seçim. op seçimin biçimini, path ise seçimi kaynak köküne göreli olarak adlandırır; ana makine yolu kaynak kökü altında çözümler, kökün üstüne her türlü kaçışı reddeder ve paketlenmiş baytları bir SourceProjection olarak döndürür.

ÖzellikTürZorunluAçıklama
opstring (enum)evetSeçim biçimi: file, path’teki tek dosyayı paketler; dir, path’teki dizinin doğrudan dosyalarını paketler; tree, path’te köklenen alt ağacın tamamını, özyinelemeli olarak, ana makinenin deterministik gezinme sırasıyla paketler. İzin verilen değerler: "file", "dir", "tree"
pathstringevetSeçim konumu, kaynak köküne göreli ve eğik çizgiyle ayrılmış olarak. Boş dize (veya ”.”) kaynak kökünün kendisini adlandırır; bu nedenle tek dosyalı bir kaynak boş bir yolla paketlenir.

Ek özelliklere izin verilmez.

SourcePackResponse

pack-source ana makine işlevinin yanıtı: başarı durumunda paketlenmiş kaynak, başarısızlık durumunda bir hata mesajı. İki alandan tam olarak biri doldurulur. Başarısızlık, trap yerine bant içinde iletilir; böylece bir konuk, bir sandbox reddini veya bir okuma hatasını deterministik bir render hatası olarak kendi tanılamalarına taşır.

ÖzellikTürZorunluAçıklama
source_projectionSourceProjectionhayırBaşarı durumunda paketlenmiş kaynak; başarısızlık durumunda bulunmaz.
errorstringhayırBaşarısızlık durumunda seçimi ve nedeni adlandıran hata mesajı; başarı durumunda bulunmaz.
hostfunc_error_codestring (enum)hayırBaşarısızlık durumunda, kapalı ana makine işlevi hata kodu kataloğundan alınan ve insan tarafından okunan hata mesajının yanında ayarlanan, makinece eşleştirilebilir başarısızlık kimliği; başarı durumunda bulunmaz. Bu katalog, bir ana makine işlevinin başarısız olabileceği yolları adlandıran sabit bir sözcük dağarcığıdır ve derleyicinin kaydettiği durdurma koşullarından farklı bir dağarcıktır; bu koşulların tanımlayıcılarını bir konuk, soket çıktısında condition_code ve condition_short_code olarak bildirir. Anahtar adı, bir değerin bu ikisinden hangisine ait olduğunu söyler; böylece ikisi asla tek bir küme olarak okunmaz. Bir konuk, mesajı ayrıştırmadan bu koda göre dallanır; bulunmayan bir kodu (eski ana makine) veya tanınmayan bir kodu (yeni ana makine) mesaja geri dönerek tolere eder. İzin verilen değerler: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed"

Ek özelliklere izin verilmez.

SourceFileRequest

Çözümleme mantığı neyi paketleyeceğini seçmeden önce bir dosyanın içeriğini incelemesi gereken bir konuğun, read-source-file ana makine işleviyle ana makineden gerçekleştirmesini istediği tek dosyalık içerik okuması. Ana makine yolu kaynak kökü altında çözümler, kökün üstüne her türlü kaçışı reddeder ve dosyanın baytlarını döndürür.

ÖzellikTürZorunluAçıklama
pathstringevetDosya konumu, kaynak köküne göreli ve eğik çizgiyle ayrılmış olarak.

Ek özelliklere izin verilmez.

SourceFileResponse

read-source-file ana makine işlevinin yanıtı: başarı durumunda dosyanın baytları, başarısızlık durumunda bir hata mesajı. İki alandan tam olarak biri doldurulur. Başarısızlık, trap yerine bant içinde iletilir; böylece bir konuk, bir sandbox reddini veya bir okuma hatasını deterministik bir render hatası olarak kendi tanılamalarına taşır.

ÖzellikTürZorunluAçıklama
contentstringhayırBaşarı durumunda dosyanın ham baytları; başarısızlık durumunda bulunmaz. Her kit bunları kendi alan türünde taşır — bu tür bir bayt türüyse ham olarak, konuğun bunları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak — ve üretilen kodlayıcı, alan ile kablonun baytları taşıdığı biçim arasında dönüşüm yapar.
errorstringhayırBaşarısızlık durumunda dosyayı ve nedeni adlandıran hata mesajı; başarı durumunda bulunmaz.
hostfunc_error_codestring (enum)hayırBaşarısızlık durumunda, kapalı ana makine işlevi hata kodu kataloğundan alınan ve insan tarafından okunan hata mesajının yanında ayarlanan, makinece eşleştirilebilir başarısızlık kimliği; başarı durumunda bulunmaz. Bu katalog, bir ana makine işlevinin başarısız olabileceği yolları adlandıran sabit bir sözcük dağarcığıdır ve derleyicinin kaydettiği durdurma koşullarından farklı bir dağarcıktır; bu koşulların tanımlayıcılarını bir konuk, soket çıktısında condition_code ve condition_short_code olarak bildirir. Anahtar adı, bir değerin bu ikisinden hangisine ait olduğunu söyler; böylece ikisi asla tek bir küme olarak okunmaz. Bir konuk, mesajı ayrıştırmadan bu koda göre dallanır; bulunmayan bir kodu (eski ana makine) veya tanınmayan bir kodu (yeni ana makine) mesaja geri dönerek tolere eder. İzin verilen değerler: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed"

Ek özelliklere izin verilmez.

FetchExternalInputResponse

fetch-external-input host işlevinin yanıtı: başarı durumunda getirilen içerik, hata durumunda bir hata mesajı ve kodu. Hata alanlarından hiçbirini taşımayan bir yanıt başarılıdır; dolayısıyla sıfır uzunluklu bir yük, tüm alanları bulunmayan yanıttır. Hata, tuzağa düşürülerek değil bant içinde iletilir; böylece guest, çözümlenemeyen bir URL’yi veya bir getirme hatasını kendi tanılamalarına deterministik bir render hatası olarak taşır. İstek, yapılandırılmış bir yük değil yalın bir URL dizesidir; bu nedenle yalnızca yanıtın bildirilmiş bir biçimi vardır.

ÖzellikTürZorunluAçıklama
contentstringhayırBaşarı durumunda getirilen yükün ham baytları; hata durumunda ve yük boş olduğunda bulunmaz. Baytlar hat üzerinden hiçbir zaman base64 metni olarak değil, bir bayt dizesi olarak geçer. Go kiti bunları bir bayt dilimi olarak tutar; Rust ve TypeScript kitleri bunları, her kitin fetch sarmalayıcısının çözdüğü bir base64 dizesi olarak tutar; böylece her sarmalayıcı yükün ham baytlarını döndürür.
errorstringhayırHata durumunda URL’yi ve çözümü belirten hata mesajı; başarı durumunda bulunmaz.
hostfunc_error_codestring (enum)hayırBaşarısızlık durumunda, kapalı ana makine işlevi hata kodu kataloğundan alınan ve insan tarafından okunan hata mesajının yanında ayarlanan, makinece eşleştirilebilir başarısızlık kimliği; başarı durumunda bulunmaz. Bu katalog, bir ana makine işlevinin başarısız olabileceği yolları adlandıran sabit bir sözcük dağarcığıdır ve derleyicinin kaydettiği durdurma koşullarından farklı bir dağarcıktır; bu koşulların tanımlayıcılarını bir konuk, soket çıktısında condition_code ve condition_short_code olarak bildirir. Anahtar adı, bir değerin bu ikisinden hangisine ait olduğunu söyler; böylece ikisi asla tek bir küme olarak okunmaz. Bir konuk, mesajı ayrıştırmadan bu koda göre dallanır; bulunmayan bir kodu (eski ana makine) veya tanınmayan bir kodu (yeni ana makine) mesaja geri dönerek tolere eder. İzin verilen değerler: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed"

Ek özelliklere izin verilmez.

WorkloadProjection

Host’un bir Provider guest’ine verdiği, önceden değerlendirilmiş workload içeriği; guest bundan bellekte provider’a özgü manifestler sentezler. Bağlı Recipe bir chart kaynağı yerine bir workload bildirdiğinde bulunur. Determinizm guest’in sorumluluğundadır: aynı girdi aynı baytları üretmelidir.

ÖzellikTürZorunluAçıklama
workloadobjectevetGuest’in sentezlediği, host tarafından değerlendirilmiş ve doğrulamadan geçmiş Workload; socket şeması Workload varlık sözleşmesini yeniden bağlamasın diye bu şema katmanında opaktır.
sensitive_workloadbooleanhayırworkload’u üreten şablon, bir yazarın hassas olarak bildirdiği bir değeri veya böyle bir değere izlenen bir değeri okuduğunda true olur. Hiçbir alanın içeriğinden değil, şablonun bildirimlere karşı kendi başvurularından okunur: bildirilmiş bir değere ulaşan bir başvuru, şablonun verisinin tamamını aktarması veya ayrıştırılamayan bir şablon, hepsi sayılır. Render edilmiş bir workload’un alanları, şablonunun okuduğu veriye geri bağlantı taşımaz; bu nedenle bu, belgenin tamamını işaretler: bir kişinin okuyacağı metni (bir reddetme ya da bir uyarı) oluşturan bir guest, bu true olduğunda workload’un taşıdığı her değeri o metnin dışında tutar; belgenin biçimi ise (anahtarları ve bir değerin nerede durduğu) okunabilir kalır. Düğüm projeksiyonunun sensitive_rendered_keys alanının adlandırdığı ek girdileri, bu ayarlansın ya da ayarlanmasın orada işaretlenir. Şablon böyle bir değer okumadığında bulunmaz; bulunmaması hiçbir alanın hassas olmadığını belirtmez.
attachment_providesobjecthayırDüğümdeki her ek, çözümlenmiş provides değerlerine yansıtılmış ve bir workload ek başvurusunun taşıdığı ek örnek adına göre anahtarlanmış olarak; düğüm hiç ek taşımadığında bulunmaz. Host dizeleri yorumlamadan olduğu gibi kopyalar; böylece guest, o ekin ürettiği kaynağa bir başvuruyu çözümlemek için bir ekin provides değerlerinden hangi girdilere ihtiyaç duyuyorsa onları okur. Bir ekin hassas olarak bildirilmiş malzemeyi işleyip işlemediği burada tekrarlanmaz: bu bilgi, düğüm projeksiyonunun eşleşen feature girdisinde taşınır ve guest bunu aynı örnek adıyla okur.

Ek özelliklere izin verilmez.

ArtifactsProjection

Host’un bir Provider guest’ine düğümün çıktısına yerleştirmesi için verdiği, önceden değerlendirilmiş artifact kümesi. Host her girdinin kaynağını (satır içi içerik veya okuduğu içe aktarılmış bir dosya) zaten çözümlemiş, guest’in bildirdiği artifact şablonu sınırlayıcı çiftini kullanarak render bağlamına karşı bir Go şablonu olarak değerlendirmiş ve derleme kökeni etiket ve ek açıklama anahtar kümelerini hesaplamıştır. Biçim kararı, köken bilgisinin yerleşimi, diskteki yol ve son baytlar guest’e aittir. Girdiler yazar sırasını korur; böylece yerleştirilen çıktı, aynı girdinin çalıştırmaları arasında bayt bayt aynıdır.

ÖzellikTürZorunluAçıklama
entriesArtifactProjectionEntry[]evetGuest’in yerleştirdiği artifact girdileri, yazar sırasıyla.

Ek özelliklere izin verilmez.

ArtifactProjectionEntry

Host’un bir Provider guest’ine yerleştirmesi için verdiği, önceden değerlendirilmiş tek bir artifact girdisi: host tarafından çözümlenmiş çıktı adı, kökeni, şablonu zaten değerlendirilmiş içerik baytları, bu baytların geldiği şablonun hassas olarak bildirilmiş bir değeri okuyup okumadığı ve host’un düğüm için hesapladığı derleme kökeni etiket ve ek açıklama anahtar kümeleri. Köken bilgisinin nasıl yerleştirileceğine (bir manifestin metadata’sına eklenerek, bir yorum olarak başa konarak veya eşlik eden bir dosya üretilerek) ve dosyanın nereye düşeceğine guest karar verir.

ÖzellikTürZorunluAçıklama
namestringevetGirdi için host tarafından çözümlenmiş çıktı adı: yazarın bildirdiği map anahtarı; bir kütüphane paketinin sağladığı dosya bu anahtarın altında iç içe yer alır. Guest girdiyi bu ada veya bundan türetilen provider’a özgü bir alt yola yerleştirir.
originstring (enum)evetGirdinin satır içi içerik olarak mı yoksa içe aktarılmış bir dosya olarak mı yazıldığı. Biçimlerden birini reddeden bir guest (bir umbrella-chart provider’ı satır içi içeriği reddeder) açıkça durmak için bunu okur. İzin verilen değerler: "inline", "import"
contentstringevetHost’un girdinin satır içi içeriğinden veya içe aktarılmış dosyasından ürettiği, guest’in bildirdiği artifact şablonu sınırlayıcı çiftini kullanarak render bağlamına karşı değerlendirilmiş, şablonu zaten değerlendirilmiş içerik baytları. Her kit bunları kendi alan türünde taşır: bu tür bir bayt türü olduğunda ham, guest’in bunları geri elde etmek için çözdüğü bir dize olduğunda base64 ile kodlanmış olarak; üretilen kodlayıcı ise alan ile hattın baytları taşıdığı biçim arasında dönüştürme yapar.
sensitive_contentbooleanhayırBu girdinin içeriğinin değerlendirildiği şablon, bir yazarın hassas olarak bildirdiği bir değeri veya böyle bir değere izlenen bir değeri okuduğunda true olur. İçeriğin kendisinden değil, içeriğin değerlendirildiği sınırlayıcı çiftiyle, şablonun bildirimlere karşı kendi başvurularından okunur: bildirilmiş bir değere ulaşan bir başvuru, şablonun verisinin tamamını aktarması veya ayrıştırılamayan bir şablon, hepsi sayılır. İçerik o şablonun çıktısıdır; bu nedenle içindeki hiçbir şey geldiği veriye geri izlenemez: bir kişinin okuyacağı metni (bir reddetme ya da bir uyarı) oluşturan bir guest, bu true olduğunda içeriğin her parçasını, bir ayrıştırıcının içerikle ilgili kendi mesajı da dahil olmak üzere, o metnin dışında tutar. Girdi başına ayarlanır; dolayısıyla bir girdinin şablonunun böyle bir değeri okuması başka bir girdi hakkında hiçbir şey söylemez. Şablon böyle bir değer okumadığında bulunmaz; bulunmaması içeriğin hassas olmadığını belirtmez.
labelsobjecthayırHost’un düğüm için hesapladığı, Kubernetes etiketi için güvenli derleme kökeni anahtar kümesi; etiket adına göre anahtarlanır. Köken bilgisini bir manifestin metadata.labels alanına işleyen bir guest bunları ekler; çıktısı Kubernetes YAML olmayan bir guest bunları yok sayar.
annotationsobjecthayırHost’un düğüm için hesapladığı ve bir Kubernetes etiketinin temsil edemediği derleme kökeni anahtar kümesi; ek açıklama adına göre anahtarlanır. Köken bilgisini bir manifestin metadata.annotations alanına işleyen bir guest bunları ekler; çıktısı Kubernetes YAML olmayan bir guest bunları yok sayar.

Ek özelliklere izin verilmez.

AssembleBoundaryInput

Bir Provider konuğunun assemble_boundary dışa aktarımında aldığı yük; bu dışa aktarım, tek bir dağıtım grubundaki düğüm başına render çıktılarını tek bir birleştirilmiş yapıtta (bir şemsiye chart, birleştirilmiş bir compose dosyası) birleştirir. Yük, düğüm başına render çıktılarını birleştirilmiş açıklamaları ve dağıtım dalgalarıyla birlikte, birleştirilmiş yapıtın yerleştiği dağıtım grubu çıktı yolunu, hizmet başına bağımlılık çıkarımı için grafiğin uses kenarlarını ve render zamanı bağlamını taşır. Her provider bu dışa aktarımı bildirmez: yalnızca düz, düğüm başına çıktı üreten provider’lar onu atlar.

ÖzellikTürZorunluAçıklama
rendered_nodesRenderedNode[]evetBu dağıtım grubunu besleyen düğüm başına render çıktıları, düğüm sırasıyla.
contextobjectevetJSON belgesinin baytları olarak taşınan render zamanı bağlamı. Bu dışa aktarımda ana makine yalnızca yaml_indent’i, yani birleştirilmiş dosyaların serileştirildiği render genelindeki girinti genişliğini ayarlar; bağlamın diğer üyeleri burada hiçbir şey taşımaz, çünkü bir birleştirme ek açıklamaları ve sınırları farklı olan katkıda bulunanları birleştirir ve her katkıda bulunanın ek açıklamaları bunun yerine kendi rendered_nodes girdisinde gelir.
boundary_pathstringevetBirleştirilmiş yapıtın yerleştiği, değerlendirilmiş dağıtım grubu çıktı yolu; bir sınır birleştiricisi bunu sınır düzeyinde yedek kimlik olarak kullanır (ör. namespace açıklaması taşımayan bir düğüm için compose ağ adı).
edgesRenderEdge[]hayırGrafiğin yönlü uses kenarları; böylece bir sınır birleştiricisi, dağıtım grubuna katkıda bulunanlar arasında hizmet başına sıralamayı/bağımlılıkları çıkarabilir (ör. compose depends_on).
sub_chartsSubChart[]hayırBir şemsiye chart birleştiricisinin, katkıda bulunan her biri için bir bağımlılık ve bir values kapsamı üretmek üzere tükettiği alt chart başına yük. Her girdi alt chart’ın kimliğini, örnek başına değerleri ve bir chart kaynağından alınmış bir alt chart için o chart’ın Chart.yaml dosyasının özgün baytlarını taşır. Şemsiye chart birleştirmesi için bulunur; düz birleştirme yapan bir birleştirici onu atlar.
chart_namestringhayırDağıtım grubu için bir ad sağlandığında, bir şemsiye chart birleştiricisinin birleştirilmiş chart için kullandığı chart adı; birleştirici adı dağıtım grubu çıktı yolundan türettiğinde boştur.
aggregate_namestringhayırBir şemsiye chart birleştiricisinin birleştirilmiş chart’ın türetilmiş adına kattığı üst düzey aggregate adı; ada hiçbir aggregate kimliği katkıda bulunmadığında boştur.

Ek özelliklere izin verilmez.

RenderedNode

Bir düğümün assemble_boundary girdisinde göründüğü biçimiyle render çıktısı: düğüm kimliği, türü, birleştirilmiş açıklamaları, sync dalgası, değerleri sağlamak derleyiciye düştüğü durumda derleyicinin onun için çözümlediği değerler ve bunları bir değer eşlemesinin üretip üretmediği, ve render_node dışa aktarımının onun için ürettiği dosyalar — render çıktısının biçiminde taşınır; bu biçimin dosyalar dışındaki her üyesi boş bırakılır.

ÖzellikTürZorunluAçıklama
idstringevetDüğümün topoloji grafiği içindeki mutlak kimliği. Grafiğin düğümlerinden biri olmayan bir katkıcı — bir bileşene değil bir sınıra eklenmiş bir Feature — burada bunun yerine derleyicinin onun için kullandığı kendi dağıtım kimliğini taşır; bu, o katkıcı için yapılan render_node çağrısının taşıdığı kimliğin aynısıdır. Bir katkıcıyı diğerinden ayırt eder ve herhangi bir hedefin kabul ettiği bir ad değildir. Böyle bir katkıcının birleştirilmiş yapıtın içinde adları neyden türettiği ayrı bir taşımadır: derived_name_basis.
typestringevetDüğümün bileşen türü etiketi; düğüm başına render projeksiyonunun aksine bu biçimde taşınır, çünkü o projeksiyon etiketi saklar. Bir davranış anahtarı değil, opak meta veridir: bir birleştiricinin birleştirdiği düğümleri gruplayıp etiketleyebilmesi için buradadır, bir konuğun ona göre dallanabilmesi için değil.
derived_name_basisstringhayırBu katkıcının birleştirilmiş yapıtın içinde kendi adlarını türettiği kimlik — bir birleştiricinin katkıcının yayımlanmış girdilerinden biri için ürettiği mantıksal bir kimlik, birleştirilmiş bir belgede katkıcı başına bir kapsam, kendine ait bir konuma yerleştirilen bir alt birimin adı. Boş olması kimliğin doğrudan kullanıldığı anlamına gelir; sıradan bir bileşen için değer budur. Kimliği, bir hedefin ad alfabesinin reddettiği bir dağıtım kimliği olan katkıcı bunu açıkça taşır; böylece birleştirilmiş yapıt içeriğine hedefin kabul ettiği bir adla hitap eder ve bir yazarın ayırt edebildiği iki katkıcı tek bir ad altında buluşamaz. Katkıcının içeriği birleştiricinin birleştirdiği bir belgeye katlandığında, bu, o katkıcı için yapılan render_node çağrısının aldığı taşımanın aynısıdır ve ikisinde de taşınması iki yanıtı eşit tutan şeydir: katkıcının render sırasında bildirdiği bir ad ile birleştirilmiş belgenin o içeriğe hitap ettiği ad, rastlantıyla örtüşen iki kimlikten değil tek bir kimlikten türetilir. Katkıcı bunun yerine kendine ait bir konuma yerleştirildiğinde, bu, o katkıcı için oluşturulan kimliktir; bir bileşene bağlanan bir Feature için, render’ının dayandığı ana makine bileşeninin kimliği değil, kendi kimliğidir; böylece ana makinesinin yanına yerleştirilen bir alt birime ondan ayrı olarak hitap edilir.
output_directorystringhayırBu katkıcının render edilmiş dosyalarının bulunduğu dizin; birleştirilmiş yapıtın kendi konumuna göredir ve sonunda ayırıcı taşımaz. Bir katkıcının dosyalarını birleştirilmiş yapıtın içinden adlandırması gereken bir konuk — bir module bloğunun kaynak yolu, bir include yönergesi — konumu katkıcının kimliğinden kendisi oluşturmak yerine buradan okur; böylece birleştirilmiş yapıtın gösterdiği yol, dosyaların yazıldığı yolla aynı olur. İkisi her zaman bir dizin aralıklı değildir: ana makinenin başka bir katkıcının konumu içine yerleştirdiği bir katkıcı, doğrudan birleştirmenin altına yerleştirilen katkıcılardan daha derinde bulunur. Yalnızca birleştiren provider her katkıcıyı kendine ait bir konumun altına yerleştirdiğinde bulunur; katkıcılarını tek bir belgeye katlayan bir provider katkıcı başına dizin yerleştirmez ve hiçbirini almaz.
renderedRenderNodeOutputevetBir Provider konuğunun render_node dışa aktarımından döndürdüğü yük: konuğun ürettiği her çıktı dosyasının serileştirilmiş baytları, kendi anahtar uzaylarının her birine türettiği adlar, ürettikleri hakkında bildirdiği olgular, kendisine verilen her omit girdisinin kaç işlenmiş birimle eşleştiği ve konuğun işleme sırasında ürettiği tüm tanılamalar. Konuk her dosyanın serileştirilmiş baytlarını döndürür; ana makine bunları olduğu gibi yazar ve hiçbir serileştirici çalıştırmaz. Determinizm konuğun sorumluluğundadır: özdeş girdi özdeş baytlar üretmelidir.
annotationsstring eşlemihayırDüğümün birleştirilmiş açıklamaları; böylece bir sınır birleştiricisi düğüm başına yerleşimi belirleyebilir (ör. aggrega.ai/namespace açıklamasından türetilen compose ağı).
sync_waveintegerhayırBu düğümün kendisini içeren sınırdan devraldığı dağıtım dalgası (varsayılan 0; negatif değere izin verilir); böylece bir sınır birleştiricisi birleştirdiği katkıcıları birbirine göre sıralayabilir. Bir dağıtım grubu, her biri kendi dalgasını taşıyan birden çok sınırdan katkıcıları birleştirebilir; bu yüzden dalga, yükün tamamı için bir kez değil, burada her düğümle birlikte taşınır. Çıktı biçimi hiçbir sıralama ifade etmeyen bir birleştirici bunu yok sayar.
valuesobjecthayırDerleyicinin bu düğüm için çözümlediği değerler; yalnızca bir kaynaktan render edilen düğüm için bulunur — dosyalarını üreten render_node çağrısı bir source_listing taşımıştır. Dosyaların başka bir yerden geldiği ve değerlerin onlara yazılamadığı tek durum budur; bu yüzden onları dosyaların dışındaki bir konumun sağlaması gerekir: bir sınır birleştiricisi mevcut bir sözlüğü, katkıcının kendi dosyalarının yanına değil, birleştirilmiş yapıtın kendisine o katkıcının girdileri olarak yerleştirir; ve birleştirilmiş yapıt hedefin değerlendirdiği tek konum olduğunda, bu, hedefin okuduğu bir girdi ile hiç ulaşmadığı bir girdi arasındaki farktır. Bir workload_projection’dan veya bir artifacts_projection’dan render edilen düğüm bu değerleri ürettiği dosyalara çözümlemiştir; bu yüzden burada hiçbirini taşımaz ve alan bulunmaz: bunları ikinci kez sağlamak, birleştirilmiş yapıta o düğümün kendi dosyalarının hiç bildirmediği girdiler sunar ve hedef bunları reddetmekte serbesttir. Anahtarlar yazar sırasıyla değil sıralanmış olarak gelir ve yükü aynı girdinin çalıştırmaları arasında bayt bayt aynı kılan bu sıralamadır; başka bir sıralamaya ihtiyaç duyan konuk bunu kendisi uygular. Çıktı biçimi katkıcı başına girdi taşımayan bir birleştirici bu alanı yok sayar.
values_mappedbooleanhayırBu düğümün taşıdığı değerler, düğümün değerlerinin yazarın yazdığı gibi aktarılması değil de bağlı Recipe’inin veya FeatureRecipe’inin valuesMapping’inin çıktısı olduğunda (bir bileşenin Recipe’i, eklenmiş bir Feature’ın FeatureRecipe’i) true olur — bu düğüm için yapılan render_node çağrısının düğüm projeksiyonunda taşıdığı işaretin aynısıdır ve burada tanımladığı değerlerin yanında taşınır. Hiçbir valuesMapping çalışmadığında ve values bulunmadığı her durumda bulunmaz. Bir birleştiricinin bunu okuyup okumaması o birleştiricinin kendi sözleşmesidir: render_node’u eşlenmiş bir düğümün değerlerini kaynağının bildirdiği girdilere bağlayan bir birleştirici, bu bağlamanın hangi adları doldurduğunu bundan öğrenebilir; bir düğümün değerlerini nasıl üretilmiş olursa olsun girdileri olarak yerleştiren bir birleştirici ise bunu okumaz. Değerlerin nasıl üretildiğini kaydeder ve hiçbir zaman bir anahtarın adından veya bir değerin içeriğinden türetilmez.

Ek özelliklere izin verilmez.

RenderEdge

Grafın iki düğüm kimliğiyle adlandırılan yönlü bir uses kenarı: source tüketen düğüm, target ise tüketilen düğümdür. Liste grafın her uses kenarını taşır; bu nedenle uçlardan herhangi biri bu dağıtım grubunun dışındaki bir düğüm olabilir.

ÖzellikTürZorunluAçıklama
sourcestringevetTüketen düğümün kimliği — yönlü bir uses kenarının kaynak ucu.
targetstringevetTüketilen düğümün kimliği — yönlü bir uses kenarının gösterdiği hedef uç.

Ek özelliklere izin verilmez.

SubChart

Bir şemsiye chart’a katkıda bulunan tek bir alt chart: örnek kimliği, şemsiyenin sabitlediği sürüm, şemsiyenin alt chart’ın takma adı altında kapsamladığı örneğe özgü değerler ve bir chart kaynağından vendor edilmiş bir alt chart için o chart’ın Chart.yaml dosyasının bozulmamış baytları. Bir şemsiye chart birleştiricisi, şemsiyenin bağımlılıklarını ve değerler dosyasını yalnızca bu saf veri görünümlerinden oluşturur ve hiçbir dosya sistemine dokunmaz.

ÖzellikTürZorunluAçıklama
instance_idstringevetAlt chart’ın dispatch grubu içindeki örnek kimliği; şemsiye, alt chart’ın bağımlılık takma adını ve değerlerini bunun altında kapsamlar, böylece tek bir kaynak chart’ın birden çok örneği birbirinden ayrı kalır.
versionstringhayırŞemsiyenin alt chart için sabitlediği sürüm. Bir chart kaynağından vendor edilmiş bir alt chart ise bağımlılığın bağlanabilmesi için bağımlılık adını ve sürümünü o chart’ın Chart.yaml dosyasından alır; bu değer, vendor edilmiş chart taşımayan üretken bir alt chart için geçerlidir.
valuesobjecthayırŞemsiyenin, şemsiye values.yaml dosyasında alt chart’ın takma adı altında kapsamladığı örneğe özgü değerler. Anahtarlar yazar sırasıyla değil, sıralanmış olarak gelir ve özdeş girdiyle yapılan çalıştırmalarda yükü bayt düzeyinde özdeş kılan bu sıralamadır; başka bir sıralamaya ihtiyaç duyan bir konuk bunu kendisi uygular.
chart_yamlstringhayırVendor edilmiş chart’ın Chart.yaml dosyasının, derleme zamanında yerel kaynaktan okunan bozulmamış baytları; şemsiye, alt chart bağımlılığının adını ve sürümünü bunlardan alır. Vendor edilmiş chart taşımayan üretken bir alt chart için boştur. Her kit bunları kendi alan türünde taşır — bu tür bir bayt türüyse ham olarak, konuğun bunları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak — ve üretilen kodlayıcı, alan ile kablonun baytları taşıdığı biçim arasında dönüşüm yapar.

Ek özelliklere izin verilmez.

AssembleBoundaryOutput

Bir Provider konuğunun assemble_boundary dışa aktarımından döndürdüğü yük: birleştirilmiş her dosyanın serileştirilmiş baytları ve konuğun birleştirme sırasında ürettiği tanılamalar. Birleştirilen grubun düğüm başına dosyalarının nerede bulunduğu bu yanıtın parçası değildir — bu, sağlayıcının statik bir özelliğidir; describe() sözleşmesinde bir kez bildirilir ve herhangi bir düğüm işlenmeden önce elde bulunur. Konuk her dosyanın serileştirilmiş baytlarını döndürür; ana makine bunları olduğu gibi yazar ve hiçbir serileştirici çalıştırmaz. Determinizm konuğun sorumluluğundadır: özdeş girdi özdeş baytlar üretmelidir.

ÖzellikTürZorunluAçıklama
filesRenderedFile[]evetKonuğun yayımladığı birleştirilmiş çıktı dosyaları, yayım sırasıyla. Her biri diskteki yolunu belirtir ve ana makinenin olduğu gibi yazdığı serileştirilmiş baytları taşır.
diagnosticsDiagnostic[]hayırKonuğun birleştirme sırasında ürettiği tanılamalar. Her öğe, ortak Wasm eklentisi tanılama biçimidir.
errorstringhayırKonuk çalıştığı hâlde işlemi tamamlayamadığında ayarlanan bir hata mesajı; başarı durumunda bulunmaz. Çıktının taşıdığı tanılamalardan farklıdır: tanılamalar yine de bir sonuç üreten bir çalıştırma sırasında bulunan sorunları bildirirken error, işlemin kendisinin tamamlanmadığını bildirir. Ana makine, mevcut bir error’u başarısız bir eklenti çağrısı olarak yansıtır.
condition_codestringhayırHatanın belirttiği koşulun açıklayıcı, makinece eşleştirilebilir kimliği: koşulun kayıtlı olduğu kod; derleyicinin kendi durdurucu koşullarını kaydettiği aynı açık kümededir ve bir yanıt zarfının hostfunc_error_code alanının aldığı kapalı ana makine işlevi hata kodu kataloğunun bir üyesi değildir. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Duran bir konuk, mesajının belirttiği koşulun tanımlayıcısını burada bildirir; böylece bir tüketici, mesajı okuyarak bir kimlik çıkarmak yerine buna göre dallanır. Ana makine bu tanımlayıcıyı derleyicinin bildirdiği koşullara karşı çözümler ve çözümlenen koşulun kendi tanımlayıcılarını yapılandırılmış tanılamada yayımlar; böylece bir okuyucuya ulaşan kod her zaman çözümlenir. Böyle bir koşulu belirtmeyen ya da numaralandırmanın kullanımdan kaldırdığı bir tanımlayıcı derlemeyi durdurur. Belirtecek kesin bir koşulu olmayan bir konuk, bunun yerine derleyicinin bu amaçla bildirdiği genel eklenti hatası koşullarından birine başvurur ve ayrıntıları kendi mesajına koyar. Bu tanımlayıcı ve condition_short_code birlikte bildirilir, çünkü tek bir koşulu iki biçimde belirtirler: birini ayarlayıp diğerini ayarlamayan bir konuk, ana makinenin çözümleyemediği bir koşul belirtmiş olur; ana makine de bu durumda kendi genel eklenti hatası koşulunu bildirir, mesaj ise hatanın tamamını taşımaya devam eder.
condition_short_codestringhayırAynı koşulun kısa tanımlayıcısı: E harfi ve dört rakam; bir okuyucunun alıntıladığı, aradığı ve bir rapora yapıştırdığı biçim. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Ana makine bunu, bu hata için oluşturduğu tanılamanın köşeli parantezli başlığında yazdırır; böylece bir konuğun ortaya çıkardığı koşul, derleyicinin ortaya çıkardığı bir koşul gibi aynen alıntılanabilir. Ana makine değeri güvene dayanarak taşımak yerine derleyicinin bildirdiği koşullara karşı çözümler: böyle bir koşulu belirtmeyen bir değer, numaralandırmanın kullanımdan kaldırdığı bir değer ya da kaydın taşımadığı bir yazım derlemeyi durdurur ve sorunlu değeri alıntılar; konuğun kendi mesajı da yine bildirilir. Orada belirtilen nedenle condition_code ile birlikte bildirilir.

Ek özelliklere izin verilmez.

CarveInput

Bir Provider konuğunun isteğe bağlı carve dışa aktarımında aldığı yük: bir FeatureRecipe adımı bazılarını düzenlemeden önce işlem hattının adreslenebilir birimlere ayırdığı tek bir adlandırılmış çıktı dosyası. Çıktı biçimini standart YAML codec’inin doğrudan ayıramadığı bir sağlayıcı (örneğin şablonlu bir chart), kendi çıktı biçimi bilgisinin konukta bulunması için carve ve reassemble’ı bildirir; bu dışa aktarımları atlayan bir sağlayıcı ana makinenin standart YAML codec’ini ödünç alır.

ÖzellikTürZorunluAçıklama
namestringevetCodec’in ada göre kapsamlanan herhangi bir ayırma kuralını uygulayabilmesi için çıktı dosyasının adı.
bodystringevetÇıktı dosyasının adreslenebilir birimlere ayrılacak baytları. Her kit bunları kendi alan türünde taşır — bu tür bir bayt türüyse ham olarak, konuğun bunları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak — ve üretilen kodlayıcı, alan ile kablonun baytları taşıdığı biçim arasında dönüşüm yapar.
yaml_indentintegerhayırCodec’in yeni yapılandırılmış metin sentezlemesi gerektiğinde kullandığı girinti genişliği; konuğun ayırmasının işleme genelindeki girintiyle eşleşmesi için taşınır.

Ek özelliklere izin verilmez.

CarveOutput

Bir Provider konuğunun carve dışa aktarımından döndürdüğü yük: dosyayı ayırdığı sıralı adreslenebilir birimler. Yapılandırılmış bir birim bir ağaç taşır (bir PATCH hedefi); opak bir birim yalnızca medya türünü ve baytlarını taşır.

ÖzellikTürZorunluAçıklama
unitsobject[]evetKonuğun dosyayı ayırdığı sıralı adreslenebilir birimler.

Ek özelliklere izin verilmez.

ReassembleInput

Bir Provider konuğunun isteğe bağlı reassemble dışa aktarımında aldığı yük: özgün dosya, onun parçalanmış birimleri ve bir işlem hattı adımının ürettiği yamalı birimler; böylece konuk, değişiklikleri özgün baytlara cerrahi bir hassasiyetle geri ekler. Yamalı kümede bulunmayan bir belirteç, özgün baytlarından olduğu gibi yeniden birleştirilir; yamalı bir belirtecin yalnızca adreslenen bayt aralıkları düzenlenir.

ÖzellikTürZorunluAçıklama
namestringevetÇıktı dosyasının adı; aynı dosyanın parçalandığı adla eşleşir.
bodystringevetYeniden birleştirmenin yamalı birimleri geri eklediği özgün dosya baytları. Her kit bunları kendi alan türünde taşır — bu tür bir bayt türüyse ham olarak, konuğun bunları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak — ve üretilen kodlayıcı, alan ile kablonun baytları taşıdığı biçim arasında dönüşüm yapar.
segsobject[]hayırDosyanın parçalandığı birimler; carve’ın döndürdüğü şekliyle.
patchedobject[]hayırBir işlem hattı adımının değiştirdiği birimler; her biri kendi belirtecini, yamalı ağacını ve değişikliği üreten işlemleri taşır.
yaml_indentintegerhayırBir işlemin yeni yapılandırılmış metin sentezlemesi gerektiğinde codec’in kullandığı girinti genişliği; yeniden birleştirmenin render genelindeki girintiyle eşleşmesi için taşınır.

Ek özelliklere izin verilmez.

ReassembleOutput

Bir Provider konuğunun reassemble dışa aktarımından döndürdüğü yük: yamalı birimlerin geri eklendiği dosya baytları. Yeniden birleştirme bayt düzeyinde sadıktır — işlemlerin dokunmadığı her bayt olduğu gibi korunur.

ÖzellikTürZorunluAçıklama
bodystringevetAna makinenin olduğu gibi yazdığı yeniden birleştirilmiş dosya baytları. Her kit bunları kendi alan türünde taşır — bu tür bir bayt türüyse ham olarak, konuğun bunları geri elde etmek için çözdüğü bir string ise base64 ile kodlanmış olarak — ve üretilen kodlayıcı, alan ile kablonun baytları taşıdığı biçim arasında dönüşüm yapar.

Ek özelliklere izin verilmez.

NameBoundInput

Bir Provider konuğunun isteğe bağlı name_bound dışa aktarımında aldığı yük: ana makinenin bir düğümün component kimliği olarak kullanmayı önerdiği bir ad; konuk bunu, hedefi için o kimlikten türeteceği her ada göre değerlendirir; kimlik düğümün workload’u çözümlendikten sonra belirleniyorsa, bu adlardan bazılarının bağlı olduğu, çözümlenmiş workload’a ilişkin olgular da onunla birlikte gelir. Konuk kendi adıyla değil bir kısıtlamayla yanıt verir — geri gönderilen türetilmiş bir ad, ana makineyi hakkında hiçbir şey bilmediği bir hedef için ad oluşturma işine sokar; soruyu sormak tam da bunu ortadan kaldırır. Hedefi kabul ettiği adları sınırlayan ya da kısıtlayan bir sağlayıcı dışa aktarımı duyurur; hedefi her adı kabul eden bir sağlayıcı onu atlar ve hiç sorgulanmaz, render’ı da değişmez.

ÖzellikTürZorunluAçıklama
proposedstringevetAna makinenin düğümün component kimliği olarak önerdiği ad. Konuk, bir component kimliğinden türettiği her adı bellekte bundan türetir ve her birinin hedefinin kabul ettiği bir ad olup olmadığını bildirir. Bir karar düğüm hakkında değil ÖNERİ hakkında konuşur: ana makine bir kimlik oluşturduğu her yerde tek bir soru sorar ve bu kimliğin o düğümün hangi adlarına temel olacağını söylemez; bu nedenle konuk, sanki hepsinin temeli olacakmış gibi yanıt verir. Bu temkinli yöndür, çünkü ana makine yanıta göre yalnızca kısaltır, asla uzatmaz — dolayısıyla düğümün aslında başka bir taşıyıcıdan türeteceği bir ad fazla gevşek değil fazla katı değerlendirilir.
authoredbooleanhayırÖnerilen adın, derleyicinin yazılmış parçalardan oluşturduğu bir ad değil, bir kişinin yazdığı bir ad olup olmadığı. Konuğun gerekçesini buna göre harekete geçebilecek okuyucu için ifade edebilmesi amacıyla taşınır. Bir reddin ne yapacağına karar vermez: yazılmış bir ad reddedilir, oluşturulmuş bir ad kısaltılır ve bu karar ana makineye aittir.
workload_formstringhayırDüğümün Recipe’sinin ya da FeatureRecipe’sinin çözümlendiği workload’un biçimi, workload şablonunun ürettiği şekliyle; kimlik o workload çözümlendikten sonra belirlendiğinde ve workload bir biçim belirttiğinde taşınır. Yazıldığı gibi taşınır; ana makine onu yorumlamaz. Hedefi yalnızca tek bir biçim için yaydığı bir adı sınırlayan bir konuk — hedefin, her çalıştırmada sonuna bir sonek eklendiği için diğer adlarından daha kısa tuttuğu zamanlanmış bir iş gibi — o adı değerlendirmek için bunu okur. Bulunmaması, ana makinenin bu soru için hiçbir biçim taşımadığı anlamına gelir: düğüm hiçbir workload bildirmez, workload’u hiçbir biçim belirtmez ya da kimlik herhangi bir workload çözümlenmeden önce belirlenir. Bu durumda konuk biçime bağlı hiçbir adı değerlendirmez ve alan hiç yokmuş gibi tam olarak aynı şekilde yanıt verir.
service_keysstring[]hayırDüğümün çözümlenmiş workload’unun bildirdiği Service’lerin anahtarları, workload’un onları bildirdiği sırayla; kimlik o workload çözümlendikten sonra belirlendiğinde ve workload herhangi bir Service bildirdiğinde taşınır. Hedefi, düğüm için yaydığı her Service’i component kimliğinden ve Service’in anahtarından adlandıran bir konuk, bu tür her adı değerlendirmek için bunları okur. Bir anahtarı kimliği yazan kişi değil, Recipe’nin ya da FeatureRecipe’nin yazarı yazar; bu yüzden konuk, bir anahtarın neden olduğu reddi o yazar için de ifade eder. Bulunmaması, ana makinenin bu soru için hiçbir anahtar taşımadığı anlamına gelir: düğüm hiçbir workload bildirmez, workload’u hiçbir Service bildirmez ya da kimlik herhangi bir workload çözümlenmeden önce belirlenir. Bu durumda konuk bir Service anahtarından oluşturulan hiçbir adı değerlendirmez ve alan hiç yokmuş gibi tam olarak aynı şekilde yanıt verir.

Ek özelliklere izin verilmez.

DerivedNameVerdict

Bir ad türünün önerilen bir kimlik hakkındaki kararı: konuğun o tür için türeteceği adın hedefinin kabul ettiği bir ad olup olmadığı ve — daha kısa bir kimlik kabul edilecekse — kabul edilecek en büyük uzunluk. Bir kısıtlama ve bir gerekçe taşır, asla konuğun oluşturduğu bir adı taşımaz.

ÖzellikTürZorunluAçıklama
kindstringevetKonuğun, bu kararın kapsadığı ad türü için kendi verdiği ad; derleyicinin değil hedefin söz dağarcığıyla yazılır — bir chart yükleyicisinin release adı, bir konteyner düzenleyicisinin service adı. Bir retde okuyucuya olduğu gibi ulaşır, bu nedenle hedefi bilen biri için yazılır.
usablebooleanevetKonuğun önerilen kimlikten bu tür için türeteceği adın hedefin kabul ettiği bir ad olup olmadığı.
boundintegerhayırBu türün türetilmiş adının hedefin kabul ettiği bir ad olması için önerilen bir kimliğin taşıyabileceği en büyük karakter sayısı. Yalnızca daha kısa bir kimliğin karşılayacağı bir retde bulunur. BULUNMAMASI, hedefin itirazının uzunlukla ilgili olmadığı anlamına gelir — ya hiç uzunluk sınırı yoktur ya da itiraz, hedefin dilbilgisinin düştüğü konumda reddettiği bir karakter gibi hiçbir kısaltmanın gidermediği bir itirazdır. Bu nedenle bulunmaması, bir uzunluk belirten sıfır sınırından farklıdır: sıfır, hiçbir uzunluktaki kimliğin bu türden kabul edilebilir bir ad vermediğini belirtir. Ana makine bulunan bir sınıra göre kısaltır ve yeniden sorar; sınır bulunmadığında durur, çünkü denenecek bir şey kalmamıştır.
reasonstringhayırHedefin türetilmiş adı neden kabul etmediği; bunun yerine ne yazacağına karar veren okuyucu için hedefin kendi terimleriyle. Karar kullanılabilir olduğunda boştur.

Ek özelliklere izin verilmez.

NameBoundOutput

Bir Provider konuğunun name_bound dışa aktarımından döndürdüğü yük: önerilen kimlikten türeteceği her ad türü için bir karar. Her karar kullanılabilir olduğunda öneri de kullanılabilirdir; biri kullanılabilir değilse ana makine öneriyi, reddeden kararların taşıdığı en küçük sınıra kısaltır ve yeniden sorar; reddeden bir karar hiçbir sınır taşımadığında durur. Boş bir karar listesi, konuğun bir bileşen kimliğinden hiçbir ad türetmediği anlamına gelir; bu da öneriyi kabul etmekle aynı yanıttır.

ÖzellikTürZorunluAçıklama
namesDerivedNameVerdict[]hayırKonuğun bir bileşen kimliğinden türettiği her ad türü için, konuğun kendi sırasıyla bir girdi. Konuk yalnızca reddeden türleri değil, türeteceği her türü bildirir; böylece okuyucu hangi adların değerlendirildiğini görür ve girdileri okuyan bir ana makinenin geri kalanını öğrenmek için ikinci bir çağrıya ihtiyacı olmaz.
errorstringhayırKonuk çalıştığı ancak işlemi tamamlayamadığı durumda ayarlanan bir hata iletisi; başarı durumunda yoktur. Reddeden bir karardan farklıdır: bir karar hedefin kabul etmeyeceği bir adı bildirirken, error sorunun kendisinin yanıtlanamadığını bildirir. Ana makine mevcut bir error’u başarısız bir eklenti çağrısı olarak yüzeye çıkarır.
condition_codestringhayırHatanın belirttiği koşulun açıklayıcı, makinece eşleştirilebilir kimliği: koşulun kayıtlı olduğu kod; derleyicinin kendi durdurucu koşullarını kaydettiği aynı açık kümededir ve bir yanıt zarfının hostfunc_error_code alanının aldığı kapalı ana makine işlevi hata kodu kataloğunun bir üyesi değildir. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Duran bir konuk, mesajının belirttiği koşulun tanımlayıcısını burada bildirir; böylece bir tüketici, mesajı okuyarak bir kimlik çıkarmak yerine buna göre dallanır. Ana makine bu tanımlayıcıyı derleyicinin bildirdiği koşullara karşı çözümler ve çözümlenen koşulun kendi tanımlayıcılarını yapılandırılmış tanılamada yayımlar; böylece bir okuyucuya ulaşan kod her zaman çözümlenir. Böyle bir koşulu belirtmeyen ya da numaralandırmanın kullanımdan kaldırdığı bir tanımlayıcı derlemeyi durdurur. Belirtecek kesin bir koşulu olmayan bir konuk, bunun yerine derleyicinin bu amaçla bildirdiği genel eklenti hatası koşullarından birine başvurur ve ayrıntıları kendi mesajına koyar. Bu tanımlayıcı ve condition_short_code birlikte bildirilir, çünkü tek bir koşulu iki biçimde belirtirler: birini ayarlayıp diğerini ayarlamayan bir konuk, ana makinenin çözümleyemediği bir koşul belirtmiş olur; ana makine de bu durumda kendi genel eklenti hatası koşulunu bildirir, mesaj ise hatanın tamamını taşımaya devam eder.
condition_short_codestringhayırAynı koşulun kısa tanımlayıcısı: E harfi ve dört rakam; bir okuyucunun alıntıladığı, aradığı ve bir rapora yapıştırdığı biçim. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Ana makine bunu, bu hata için oluşturduğu tanılamanın köşeli parantezli başlığında yazdırır; böylece bir konuğun ortaya çıkardığı koşul, derleyicinin ortaya çıkardığı bir koşul gibi aynen alıntılanabilir. Ana makine değeri güvene dayanarak taşımak yerine derleyicinin bildirdiği koşullara karşı çözümler: böyle bir koşulu belirtmeyen bir değer, numaralandırmanın kullanımdan kaldırdığı bir değer ya da kaydın taşımadığı bir yazım derlemeyi durdurur ve sorunlu değeri alıntılar; konuğun kendi mesajı da yine bildirilir. Orada belirtilen nedenle condition_code ile birlikte bildirilir.

Ek özelliklere izin verilmez.

RenderedNameInput

Bir Provider konuğunun isteğe bağlı rendered_name dışa aktarımında aldığı yük: bir hedefin kendi adlarını türettiği iki kimlik ve düğümün Recipe’inin hangi girdi türlerini bildirdiği — yazarın sağladığı kaynak, konuğun sentezlediği bir iş yükü. Konuk, hedefinin o düğüm için işlediği kaynaklara vereceği adla yanıt verir: sağlanan kaynak için, yazarın kendi şablonlarının karşısında işlendiği ad, örneğin bir chart’ın okuduğu sürüm adı; sentezlenen bir iş yükü için, konuğun düğümün kimliğini olduğu gibi yazmak yerine bir ad türettiği durumda, oluşturduğu kaynaklara verdiği ad. Böyle bir ad türetmeyen bir konuk hiçbir ad bildirmez; bu, kaynak adlarını bir Recipe’in birebir yazdığı bir hedef için ve adı düğüme değil dosyaların nereye yerleştirildiğine bağlı olan bir hedef için dürüst yanıttır. Bu dışa aktarım, konuğun kendisinin oluşturduğu bir adı bildirir ve konuktan ana makinenin önerdiği bir adı değerlendirmesini isteyen alışveriş değildir; bunlar farklı sorulardır ve her birinin kendi dışa aktarımı vardır.

ÖzellikTürZorunluAçıklama
node_idstringevetDüğümün yazıldığı haliyle kendi kimliği. Kodlanmadan taşınır: bir hedef onu kendi alfabesiyle daraltır; bu nedenle önce kodlamak, bir kaçış dizisini diğerinin içine koyar ve adı, bir recipe yazarının öngördüğü addan farklı biçimde yazar.
derived_name_basisstringhayırBir katkıcının kendi kaynağının, düğümün kendi kimliği olmadığında karşısında işlendiği kimlik — kimliğini bir hedefin ad alfabesinin reddettiği bir katkıcı için ayarlanır, aksi halde yoktur. Bir konuk bu çifti diğer tüm yüzeylerle aynı şekilde çözümler: mevcutsa bu değer, değilse düğüm kimliği.
sourcedbooleanhayırDüğüme bağlı Recipe’in yazarın sağladığı kaynağı bildirip bildirmediği; yazarın yazdığı metinden okunur. synthesized ile birlikte taşınır; böylece soru herhangi bir düğüm için sorulabilir ve doğru yanıtlanabilir: bir konuk, ikisini de bildirmeyen ve çıktısı yalnızca bir yapıt kümesi olan bir düğüm için hiçbir ad bildirmez, çünkü böyle bir kümedeki kaynaklar, konuğun türettiği herhangi bir adla değil, yazarın yazdığı yapıtlarla adlandırılır.
synthesizedbooleanhayırDüğüme bağlı Recipe’in konuğun sentezleyeceği bir iş yükü bildirip bildirmediği; sourced gibi, yazarın yazdığı metinden okunur. Hedefi sentezlediği kaynakları düğümün yazıldığı haliyle kimliğine göre değil, türettiği bir ada göre adlandıran bir konuk, böyle bir düğüm için o adı bildirir; böylece bir Recipe’in bu kaynaklardan biri için yayımladığı bir adres, kaynağın taşıdığı addan oluşturulabilir.

Ek özelliklere izin verilmez.

RenderedNameOutput

Bir Provider konuğunun rendered_name dışa aktarımından döndürdüğü yük: hedefinin düğüm için oluşturduğu kaynaklara verdiği ad (düğümün yazar tarafından sağlanan kaynağından ya da sentezlediği iş yükünden) veya hiç ad olmaması. Bulunmayan ya da boş bir ad, bir hata değil olumlu bir yanıttır; bu hedefin böyle bir ad türetmediğini söyler. Ana bilgisayar kendisine bildirileni okumadan kullanır, böylece hedefin adlandırmasına ilişkin hiçbir bilgi sınırı geçmez.

ÖzellikTürZorunluAçıklama
namestringhayırKonuğun bu düğümün yazar tarafından sağlanan kaynağını altında oluşturduğu ya da düğüm için sentezlediği kaynaklara verdiği ad; hedefinin o konumda kabul ettiği alfabeyle zaten yazılmış olarak. Boş ya da bulunmaması, konuğun böyle bir ad türetmediği anlamına gelir.
errorstringhayırKonuk çalıştığı ancak işlemi tamamlayamadığı zaman ayarlanan hata iletisi; başarı durumunda bulunmaz. Ad bildirmemekten farklıdır: ad olmaması hedef hakkında bir yanıttır, error ise sorunun kendisinin yanıtlanamadığını bildirir. Ana bilgisayar, mevcut bir hatayı başarısız bir plugin çağrısı olarak yansıtır.
condition_codestringhayırHatanın adlandırdığı koşulun açıklayıcı, makine tarafından eşleştirilebilir kimliği: koşulun kayıtlı olduğu kod; derleyicinin kendi durdurucu koşullarını kaydettiği aynı açık kümede. İnsan tarafından okunan hata iletisinin yanında ayarlanır; başarı durumunda ve konuk böyle bir koşul adlandırmadığında bulunmaz. Ana bilgisayar bu tanımlayıcıyı derleyicinin bildirdiği koşullara karşı çözümler ve çözümlenen koşulun kendi tanımlayıcılarını yapılandırılmış tanılamada yayımlar; böylece bir okuyucuya ulaşan kod her zaman çözümlenir. Böyle bir koşulu adlandırmayan ya da numaralandırmanın kullanımdan kaldırdığı bir tanımlayıcı derlemeyi durdurur. Adlandıracak kesin bir koşulu olmayan bir konuk, bunun yerine derleyicinin bu amaçla bildirdiği genel plugin hatası koşullarından birine başvurur ve ayrıntıları kendi iletisine koyar. Bu tanımlayıcı ve condition_short_code birlikte bildirilir, çünkü tek bir koşulu iki biçimde adlandırırlar: birini ayarlayıp diğerini ayarlamayan bir konuk, ana bilgisayarın çözümleyemeyeceği bir koşul adlandırmış olur; bu durumda ana bilgisayar onun yerine kendi genel plugin hatası koşulunu bildirir, ileti ise hatanın tamamını taşımaya devam eder.
condition_short_codestringhayırAynı koşulun kısa tanımlayıcısı: E harfi ve dört rakam; bir okuyucunun alıntıladığı, aradığı ve bir rapora yapıştırdığı biçim. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Ana makine bunu, bu hata için oluşturduğu tanılamanın köşeli parantezli başlığında yazdırır; böylece bir konuğun ortaya çıkardığı koşul, derleyicinin ortaya çıkardığı bir koşul gibi aynen alıntılanabilir. Ana makine değeri güvene dayanarak taşımak yerine derleyicinin bildirdiği koşullara karşı çözümler: böyle bir koşulu belirtmeyen bir değer, numaralandırmanın kullanımdan kaldırdığı bir değer ya da kaydın taşımadığı bir yazım derlemeyi durdurur ve sorunlu değeri alıntılar; konuğun kendi mesajı da yine bildirilir. Orada belirtilen nedenle condition_code ile birlikte bildirilir.

Ek özelliklere izin verilmez.

LinkEndpoint

Sınırlar arası bir bağlantının bir uç noktası: düğüm, oluşturulan çıktısının birleştirildiği sınır yolu ve onu oluşturan sağlayıcı. Bir bağlantının iki uç noktası, uçları farklı dağıtım gruplarında birleştirilen bir uses kenarının tüketen ve tüketilen uçlarını adlandırır.

ÖzellikTürZorunluAçıklama
nodestringevetUç nokta düğümünün topoloji grafiği içindeki mutlak kimliği.
boundarystringevetUç noktanın sınır yolu; oluşturulan çıktısının birleştirildiği dağıtım grubu.
providerstringevetUç noktayı oluşturan sağlayıcı (yalın sağlayıcı adı). Bağlanmış bir bağlantının her iki uç noktası da aynı sağlayıcıyı adlandırır; ana bilgisayar, uç noktaları farklı sağlayıcıları adlandıran bir bağlantıyı yönlendirmez.
releasestringhayırUç noktanın oluşturulan çıktısının ait olduğu Release; birleştirilmiş yapıtlarının içinde adlandırıldığı kapsam. Ana bilgisayar onu derlemenin çözümlediği Release’ten birleştirir ve olduğu gibi iletir; değerden hiçbir anlam çıkarmaz. Bir sağlayıcı, bir çapraz başvuru adını Release’e göre kapsamlandırmak için onu okur. Bulunmayan bir değer boş dizedir ve sağlayıcı bunu kapsamsız bir ad olarak ele alır.

Ek özelliklere izin verilmez.

LinkEdge

Ana bilgisayarın, tüketen ve tüketilen uçları farklı dağıtım gruplarında birleştirilen bir uses kenarı için birleştirdiği genelleştirilmiş, alandan bağımsız, kenar başına yük. Her iki uç noktayı, her iki uç noktanın yerleşim ek açıklamalarını ana bilgisayarın yorumlamadığı opak skaler eşlemler olarak, tüketilen uç noktanın provides çıktısını ve kenarın bağladığı soket ile inject eşlemesini taşır. Bir sağlayıcı, iki ucun ihtiyaç duyduğu sağlayıcıya özgü çapraz başvuru bağlantısını üretmek için onu okur; ana bilgisayar onu birleştirir ve ek açıklama eşlemini opak skalerler olarak iletir, hiçbir değerden anlam çıkarmaz.

ÖzellikTürZorunluAçıklama
sourceLinkEndpointevetTüketen uç nokta; yönlü uses kenarının kaynak ucu, tüketici tarafı bağlantının birleştirilmiş çıktısına enjekte edildiği uç.
targetLinkEndpointevetTüketilen uç nokta; uses kenarının işaret ettiği hedef uç, üretici tarafı bağlantının birleştirilmiş çıktısını yayımladığı uç.
target_annotationsstring eşlemihayırTüketilen (hedef) uç noktanın yerleşim ek açıklamaları; ek açıklama adına göre anahtarlanmış opak bir skaler eşlem olarak. Ana bilgisayar bunları hedefin çözümlenmiş ek açıklamalarından birleştirir ve olduğu gibi iletir; hiçbir değerden anlam çıkarmaz. Bir sağlayıcı, bir çapraz başvurunun nasıl biçimlendirileceğine karar vermek için bunları okur (örneğin iki ucun bir yerleşimi paylaşıp paylaşmadığı ya da yerleşimler arası bir başvuruya ihtiyaç duyup duymadığı). Anahtarlar sıralı düzende serileştirilir; böylece yük, aynı girdinin çalıştırmaları arasında bayt düzeyinde aynıdır.
source_annotationsstring eşlemihayırTüketen (kaynak) uç noktanın yerleşim ek açıklamaları; ek açıklama adına göre anahtarlanmış opak bir skaler eşlem olarak. Ana bilgisayar bunları kaynağın çözümlenmiş ek açıklamalarından birleştirir ve olduğu gibi iletir; hiçbir değerden anlam çıkarmaz. Bir sağlayıcı, iki ucun yerleşimini karşılaştırmak için bunları okur; örneğin kaynak ile hedefin bir yerleşimi paylaşıp paylaşmadığını ya da farklı yerleşimlerde bulunup bulunmadığını. Anahtarlar sıralı düzende serileştirilir; böylece yük, aynı girdinin çalıştırmaları arasında bayt düzeyinde aynıdır.
socketstringevetuses kenarının altında bağlandığı soket diğer adı.
providesstring eşlemievetTüketilen uç noktanın provides çıktısı; hedefin bildirilen çıktılarını sunan, yazar sıralı bir anahtar kümesi. Yazar sırasını korur; böylece yük, aynı girdinin çalıştırmaları arasında bayt düzeyinde aynıdır.
injectobjectevetTüketen uç noktanın inject eşlemesi; teslim mekanizmasına göre yazar sıralı bir anahtar kümesine anahtarlanmıştır ve tüketen ucun tüketilen uç noktanın çıktısını nasıl aldığını açıklar. Yazar sırasını korur; böylece yük, aynı girdinin çalıştırmaları arasında bayt düzeyinde aynıdır.
read_provides_keysstring[]hayırTüketilen uç noktanın provides çıktısının, tüketen uç noktanın şablonlarının .context.uses üzerinden doğrudan okuduğu anahtarları; inject eşlemesinin bunları da teslim edip etmemesinden bağımsız olarak, provides’ın yazar sırasıyla. Her girdi, provides’ın taşıdığı anahtarlardan biridir. Liste kenarla birlikte taşınır, böylece üretici tarafındaki yayımlama ve tüketici tarafındaki çözümleme tek bir listeyi okur. Tüketen uç nokta hiçbir provides anahtarını doğrudan okumadıysa bulunmaz; liste verilmeyen bir provider bağlantıyı tam olarak bu alan hiç yokmuş gibi bağlar.

Ek özelliklere izin verilmez.

LinkPatch

Bir sağlayıcının yapıt bağlantısı olarak döndürdüğü, dosya başına bir yapısal yama: çıktı dosyası ve ona uygulanacak sıralı yapısal işlemler. Sonraki bir ana bilgisayar geçişi, adlandırılan dosyayı ayrıştırır, işlemleri uygular ve dosyayı bayt düzeyinde aslına sadık olarak yeniden birleştirir. İşlem biçimi, paylaşılan işlem hattı yama işlemi sözcük dağarcığıdır; bu şema katmanında opaktır, bu nedenle konuk her işlemi olduğu gibi taşırken ana bilgisayar, işlem hattının uyguladığı türlü işlemi gerçekleştirir.

ÖzellikTürZorunluAçıklama
filestringevetİşlemlerin uygulandığı çıktı dosyası; sağlayıcının yaydığı biçimde adlandırılmış.
opsany[]evetDosyaya uygulanacak sıralı yapısal işlemler, uygulama sırasıyla.

Ek özelliklere izin verilmez.

LinkPublishInput

Bir provider’ın link_publish dışa aktarımında aldığı yük: tüketilen uç noktasının çıktısına bir sınır ötesinden başvurulan tek bir sınırlar arası bağlantı ve o uç noktanın birleştirilmiş dosyaları. Dışa aktarım, tüketicinin çözümlemede esas aldığı yayımlanmış kimliği ve tüketilen uç noktanın çıktısının gerektirdiği üretici tarafı yapıt bağlantılarını döndürür.

ÖzellikTürZorunluAçıklama
edgeLinkEdgeevetYayımlanan sınırlar arası bağlantı; tüketilen (hedef) uç noktanın tarafından okunur.
producer_filesRenderedFile[]hayırTüketilen uç noktanın birleştirilmiş dosyaları; böylece provider, o uç noktanın zaten bildirdiklerini okuyabilir ve yayımlamak üzere olduğu adları bunlarla karşılaştırabilir. Her biri disk üzerindeki yolunu adlandırır ve birleştirilmiş baytları taşır. Ana makinenin yayımlamaya verecek birleştirilmiş üretici çıktısı olmadığında bulunmaz; bağlantılarını oluşturmak için hiçbir belgeye ihtiyaç duymayan bir provider bunu yok sayar.

Ek özelliklere izin verilmez.

LinkPublishOutput

Bir provider’ın link_publish dışa aktarımından döndürdüğü yük: tüketicinin çözümlemede esas aldığı yayımlanmış kimlik tanıtıcısı ve tüketilen uç noktanın birleştirilmiş çıktısına uygulanacak üretici tarafı yapıt bağlantıları.

ÖzellikTürZorunluAçıklama
handlestring eşlemievetTüketilen uç noktanın, tüketicinin çözümlemede esas alması için sunduğu yayımlanmış kimlik; alan adına göre anahtarlanmış, opak, deterministik işaretçili bir string eşlemi (örneğin bir dışa aktarım adı, bir yığın adı, bir bölge, bir rol başvurusu). Değerler, derleyicinin ilettiği ve hiçbir zaman çözümlemediği deterministik işaretçi string’leridir; bunları dağıtım zamanında çalışma ortamı çözümler. Anahtarlar sıralı biçimde serileştirilir; böylece yük, özdeş girdinin çalıştırmaları arasında bayt bayt aynıdır.
patchesLinkPatch[]hayırÜretici tarafı yapıt bağlantıları; yayımlamanın düzenlemesi gereken tüketilen uç nokta çıktı dosyası başına bir yapısal yama. Tüketilen uç noktanın çıktısı bağlantı için hiçbir değişiklik gerektirmediğinde boştur.
errorstringhayırKonuk çalıştığı ancak bağlantıyı yayımlayamadığı durumda ayarlanan hata iletisi; başarı durumunda bulunmaz. Ana makine, mevcut bir hatayı başarısız bir plugin çağrısı olarak bildirir. İlerleyemeyen bir yayımlama — örneğin yığının başka bir girdi altında zaten bildirdiği bir dışa aktarım adı — yalnızca bir çökme olarak değil burada bildirilir; böylece arkasındaki koşul adlandırılabilir.
condition_codestringhayırHatanın belirttiği koşulun açıklayıcı, makinece eşleştirilebilir kimliği: koşulun kayıtlı olduğu kod; derleyicinin kendi durdurucu koşullarını kaydettiği aynı açık kümededir ve bir yanıt zarfının hostfunc_error_code alanının aldığı kapalı ana makine işlevi hata kodu kataloğunun bir üyesi değildir. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Duran bir konuk, mesajının belirttiği koşulun tanımlayıcısını burada bildirir; böylece bir tüketici, mesajı okuyarak bir kimlik çıkarmak yerine buna göre dallanır. Ana makine bu tanımlayıcıyı derleyicinin bildirdiği koşullara karşı çözümler ve çözümlenen koşulun kendi tanımlayıcılarını yapılandırılmış tanılamada yayımlar; böylece bir okuyucuya ulaşan kod her zaman çözümlenir. Böyle bir koşulu belirtmeyen ya da numaralandırmanın kullanımdan kaldırdığı bir tanımlayıcı derlemeyi durdurur. Belirtecek kesin bir koşulu olmayan bir konuk, bunun yerine derleyicinin bu amaçla bildirdiği genel eklenti hatası koşullarından birine başvurur ve ayrıntıları kendi mesajına koyar. Bu tanımlayıcı ve condition_short_code birlikte bildirilir, çünkü tek bir koşulu iki biçimde belirtirler: birini ayarlayıp diğerini ayarlamayan bir konuk, ana makinenin çözümleyemediği bir koşul belirtmiş olur; ana makine de bu durumda kendi genel eklenti hatası koşulunu bildirir, mesaj ise hatanın tamamını taşımaya devam eder.
condition_short_codestringhayırAynı koşulun kısa tanımlayıcısı: E harfi ve dört rakam; bir okuyucunun alıntıladığı, aradığı ve bir rapora yapıştırdığı biçim. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Ana makine bunu, bu hata için oluşturduğu tanılamanın köşeli parantezli başlığında yazdırır; böylece bir konuğun ortaya çıkardığı koşul, derleyicinin ortaya çıkardığı bir koşul gibi aynen alıntılanabilir. Ana makine değeri güvene dayanarak taşımak yerine derleyicinin bildirdiği koşullara karşı çözümler: böyle bir koşulu belirtmeyen bir değer, numaralandırmanın kullanımdan kaldırdığı bir değer ya da kaydın taşımadığı bir yazım derlemeyi durdurur ve sorunlu değeri alıntılar; konuğun kendi mesajı da yine bildirilir. Orada belirtilen nedenle condition_code ile birlikte bildirilir.

Ek özelliklere izin verilmez.

LinkResolveInput

Bir provider’ın link_resolve dışa aktarımında aldığı yük: tek bir sınırlar arası bağlantı, tüketilen uç noktasının sunduğu yayımlanmış kimlik tanıtıcısı ve tüketen uç noktanın birleştirilmiş dosyaları. Dışa aktarım, başvuruyu tüketen uç noktanın birleştirilmiş çıktısına enjekte eden tüketici tarafı yapıt bağlantılarını döndürür.

ÖzellikTürZorunluAçıklama
edgeLinkEdgeevetÇözümlenen sınırlar arası bağlantı; tüketen (kaynak) uç noktanın tarafından okunur.
handlestring eşlemievetTüketilen uç noktanın link_publish dışa aktarımının döndürdüğü ve tüketicinin başvurusunu çözümlemede esas aldığı yayımlanmış kimlik tanıtıcısı. Alan adına göre anahtarlanmış opak, deterministik işaretçi string’leri; derleyici bunları iletir ve hiçbir zaman çözümlemez. Anahtarlar sıralı biçimde serileştirilir; böylece yük, özdeş girdinin çalıştırmaları arasında bayt bayt aynıdır.
consumer_filesRenderedFile[]hayırTüketen uç noktanın birleştirilmiş dosyaları; böylece provider, ana makinenin tüketen çıktıya damgaladığı yer tutucuyu bulabilir ve onun yerine geçecek içeriği yer tutucunun gerçek yolunda oluşturabilir. Her biri disk üzerindeki yolunu adlandırır ve birleştirilmiş baytları taşır. Ana makinenin çözümlemeye verecek birleştirilmiş tüketici çıktısı olmadığında bulunmaz; bağlantılarını oluşturmak için hiçbir belgeye ihtiyaç duymayan bir provider bunu yok sayar.

Ek özelliklere izin verilmez.

LinkResolveOutput

Bir provider’ın link_resolve export’undan döndürdüğü yük: tüketen uç noktanın birleştirilmiş çıktısına uygulanacak, tüketilen uç noktanın yayımlanmış kimliğine başvuruyu enjekte eden tüketici tarafı yapıt bağlantısı.

ÖzellikTürZorunluAçıklama
patchesLinkPatch[]evetTüketici tarafı yapıt bağlantısı; resolve işleminin düzenlemesi gereken her tüketen uç nokta çıktı dosyası için bir yapısal yama.
errorstringhayırKonuk çalıştığı ancak bağlantıyı çözümleyemediği durumda ayarlanan hata iletisi; başarı durumunda yoktur. Ana makine, mevcut bir hatayı başarısız bir plugin çağrısı olarak bildirir. İlerleyemeyen bir resolve işlemi (örneğin hedefin yalnızca bütün bir skaler olarak taşıyabildiği bir başvurunun daha büyük bir string içinde bulunması) yalnızca bir çökme olarak değil burada bildirilir; böylece arkasındaki koşul adlandırılabilir.
condition_codestringhayırHatanın belirttiği koşulun açıklayıcı, makinece eşleştirilebilir kimliği: koşulun kayıtlı olduğu kod; derleyicinin kendi durdurucu koşullarını kaydettiği aynı açık kümededir ve bir yanıt zarfının hostfunc_error_code alanının aldığı kapalı ana makine işlevi hata kodu kataloğunun bir üyesi değildir. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Duran bir konuk, mesajının belirttiği koşulun tanımlayıcısını burada bildirir; böylece bir tüketici, mesajı okuyarak bir kimlik çıkarmak yerine buna göre dallanır. Ana makine bu tanımlayıcıyı derleyicinin bildirdiği koşullara karşı çözümler ve çözümlenen koşulun kendi tanımlayıcılarını yapılandırılmış tanılamada yayımlar; böylece bir okuyucuya ulaşan kod her zaman çözümlenir. Böyle bir koşulu belirtmeyen ya da numaralandırmanın kullanımdan kaldırdığı bir tanımlayıcı derlemeyi durdurur. Belirtecek kesin bir koşulu olmayan bir konuk, bunun yerine derleyicinin bu amaçla bildirdiği genel eklenti hatası koşullarından birine başvurur ve ayrıntıları kendi mesajına koyar. Bu tanımlayıcı ve condition_short_code birlikte bildirilir, çünkü tek bir koşulu iki biçimde belirtirler: birini ayarlayıp diğerini ayarlamayan bir konuk, ana makinenin çözümleyemediği bir koşul belirtmiş olur; ana makine de bu durumda kendi genel eklenti hatası koşulunu bildirir, mesaj ise hatanın tamamını taşımaya devam eder.
condition_short_codestringhayırAynı koşulun kısa tanımlayıcısı: E harfi ve dört rakam; bir okuyucunun alıntıladığı, aradığı ve bir rapora yapıştırdığı biçim. İnsana yönelik hata mesajının yanında ayarlanır; başarı durumunda bulunmaz ve konuk böyle bir koşul belirtmediğinde de bulunmaz. Ana makine bunu, bu hata için oluşturduğu tanılamanın köşeli parantezli başlığında yazdırır; böylece bir konuğun ortaya çıkardığı koşul, derleyicinin ortaya çıkardığı bir koşul gibi aynen alıntılanabilir. Ana makine değeri güvene dayanarak taşımak yerine derleyicinin bildirdiği koşullara karşı çözümler: böyle bir koşulu belirtmeyen bir değer, numaralandırmanın kullanımdan kaldırdığı bir değer ya da kaydın taşımadığı bir yazım derlemeyi durdurur ve sorunlu değeri alıntılar; konuğun kendi mesajı da yine bildirilir. Orada belirtilen nedenle condition_code ile birlikte bildirilir.

Ek özelliklere izin verilmez.