Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Schema del socket Wasm di rendering del Provider di Aggrega

Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.

Id dello schema: https://aggrega.ai/schemas/wasm-provider-v1beta1.schema.json

Le forme di trasmissione che un socket di plugin di rendering del Provider consuma ed emette. Un guest del Provider renderizza un nodo IR in file di output tramite la sua esportazione render_node (da RenderNodeInput a RenderNodeOutput) e, facoltativamente, fonde gli output per nodo di un confine in un unico artefatto assemblato tramite la sua esportazione assemble_boundary (da AssembleBoundaryInput ad AssembleBoundaryOutput). AssembleBoundaryOutput porta i file assemblati e le eventuali diagnostiche; la posizione dei file di ciascun contributore è dichiarata una sola volta nel contratto describe() del guest anziché in questa risposta. Un guest può anche dichiarare un’esportazione facoltativa validate_node_input che controlla strutturalmente l’input risolto di un nodo prima dello smistamento del rendering: consuma la stessa proiezione RenderNodeInput che riceve render_node e restituisce un ValidateNodeOutput che porta solo diagnostiche — una diagnostica di gravità halt arresta la build in modo esplicito, una diagnostica di gravità warn viene presentata nell’esito della build. Un guest la cui destinazione limita o restringe i nomi che accetta può anche dichiarare un’esportazione facoltativa name_bound, che l’host interroga prima di stabilire l’identità di componente di un nodo: consuma un NameBoundInput che porta un nome proposto e restituisce un NameBoundOutput che porta un verdetto per ogni tipo di nome che il guest ne deriverebbe. Un verdetto porta un vincolo — utilizzabile, oppure limitato a una lunghezza minore — e mai un nome costruito dal guest, così la conoscenza di ciò che la destinazione accetta resta nel guest. Separatamente, un guest la cui destinazione deriva un proprio nome per le risorse che renderizza — da un sorgente fornito dall’autore, o da un workload che sintetizza — può dichiarare un’esportazione facoltativa rendered_name, che l’host interroga affinché l’autore di una Recipe possa leggere quel nome e pubblicare un indirizzo costruito a partire da esso: consuma un RenderedNameInput che porta le identità da cui la destinazione deriva e i tipi di input che la Recipe del nodo dichiara, e restituisce un RenderedNameOutput che porta il nome con cui il guest stesso renderizzerà, oppure nessun nome dove non ne deriva alcuno. Le due esportazioni sono direzioni opposte di un unico argomento e nessuna delle due sostituisce l’altra — name_bound chiede al guest di giudicare un nome che l’host propone, mentre rendered_name riporta un nome che il guest ha composto, che l’host porta senza leggerlo. Un guest può anche dichiarare carve e reassemble, che suddividono il suo stesso output in unità indirizzabili per un passo di pipeline e ricongiungono le unità modificate tramite patch, e link_publish e link_resolve, che collegano un arco uses le cui estremità si assemblano in gruppi di smistamento diversi. La forma di ciascun payload è la definizione che la sua esportazione nomina: la tabella x-aggrega-exports associa ogni esportazione con cui l’host chiama un guest — carve e reassemble incluse — alla definizione del suo input e alla definizione del suo output, ciascuna come JSON Pointer nei $defs di questo documento, così uno strumento che convalida un payload vi cerca la sua definizione. La radice del documento non dichiara alcuna forma propria, perché un unico documento può essere un payload valido di più esportazioni (un oggetto vuoto è una risposta valida tanto da validate_node_input quanto da name_bound e rendered_name). Il guest restituisce i byte serializzati di ciascun file di output; l’host li scrive alla lettera e non esegue alcun serializzatore, quindi il determinismo è responsabilità del guest: un input identico deve produrre byte identici. I tipi di payload Go, Rust e TypeScript sono generati da questo schema nei pacchetti dell’ABI dei plugin, così i tre linguaggi leggono e scrivono lo stesso formato di trasmissione; un guest li importa da quei pacchetti, oppure tramite il suo kit per plugin dove il kit li riesporta.

Esportazioni

La tabella x-aggrega-exports dello schema associa ogni esportazione con cui l’host chiama un guest alla definizione del suo input e alla definizione del suo output. La forma di un payload è la definizione che la sua esportazione nomina.

EsportazioneInputOutput
render_nodeRenderNodeInputRenderNodeOutput
validate_node_inputRenderNodeInputValidateNodeOutput
assemble_boundaryAssembleBoundaryInputAssembleBoundaryOutput
carveCarveInputCarveOutput
reassembleReassembleInputReassembleOutput
name_boundNameBoundInputNameBoundOutput
rendered_nameRenderedNameInputRenderedNameOutput
link_publishLinkPublishInputLinkPublishOutput
link_resolveLinkResolveInputLinkResolveOutput

Definizioni

RenderNodeInput

Il payload che un guest del Provider riceve tramite la sua esportazione render_node: la proiezione IR per nodo che il guest renderizza, il contesto al momento del rendering, gli input pre-valutati che la Recipe legata al nodo dichiara — un elenco del sorgente acquisito, un workload, un insieme di artefatti — ciascuno presente solo quando quella Recipe lo dichiara, e le voci che nominano le unità renderizzate che il guest esclude dal rendering di un sorgente.

ProprietàTipoObbligatoriaDescrizione
nodeIRNodeProjectionsìI dati IR per nodo che un guest del Provider renderizza — una proiezione delimitata del nodo IR completo che porta l’identità per nodo e la provenienza che il guest marca su ogni manifest emesso: il suo id, il tipo, la ricetta risolta, i valori, se una mappatura dei valori ha prodotto quei valori, le associazioni di feature, la marcatura di sensibilità sulle sue chiavi renderizzate e sui valori nel loro insieme, gli archi uses in uscita, il percorso del confine, la sync wave, l’identità della Recipe, l’override dell’id del componente, la base del nome derivato e la provenienza della build. L’identità e la base del nome derivato sono portate separatamente perché rispondono a due domande — a che cosa appartiene una risorsa, e rispetto a che cosa viene renderizzato il sorgente proprio di un autore — e un’associazione di Feature che consegna un sorgente scritto dal suo autore è il punto in cui le due risposte differiscono. Il contenuto dei file sorgente non viene portato qui; viaggia separatamente nella proiezione del sorgente. Ogni insieme di chiavi qui ha un ordine fisso — features e uses nell’ordine dell’autore, values e la marcatura di sensibilità in ordine di chiave — così il payload trasmesso è identico byte per byte tra esecuzioni con input identico.
contextobjectsìIl contesto al momento del rendering che l’host passa al guest, portato come i byte del suo documento JSON; questo schema lascia l’oggetto non dichiarato. È il contesto che riceve un passo di pipeline dello stesso nodo, più la larghezza dell’indentazione: parameters, i valori dei parametri della Release ordinati per nome, assenti quando non ce ne sono; annotations, le annotazioni del nodo suddivise in base a dove ciascuna è stata scritta in aggregate, release e catalog, ciascuno assente quando è vuoto; boundary, il confine in cui si trova il nodo: name, path (i suoi segmenti), sync_wave (assente quando è 0), directory, sub_directory (assente quando non ce n’è uno) e annotations (l’insieme che i confini della Release propagano a cascata fino al nodo, con la voce propria del nodo nella Release applicata per ultima; assente quando è vuoto); e yaml_indent, la larghezza dell’indentazione valida per l’intero rendering con cui il guest serializza il proprio output. Il rendering di una FeatureRecipe con ambito di confine, che non ha alcun componente host, riceve il contesto che riceve il suo passo di pipeline, più yaml_indent: parameters; annotations che porta solo il contenitore release, che è l’insieme di annotazioni proprio del confine; e un boundary che porta il suo name, il suo path e quello stesso insieme come annotations. Le annotazioni ben note aggrega.ai/* vengono lette dal contenitore aggregate con il contenitore release scritto sopra, così una chiave presente in entrambi assume il valore della Release; un provider della libreria standard le legge da quell’insieme stratificato e mai dal contenitore catalog, così un valore del catalogo non ne decide mai una, e una FeatureRecipe con ambito di confine, il cui contesto non porta alcun contenitore aggregate, esegue il rendering in base ai valori del suo confine anziché a quelli di un qualsiasi componente.
source_listingSourceListingnoL’enumerazione generica del sorgente acquisito che l’host passa al guest per un provider con sorgente: la radice del sorgente, se quella radice è una directory, e le voci ordinate relative alla radice che si trovano al suo interno. Qui l’host non legge alcun contenuto di file — elenca solo nomi. Il guest applica la propria logica di risoluzione all’elenco e chiede all’host di impacchettare una selezione scelta tramite la funzione host pack-source, così tutta l’intelligenza di risoluzione del sorgente specifica di ciascun provider risiede nel guest. Presente per i provider con sorgente; assente altrimenti.
workload_projectionWorkloadProjectionnoIl workload pre-valutato che l’host passa al guest perché ne sintetizzi manifest nativi del provider; presente quando la Recipe legata dichiara un workload anziché un sorgente di chart, assente altrimenti.
artifacts_projectionArtifactsProjectionnoL’insieme di artefatti pre-valutato che l’host passa al guest perché lo collochi nell’output del nodo, presente quando la Recipe legata dichiara artefatti. L’host ha già letto il sorgente di ciascuna voce, l’ha valutato come template Go rispetto al contesto di rendering e ha calcolato gli insiemi di chiavi della provenienza della build; il guest decide il formato di output, la collocazione della provenienza, il percorso su disco e i byte finali. Assente quando il nodo non dichiara alcun artefatto.
omitsOmitEntry[]noLe voci che nominano le unità renderizzate che il guest esclude dall’output di questo nodo, nell’ordine in cui l’autore le ha dichiarate. Ogni voce arriva risolta, con i campi come semplici stringhe, e una voce che non si applica a questa build non viene portata. Ciò che selezionano kind, name, namespace e subchart di una voce è il contratto documentato proprio di questo provider, non di questo socket: il guest confronta ogni voce con ciò che ha renderizzato nei termini del proprio formato, esclude ogni unità a cui corrisponde una voce da tutto ciò che restituisce — i suoi file, i nomi che dichiara in derived_keys e i fatti che riporta in render_facts — e riporta in omitted dell’output a quante unità ha corrisposto ciascuna voce. Le voci accompagnano un elenco del sorgente e nessun altro input: un rendering di un workload sintetizzato o di un insieme di artefatti non le porta mai. Assente quando non ci sono voci, e un guest che non ne riceve alcuna renderizza esattamente come farebbe se il campo non esistesse.

Non sono consentite proprietà aggiuntive.

IRNodeProjection

I dati IR per nodo che un guest del Provider renderizza — una proiezione delimitata del nodo IR completo che porta l’identità per nodo e la provenienza che il guest marca su ogni manifest emesso: il suo id, il tipo, la ricetta risolta, i valori, se una mappatura dei valori ha prodotto quei valori, le associazioni di feature, la marcatura di sensibilità sulle sue chiavi renderizzate e sui valori nel loro insieme, gli archi uses in uscita, il percorso del confine, la sync wave, l’identità della Recipe, l’override dell’id del componente, la base del nome derivato e la provenienza della build. L’identità e la base del nome derivato sono portate separatamente perché rispondono a due domande — a che cosa appartiene una risorsa, e rispetto a che cosa viene renderizzato il sorgente proprio di un autore — e un’associazione di Feature che consegna un sorgente scritto dal suo autore è il punto in cui le due risposte differiscono. Il contenuto dei file sorgente non viene portato qui; viaggia separatamente nella proiezione del sorgente. Ogni insieme di chiavi qui ha un ordine fisso — features e uses nell’ordine dell’autore, values e la marcatura di sensibilità in ordine di chiave — così il payload trasmesso è identico byte per byte tra esecuzioni con input identico.

ProprietàTipoObbligatoriaDescrizione
idstringsìL’id assoluto del nodo all’interno del grafo della topologia.
typestringsìDichiarato e deliberatamente trattenuto: l’host lo emette sempre come stringa vuota. L’etichetta del tipo di componente del nodo è un metadato opaco anziché un interruttore di comportamento, quindi portarla qui inviterebbe soltanto un guest a ramificare in base a essa. Un guest legge una stringa vuota e non deve interpretarla come un nodo il cui tipo di componente non è impostato. (La forma del nodo di assemblaggio del confine porta un tipo proprio, per uno scopo diverso.)
resolved_recipestringsìDichiarato e deliberatamente trattenuto: l’host lo emette sempre come stringa vuota. L’identità della Recipe legata raggiunge già il guest come il nome e la versione della ricetta che il guest marca nella provenienza, quindi l’URI risolto non aggiunge nulla a partire da cui un guest renderizzi. Un guest che deve attribuire l’output a una Recipe legge invece quei campi di provenienza.
valuesobjectnoIl dizionario dei valori renderizzati del nodo, l’insieme di chiavi a partire da cui il guest renderizza. Le chiavi arrivano ordinate, non nell’ordine dell’autore, ed è questo ordinamento a rendere il payload identico byte per byte tra esecuzioni con input identico; un guest che ha bisogno di qualsiasi altro ordinamento lo impone da sé.
featuresobjectnoLe associazioni di feature del nodo indicizzate per alias della feature, che portano la stessa forma di associazione di feature per nodo che porta l’IR. Ogni voce porta i values, l’infra e la mappatura inject dell’associazione insieme alla sua marcatura di sensibilità derivata, così un guest legge dal solo payload se un’associazione gestisce materiale dichiarato sensibile. Conserva l’ordine dell’autore, così il payload è identico byte per byte tra esecuzioni con input identico. Opaca a questo livello dello schema; il guest legge la forma della voce di feature tramite il contratto di trasmissione dell’IR.
sensitive_rendered_keysmappa di stringnoChiavi renderizzate la cui identità è recuperata a partire da un dato che un autore ha dichiarato sensibile, ciascuna associata alla dichiarazione da cui ha ereditato quella sensibilità. Viaggia dall’host al guest sull’input di rendering — la direzione opposta rispetto ai nomi che un guest dichiara sull’output di rendering. Ciò che una chiave nomina segue la forma che questo payload porta: su un payload che porta i valori del nodo è una delle chiavi di quella mappa; su un payload che porta un workload nomina una voce nelle mappe di associazione proprie del workload, dove i valori del nodo sono vuoti. Una chiave è presente solo dove il recupero è esatto, collegando una dichiarazione a un’identità renderizzata senza leggere nulla dal testo proprio della chiave e senza distribuire su singole chiavi alcuna marcatura per nodo o per associazione. Una chiave inventata da un template è quindi assente, perché nessuna dichiarazione la nomina: le chiavi di output del valuesMapping di una ricetta, e il contenuto di un artefatto, sono scritti da template, quindi nessuno dei due produce una chiave qui — se un tale payload sia stato prodotto da un valore dichiarato sensibile è indicato invece da sensitive_values, e dal sensitive_content proprio di una voce di artefatto. L’assenza indica quindi che non è stato possibile recuperare l’identità di alcuna chiave, mai che nulla su questo payload porti materiale sensibile — un guest che legge una chiave assente come un permesso di mostrare o emettere un valore in chiaro l’ha letta al contrario. Le chiavi arrivano ordinate, ed è questo che rende il payload identico byte per byte tra esecuzioni con input identico.
sensitive_valuesbooleananoVero quando i valori che questo payload porta sono stati prodotti da un template che legge un valore che un autore ha dichiarato sensibile, o un valore ricondotto a uno di essi: il valuesMapping di una Recipe o di una FeatureRecipe, un unico template le cui chiavi e i cui valori di output sono una sua invenzione, così nessuna chiave di quell’output può essere ricondotta al dato da cui proviene e viene invece marcata l’intera mappa. Si ricava dai riferimenti propri del template confrontati con le dichiarazioni — un riferimento che raggiunge un valore dichiarato, il template che inoltra la totalità dei propri dati, o un template che non si riesce ad analizzare contano tutti — e mai dal contenuto di un valore o dal nome di una chiave. Un guest che compone un testo letto da una persona, un rifiuto o un avviso, tiene fuori da quel testo ogni valore dei valori del nodo quando questo è vero, e tiene fuori il valore sotto qualsiasi chiave nominata da sensitive_rendered_keys, che lo sia o meno: i due si compongono, uno nominando le chiavi la cui identità è recuperata esattamente e questo coprendo la mappa dove non ne è recuperabile alcuna. Assente quando nessun template di questo tipo ha letto un valore del genere, il che include i valori che sono essi stessi le foglie dichiarate, marcati invece per chiave in sensitive_rendered_keys, e assente su un payload che non porta valori. L’assenza non indica mai che nessun valore è sensibile.
values_mappedbooleananoVero quando i valori che questo payload porta sono l’output del valuesMapping della Recipe o della FeatureRecipe legata, anziché i valori del nodo passati così come l’autore li ha scritti. Un guest il cui contratto lega agli input che il suo sorgente dichiara solo i valori prodotti da una mappatura legge questo campo, e lascia non letti i valori scritti per qualcos’altro, come gli artefatti della Recipe; un guest che lega i valori del nodo al proprio sorgente in qualunque modo siano stati prodotti non lo legge. Registra come sono stati prodotti i valori e non viene mai derivato dal nome di una chiave o dal contenuto di un valore. Assente dove non è stato eseguito alcun valuesMapping, e su un payload che non porta valori.
usesmappa di string[]noDichiarato e deliberatamente trattenuto: l’host non lo popola mai, quindi la mappa è assente da ogni payload di rendering. Un arco in uscita viene consumato prima dello smistamento — i valori pubblicati dell’arco vengono reidratati nella pipe inject propria del nodo, che la Recipe ha già valutato nei valori e nel workload che il guest riceve — e un guest che assembla un confine riceve invece l’elenco degli archi sul proprio input. Se fosse popolato, indicizzerebbe gli archi uses in uscita del nodo per alias del socket, ciascuno con gli id ordinati dei nodi di destinazione di quel socket nell’ordine dell’autore.
boundary_pathstringnoIl percorso del confine del nodo, marcato come annotazione aggrega.ai/boundary-path su ogni manifest emesso che porta un blocco metadata.
sync_waveintegernoL’ondata di distribuzione ereditata dal confine che contiene questo nodo (valore predefinito 0; valori negativi consentiti), che porta il valore che il nodo IR contiene come sync_wave. Ciò che un guest ne fa è una sua scelta, e registrare il valore e ordinare in base a esso sono indipendenti anziché alternativi — un guest può fare l’una o l’altra cosa, entrambe o nessuna. Tra i provider della libreria standard: helm e helm-chart la emettono come annotazione argocd.argoproj.io/sync-wave su ogni risorsa renderizzata, e in aggiunta come helm.sh/hook-weight su una risorsa che il chart contrassegna già come hook di Helm; compose la registra come etichetta del servizio e ordina i servizi del file in cui esegue il rendering, tramite depends_on tra di essi; cloudformation ordina il provisioning dello stack assemblato, dichiarando che ogni risorsa di un’ondata dipende dalle risorse dell’ondata precedente; terraform ordina i blocchi di modulo della configurazione radice in cui un confine si assembla, dichiarando che ogni modulo di un’ondata dipende dai moduli dell’ondata precedente, e la registra anche con la provenienza della build del nodo.
recipe_namestringnoIl nome della Recipe legata, abbinato a recipe_version per formare l’annotazione aggrega.ai/recipe-uri; quando una delle due metà è vuota, l’annotazione non viene marcata.
recipe_versionstringnoLa versione della Recipe legata, abbinata a recipe_name per formare l’annotazione aggrega.ai/recipe-uri; quando una delle due metà è vuota, l’annotazione non viene marcata.
label_component_idstringnoL’identità di componente sicura per Kubernetes — ciò a cui APPARTIENE una risorsa che questo nodo emette, che è ciò che la provenienza registra e ciò che un selettore interroga. Quando non è vuota, sostituisce l’id del nodo come valore delle etichette app.kubernetes.io/name e aggrega.ai/component-id; vuota significa che l’id del nodo è già valido come etichetta e viene usato direttamente. Viene portata per ogni risorsa che un’associazione di Feature emette, in qualunque modo l’associazione la consegni, così le risorse di un’associazione sono distinguibili da quelle del suo componente host in base alla sola etichetta. Ciò da cui un guest deriva i propri nomi è portato separatamente, derived_name_basis, e i due rispondono a domande diverse.
derived_name_basisstringnoL’identità da cui un guest deriva i propri nomi — il nome della release che leggono i template di un installer di chart, in base al quale un guest di questo tipo può anche nominare le risorse che sintetizza per un componente, e il prefisso dei file che emette il rendering di un sorgente. Vuota significa che l’id del nodo viene usato direttamente, che è il valore per un componente ordinario e per un’associazione di Feature per componente: un’associazione che consegna un chart o un frammento scritto dal suo autore lo renderizza rispetto al nome del componente HOST, perché i template propri dell’autore nominano le risorse in base a quel nome e uno diverso rinominerebbe risorse già distribuite. Un nodo il cui id porta una sintassi di marcatore che l’alfabeto dei nomi di una destinazione rifiuta porta invece questo valore esplicitamente, così il nome che un guest deriva resta uno che la destinazione accetta. È deliberatamente separata da label_component_id: un guest che COSTRUISCE risorse per un’associazione di Feature anziché renderizzare il sorgente del suo autore le nomina in base all’identità, così le risorse proprie dell’associazione non possono entrare in collisione con quelle del suo host, mentre il nome rispetto a cui viene renderizzato il sorgente di un autore resta invariato. Le due portano lo stesso valore ovunque l’identità di un nodo sia anche ciò rispetto a cui viene renderizzato il suo sorgente.
output_labelsmappa di stringnoLe etichette di output dichiarate dall’autore della ricetta che il guest marca su ogni manifest emesso accanto alla provenienza dell’identità della build, indicizzate per nome dell’etichetta. Due blocchi scritti dall’autore confluiscono in quest’unica mappa: le coppie chiave-valore letterali che una ricetta scrive in outputLabels, e una voce per ogni chiave che una ricetta nomina in outputComponentLabels, il cui valore viene letto da quella chiave sulle etichette proprie del componente renderizzato — così un valore promosso segue il componente da cui proviene anziché essere ripetuto nella ricetta. Entrambi i blocchi sono disgiunti dallo spazio delle chiavi della provenienza per effetto della validazione al momento del caricamento (nessuna chiave aggrega.ai/ o app.kubernetes.io/), così la marcatura non entra mai in collisione con un’etichetta di provenienza. Una chiave promossa che il componente non dichiara non marca nulla e solleva un avviso anziché un’etichetta vuota. Un guest il cui output non è YAML di Kubernetes le traduce sulla propria superficie di etichette (etichette dei servizi Compose) oppure le ignora.
provenanceNodeProvenancesìLa provenienza dell’identità della build che il guest marca su ogni manifest emesso come etichette aggrega.ai.

Non sono consentite proprietà aggiuntive.

NodeProvenance

La provenienza dell’identità della build per un nodo — l’identità del compilatore, dell’aggregato e dell’ambiente che il guest marca su ogni manifest emesso come etichette aggrega.ai. Ogni campo viene omesso quando è vuoto, così un’identità parziale marca solo le etichette che porta.

ProprietàTipoObbligatoriaDescrizione
compiler_versionstringnoLa versione del compilatore, marcata come etichetta aggrega.ai/compiler-version quando non è vuota.
aggregate_namestringnoIl nome dell’aggregato, marcato come etichetta aggrega.ai/aggregate-name quando non è vuoto.
environmentstringnoIl nome dell’ambiente, marcato come etichetta aggrega.ai/environment quando non è vuoto.
provider_namestringnoIl tipo semplice del provider, marcato come etichetta aggrega.ai/provider quando non è vuoto.
provider_versionstringnoLa versione risolta del plugin di rendering del provider, marcata come etichetta aggrega.ai/provider-version quando non è vuota.

Non sono consentite proprietà aggiuntive.

RenderNodeOutput

Il payload che un guest del Provider restituisce dalla sua esportazione render_node: i byte serializzati di ciascun file di output che il guest ha emesso, i nomi che ha derivato in ciascuno dei propri spazi di chiavi, i fatti che riporta su ciò che ha emesso, a quante unità renderizzate ha corrisposto ciascuna voce omits che ha ricevuto, ed eventuali diagnostiche che il guest ha sollevato durante il rendering. Il guest restituisce i byte serializzati di ciascun file; l’host li scrive alla lettera e non esegue alcun serializzatore. Il determinismo è responsabilità del guest: un input identico deve produrre byte identici.

ProprietàTipoObbligatoriaDescrizione
filesRenderedFile[]sìI file di output che il guest ha emesso, in ordine di emissione. Ciascuno nomina il proprio percorso su disco e porta i byte serializzati che l’host scrive alla lettera.
derived_keysmappa di string[]noI nomi che il guest ha derivato durante il rendering di questo nodo, indicizzati per lo spazio di chiavi in cui li ha derivati, ciascuno spazio con i propri nomi in ordine di derivazione. Un guest che deriva il nome con cui il suo output indirizza una risorsa ha messo quel nome dentro i byte del file che l’host scrive alla lettera, dove l’host non può vederlo; dichiararlo qui è il modo in cui il guest chiede all’host di confermare che due derivazioni non siano finite sullo stesso nome. L’host confronta l’uguaglianza dei nomi dichiarati all’interno di uno spazio dichiarato e non fa nient’altro — non analizza un nome, non apprende che cosa significhi uno spazio o un nome, e non ne deriva mai uno da sé. Due contributori allo stesso output assemblato che dichiarano lo stesso nome nello stesso spazio arrestano la build, e l’arresto nomina lo spazio, il nome ed entrambi i contributori. Sia i nomi degli spazi sia i nomi al loro interno sono il vocabolario proprio del guest: un guest che vuole l’unicità su un ambito più ristretto o più ampio di un output assemblato esprime quell’ambito nel nome dello spazio che dichiara. Conserva l’ordine di dichiarazione, così il payload è identico byte per byte tra esecuzioni con input identico. Assente quando il guest non deriva nomi che vuole far controllare, il che lascia il controllo inerte per quel guest.
render_factsRenderFact[]noI fatti che il guest riporta su ciò che ha emesso per questo nodo, nell’ordine in cui il guest li elenca. Ogni fatto abbina un nome a un valore, ed entrambi sono il vocabolario proprio del guest: quali fatti un provider riporta, che cosa significa ciascun nome e che cosa contengono le sue voci fanno parte del contratto documentato di quel provider, non di questo socket. Il valore di ogni fatto è un elenco, anche quando contiene una sola voce: l’host rifiuta un fatto il cui valore è qualsiasi altra cosa, nominando il provider e il fatto, e arresta la build. È l’unica cosa che l’host apprende su un valore. Indicizza i fatti per nome e passa ciascun elenco ai template che lo leggono, unendo gli elenchi di uno stesso nome riportati da più di un rendering dello stesso nodo nell’ordine in cui quei rendering sono stati eseguiti, e non apprende mai che cosa significhino un nome o una voce né deriva da sé un fatto — così un provider può riportare qualcosa che solo la conoscenza del proprio formato può vedere, come una proprietà dei documenti che ha scritto, senza che l’host apprenda quel formato. Riportare fatti non cambia mai ciò che viene scritto: i file che l’host scrive sono i file che il guest ha restituito, che li accompagnino o meno dei fatti. Il guest elenca i propri fatti in un ordine fisso, così il payload è identico byte per byte tra esecuzioni con input identico. Assente quando il guest non riporta nulla, il che è una risposta completa anziché mancante.
omittedinteger[]noA quante unità renderizzate ha corrisposto ciascuna voce di omits dell’input: un conteggio per ogni voce che il guest ha ricevuto, nello stesso ordine, ciascuno pari al numero di unità a cui quella voce ha corrisposto, che un’altra voce vi abbia corrisposto o meno. Un conteggio pari a zero è una risposta completa — la voce non ha corrisposto a nulla di ciò che il guest ha renderizzato. I conteggi sono tutto ciò che il socket riporta indietro su ciò che è stato escluso: le unità stesse sono semplicemente assenti da ciò che il guest ha restituito. Assente quando il guest non ha ricevuto alcuna voce.
diagnosticsDiagnostic[]noDiagnostiche che il guest ha sollevato durante il rendering. Ogni elemento ha la forma di diagnostica condivisa dei plugin Wasm.
errorstringnoUn messaggio di errore impostato quando il guest è stato eseguito ma non ha potuto completare l’operazione; assente in caso di successo. È distinto da qualsiasi diagnostica portata dall’output: le diagnostiche riportano problemi trovati durante un’esecuzione che ha comunque prodotto un risultato, mentre error riporta che l’operazione stessa non è stata completata. L’host presenta un errore presente come un’invocazione del plugin non riuscita.
condition_codestringnoL’identità descrittiva e riconoscibile automaticamente della condizione che il fallimento nomina — il codice con cui la condizione è registrata, nello stesso insieme aperto in cui il compilatore registra le proprie condizioni di arresto, e non un membro del catalogo chiuso dei codici di errore delle funzioni host da cui attinge il valore hostfunc_error_code di una busta di risposta. Impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. Un guest che si arresta riporta qui l’identificatore della condizione che il suo messaggio nomina, così un consumatore si dirama su di esso anziché ricostruire un’identità leggendo il messaggio. L’host risolve questo identificatore rispetto alle condizioni che il compilatore dichiara e pubblica gli identificatori propri della condizione risolta sulla diagnostica strutturata, così un codice che raggiunge un lettore si risolve sempre; un identificatore che non nomina alcuna condizione di questo tipo, o uno che la numerazione ha ritirato, arresta la build. Un guest senza una condizione precisa da nominare ricorre invece a una delle condizioni generiche di fallimento dei plugin che il compilatore dichiara a questo scopo, e mette i dettagli nel proprio messaggio. Questo identificatore e condition_short_code vengono riportati insieme, perché nominano una sola condizione in due forme: un guest che imposta l’uno e non l’altro ha nominato una condizione che l’host non può risolvere, e l’host riporta allora la propria condizione generica di fallimento dei plugin mentre il messaggio porta ancora l’intero fallimento.
condition_short_codestringnoL’identificatore compatto della stessa condizione — la lettera E e quattro cifre, la forma che un lettore cita, cerca e incolla in una segnalazione — impostato accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host lo stampa nell’intestazione tra parentesi quadre della diagnostica che produce per questo fallimento, così una condizione che un guest solleva è citabile esattamente come una che solleva il compilatore. L’host risolve il valore rispetto alle condizioni che il compilatore dichiara anziché portarlo sulla fiducia: un valore che non nomina alcuna condizione di questo tipo, un valore che la numerazione ha ritirato, o una grafia che la registrazione non porta arresta la build e cita il valore in questione, con il messaggio proprio del guest ancora riportato. Viene riportato insieme a condition_code, per il motivo indicato lì.

Non sono consentite proprietà aggiuntive.

ValidateNodeOutput

Il payload che un guest del Provider restituisce dalla sua esportazione facoltativa validate_node_input: le diagnostiche sollevate da un controllo strutturale dell’input risolto del nodo. L’esportazione consuma la stessa proiezione RenderNodeInput che riceve render_node e non emette alcun file — riporta solo diagnostiche. Una diagnostica di gravità halt arresta la build in modo esplicito, nominando il nodo e il provider; una diagnostica di gravità warn o info viene presentata nell’esito della build senza modificare l’output renderizzato. Un elenco di diagnostiche vuoto significa che l’input ha superato il controllo strutturale.

ProprietàTipoObbligatoriaDescrizione
diagnosticsDiagnostic[]noDiagnostiche sollevate dal guest durante la convalida dell’input del nodo. Ogni elemento è la forma di diagnostica condivisa dei plugin Wasm. Vuoto quando l’input ha superato il controllo strutturale.
errorstringnoUn messaggio di errore impostato quando il guest è stato eseguito ma non ha potuto completare l’operazione; assente in caso di successo. È distinto da qualsiasi diagnostica portata dall’output: le diagnostiche riportano problemi trovati durante un’esecuzione che ha comunque prodotto un risultato, mentre error riporta che l’operazione stessa non è stata completata. L’host presenta un errore presente come un’invocazione del plugin non riuscita.
condition_codestringnoL’identità descrittiva e riconoscibile automaticamente della condizione che il fallimento nomina — il codice con cui la condizione è registrata, nello stesso insieme aperto in cui il compilatore registra le proprie condizioni di arresto, e non un membro del catalogo chiuso dei codici di errore delle funzioni host da cui attinge il valore hostfunc_error_code di una busta di risposta. Impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. Un guest che si arresta riporta qui l’identificatore della condizione che il suo messaggio nomina, così un consumatore si dirama su di esso anziché ricostruire un’identità leggendo il messaggio. L’host risolve questo identificatore rispetto alle condizioni che il compilatore dichiara e pubblica gli identificatori propri della condizione risolta sulla diagnostica strutturata, così un codice che raggiunge un lettore si risolve sempre; un identificatore che non nomina alcuna condizione di questo tipo, o uno che la numerazione ha ritirato, arresta la build. Un guest senza una condizione precisa da nominare ricorre invece a una delle condizioni generiche di fallimento dei plugin che il compilatore dichiara a questo scopo, e mette i dettagli nel proprio messaggio. Questo identificatore e condition_short_code vengono riportati insieme, perché nominano una sola condizione in due forme: un guest che imposta l’uno e non l’altro ha nominato una condizione che l’host non può risolvere, e l’host riporta allora la propria condizione generica di fallimento dei plugin mentre il messaggio porta ancora l’intero fallimento.
condition_short_codestringnoL’identificatore compatto della stessa condizione — la lettera E e quattro cifre, la forma che un lettore cita, cerca e incolla in una segnalazione — impostato accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host lo stampa nell’intestazione tra parentesi quadre della diagnostica che produce per questo fallimento, così una condizione che un guest solleva è citabile esattamente come una che solleva il compilatore. L’host risolve il valore rispetto alle condizioni che il compilatore dichiara anziché portarlo sulla fiducia: un valore che non nomina alcuna condizione di questo tipo, un valore che la numerazione ha ritirato, o una grafia che la registrazione non porta arresta la build e cita il valore in questione, con il messaggio proprio del guest ancora riportato. Viene riportato insieme a condition_code, per il motivo indicato lì.

Non sono consentite proprietà aggiuntive.

RenderedFile

Un file di output emesso da un guest del Provider: il suo percorso su disco relativo alla radice di output del nodo e i suoi byte serializzati esattamente come il guest li ha prodotti. L’host scrive questi byte alla lettera e non esegue alcun serializzatore, quindi l’output su disco è identico byte per byte a ciò che il guest ha emesso.

ProprietàTipoObbligatoriaDescrizione
pathstringsìIl percorso del file di output relativo alla radice di output del nodo (per esempio Chart.yaml o templates/deployment.yaml).
contentstringsìI byte serializzati del file esattamente come il guest li ha prodotti; l’host scrive questi byte alla lettera e non esegue alcun serializzatore, quindi l’output è identico byte per byte a ciò che il guest ha emesso. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.
formatstringnoIl formato in cui il guest dichiara che il file emesso è stato renderizzato, così l’host può instradare il file a un parser corrispondente. Assente quando il guest non dichiara alcun formato, nel qual caso l’host deduce il formato dall’estensione del file.

Non sono consentite proprietà aggiuntive.

RenderFact

Un fatto che un guest del Provider riporta su ciò che ha emesso per un nodo: un nome e un elenco di voci, entrambi definiti e documentati dal provider. L’host porta il fatto come il guest lo ha scritto, rifiuta un fatto il cui valore non è un elenco e non apprende nient’altro su nessuna delle due metà.

ProprietàTipoObbligatoriaDescrizione
namestringsìIl nome del fatto, tratto dal vocabolario documentato proprio del provider.
valuearraysìIl valore del fatto: un array JSON — sempre un elenco, anche con una sola voce o con nessuna — le cui voci sono valori JSON qualsiasi nella forma che il provider documenta per quel nome. Un elenco è ciò che permette a un nome di essere riportato da più di un rendering di un nodo: l’host unisce gli elenchi in uno solo. Viene portato come il documento JSON scritto dal guest, byte per byte, quindi l’ordine delle voci dell’elenco e delle chiavi di ciascun oggetto è quello proprio del guest.

Non sono consentite proprietà aggiuntive.

OmitEntry

Una voce che nomina le unità renderizzate che un guest del Provider esclude dall’output di un nodo, con i campi già risolti in semplici stringhe e marcati dove uno qualsiasi di essi è stato prodotto da un valore dichiarato sensibile. Il socket non attribuisce loro alcun significato: ogni provider documenta che cosa selezionano kind, name, namespace e subchart nel proprio formato, e li confronta da sé.

ProprietàTipoObbligatoriaDescrizione
kindstringsìIl tipo di unità renderizzata che la voce nomina, nel vocabolario proprio del provider.
namestringsìIl nome dell’unità renderizzata che la voce nomina, nel vocabolario proprio del provider.
namespacestringnoIl namespace in cui si trova l’unità nominata, per un provider il cui formato colloca le unità in un namespace. Assente quando l’autore non ne ha scritto alcuno; ciò a cui corrisponde una voce senza namespace è il contratto proprio del provider.
subchartstringnoIl sorgente annidato da cui proviene l’unità nominata, per un provider il cui sorgente è assemblato da sorgenti annidati, come un chart lo è dai suoi subchart. Assente quando l’autore non ne ha scritto alcuno; ciò a cui corrisponde una voce senza subchart, e ciò che un provider il cui sorgente non ha sorgenti annidati fa con una voce che ne nomina uno, è il contratto proprio del provider.
sensitivebooleananoVero quando il template che ha prodotto uno qualsiasi tra kind, name, namespace o subchart della voce legge un valore che un autore ha dichiarato sensibile, o un valore ricondotto a uno di essi. Viene letto dal template di ciascun campo confrontandolo con le dichiarazioni — un riferimento che raggiunge un valore dichiarato, il template che inoltra la totalità dei propri dati, o un template che non si riesce ad analizzare contano tutti — e mai dalle stringhe risolte. La marcatura copre l’intera voce anziché nominare il campo, quindi un guest tratta una voce marcata come tratta ogni altro valore marcato del proprio input: continua a confrontare e contare la voce in base ai suoi campi, che è lo scopo della voce, e tiene ogni suo campo fuori da qualsiasi testo letto da una persona — un rifiuto, un avviso o una riga di log. Assente quando il template di nessun campo legge un tale valore; l’assenza non afferma mai che nessun campo sia sensibile.

Non sono consentite proprietà aggiuntive.

SourceFile

Un file di una proiezione del sorgente pre-impacchettata: il suo percorso relativo alla radice del sorgente e i suoi byte grezzi, esattamente come l’host li ha letti dal sorgente locale in fase di compilazione.

ProprietàTipoObbligatoriaDescrizione
pathstringsìIl percorso del file relativo alla radice del sorgente (per esempio Chart.yaml o templates/deployment.yaml).
contentstringsìI byte grezzi del file esattamente come l’host li ha letti dal sorgente locale. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.

Non sono consentite proprietà aggiuntive.

SourceProjection

Il contenuto del sorgente impacchettato (per esempio i file di un chart Helm, ciascuno nominato dal proprio percorso relativo alla radice del sorgente, in ordine di attraversamento) che l’host legge e restituisce al guest in risposta a una richiesta pack-source, così il guest ricostruisce in memoria il sorgente selezionato e non tocca alcun filesystem. È il payload di successo della funzione host pack-source.

ProprietàTipoObbligatoriaDescrizione
filesSourceFile[]sìI file del sorgente, ciascuno nominato dal proprio percorso relativo alla radice del sorgente, nell’ordine di attraversamento deterministico dell’host.

Non sono consentite proprietà aggiuntive.

SourceEntry

Una voce di un elenco del sorgente: il suo percorso relativo alla radice del sorgente e se è una directory. L’host elenca solo nomi e non legge alcun contenuto, quindi una voce non porta alcun byte.

ProprietàTipoObbligatoriaDescrizione
pathstringsìIl percorso della voce relativo alla radice del sorgente, separato da barre (per esempio Chart.yaml o templates/deployment.yaml).
is_dirbooleanasìSe la voce è una directory. Un guest che risolve la radice di un chart o un singolo file sorgente all’interno dell’elenco legge questo campo per distinguere le directory dai file senza toccare il filesystem.

Non sono consentite proprietà aggiuntive.

SourceListing

L’enumerazione generica di un sorgente acquisito che l’host passa al guest di un provider con sorgente: la radice del sorgente, se quella radice è una directory, e le voci ordinate relative alla radice che si trovano al suo interno. L’host attraversa il sorgente acquisito senza alcuna conoscenza del dominio e non legge alcun contenuto di file — elenca solo nomi. Il guest applica la propria logica di risoluzione all’elenco (individuando la radice di un chart, selezionando un singolo documento compose, eseguendo il vendoring di un albero di moduli) e chiede all’host di impacchettare una selezione scelta tramite la funzione host pack-source. Le voci sono ordinate per percorso così l’elenco è identico byte per byte tra esecuzioni con input identico.

ProprietàTipoObbligatoriaDescrizione
rootstringsìLa posizione del sorgente acquisito che l’host ha enumerato. Il guest la riporta nelle proprie diagnostiche quando non riesce a risolvere il sorgente, così un arresto per risoluzione nomina il sorgente fornito dall’autore.
root_is_dirbooleananoSe la radice del sorgente acquisito è una directory. Falso per un sorgente costituito da un solo file (un documento compose isolato, un singolo file di modulo, un archivio), nel qual caso entries è vuoto e il guest impacchetta la radice stessa.
entriesSourceEntry[]sìLe voci relative alla radice sotto una radice del sorgente che è una directory, ordinate per percorso. Vuoto per una radice del sorgente costituita da un solo file.

Non sono consentite proprietà aggiuntive.

SourcePackRequest

La selezione che un guest chiede all’host di impacchettare dal sorgente acquisito tramite la funzione host pack-source. op nomina la forma della selezione e path la nomina rispetto alla radice del sorgente; l’host risolve il percorso sotto la radice del sorgente, rifiutando qualsiasi fuoriuscita al di sopra di essa, e restituisce i byte impacchettati come SourceProjection.

ProprietàTipoObbligatoriaDescrizione
opstring (enum)sìLa forma della selezione: file impacchetta il singolo file in path; dir impacchetta i file diretti della directory in path; tree impacchetta ricorsivamente l’intero sottoalbero con radice in path, nell’ordine di attraversamento deterministico dell’host. Valori consentiti: "file", "dir", "tree"
pathstringsìLa posizione della selezione relativa alla radice del sorgente, separata da barre. La stringa vuota (o ”.”) nomina la radice del sorgente stessa, quindi un sorgente costituito da un solo file viene impacchettato con un percorso vuoto.

Non sono consentite proprietà aggiuntive.

SourcePackResponse

La risposta della funzione host pack-source: in caso di successo il sorgente impacchettato, in caso di fallimento un messaggio di errore. Esattamente uno dei due campi è popolato. Il fallimento viene consegnato in banda anziché tramite trap, così un guest riporta un rifiuto della sandbox o un fallimento di lettura nelle proprie diagnostiche come un fallimento di rendering deterministico.

ProprietàTipoObbligatoriaDescrizione
source_projectionSourceProjectionnoIl sorgente impacchettato in caso di successo; assente in caso di fallimento.
errorstringnoIl messaggio di errore in caso di fallimento, che nomina la selezione e il motivo; assente in caso di successo.
hostfunc_error_codestring (enum)noL’identità del fallimento riconoscibile automaticamente in caso di fallimento, tratta dal catalogo chiuso dei codici di errore delle funzioni host, impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo. Quel catalogo è un vocabolario fisso che nomina i modi in cui una funzione host può fallire, ed è un vocabolario diverso dalle condizioni di arresto che il compilatore registra, i cui identificatori un guest riporta su un output di socket come condition_code e condition_short_code — il nome della chiave dice a quale dei due appartiene un valore, così i due non vengono mai letti come un unico insieme. Un guest si dirama su questo codice senza analizzare il messaggio, tollerando un codice assente (host più vecchio) o uno non riconosciuto (host più recente) ripiegando sul messaggio. Valori consentiti: "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"

Non sono consentite proprietà aggiuntive.

SourceFileRequest

La lettura del contenuto di un singolo file che un guest chiede all’host di eseguire tramite la funzione host read-source-file, per un guest la cui logica di risoluzione deve esaminare il contenuto di un file prima di scegliere che cosa impacchettare. L’host risolve il percorso sotto la radice del sorgente, rifiutando qualsiasi fuoriuscita al di sopra di essa, e restituisce i byte del file.

ProprietàTipoObbligatoriaDescrizione
pathstringsìLa posizione del file relativa alla radice del sorgente, separata da barre.

Non sono consentite proprietà aggiuntive.

SourceFileResponse

La risposta della funzione host read-source-file: in caso di successo i byte del file, in caso di fallimento un messaggio di errore. Esattamente uno dei due campi è popolato. Il fallimento viene consegnato in banda anziché tramite trap, così un guest riporta un rifiuto della sandbox o un fallimento di lettura nelle proprie diagnostiche come un fallimento di rendering deterministico.

ProprietàTipoObbligatoriaDescrizione
contentstringnoI byte grezzi del file in caso di successo; assenti in caso di fallimento. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.
errorstringnoIl messaggio di errore in caso di fallimento, che nomina il file e il motivo; assente in caso di successo.
hostfunc_error_codestring (enum)noL’identità del fallimento riconoscibile automaticamente in caso di fallimento, tratta dal catalogo chiuso dei codici di errore delle funzioni host, impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo. Quel catalogo è un vocabolario fisso che nomina i modi in cui una funzione host può fallire, ed è un vocabolario diverso dalle condizioni di arresto che il compilatore registra, i cui identificatori un guest riporta su un output di socket come condition_code e condition_short_code — il nome della chiave dice a quale dei due appartiene un valore, così i due non vengono mai letti come un unico insieme. Un guest si dirama su questo codice senza analizzare il messaggio, tollerando un codice assente (host più vecchio) o uno non riconosciuto (host più recente) ripiegando sul messaggio. Valori consentiti: "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"

Non sono consentite proprietà aggiuntive.

FetchExternalInputResponse

La risposta della funzione host fetch-external-input: in caso di successo il contenuto recuperato, in caso di fallimento un messaggio di errore e il relativo codice. Una risposta che non porta nessuno dei due campi di fallimento è un successo, quindi un payload di lunghezza zero è la risposta con ogni campo assente. Il fallimento viene consegnato in banda anziché tramite trap, così un guest riporta un URL non risolvibile o un fallimento del recupero nelle proprie diagnostiche come un fallimento di rendering deterministico. La richiesta è una semplice stringa URL anziché un payload strutturato, quindi solo la risposta ha una forma dichiarata.

ProprietàTipoObbligatoriaDescrizione
contentstringnoI byte grezzi del payload recuperato in caso di successo; assenti in caso di fallimento, e assenti quando il payload è vuoto. Nel formato di trasmissione i byte viaggiano come stringa di byte, mai come testo base64. Il kit Go li conserva come slice di byte; i kit Rust e TypeScript li conservano come stringa base64, che il wrapper di fetch di ciascun kit decodifica, così ogni wrapper restituisce i byte grezzi del payload.
errorstringnoIl messaggio di errore in caso di fallimento, che nomina l’URL e il rimedio; assente in caso di successo.
hostfunc_error_codestring (enum)noL’identità del fallimento riconoscibile automaticamente in caso di fallimento, tratta dal catalogo chiuso dei codici di errore delle funzioni host, impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo. Quel catalogo è un vocabolario fisso che nomina i modi in cui una funzione host può fallire, ed è un vocabolario diverso dalle condizioni di arresto che il compilatore registra, i cui identificatori un guest riporta su un output di socket come condition_code e condition_short_code — il nome della chiave dice a quale dei due appartiene un valore, così i due non vengono mai letti come un unico insieme. Un guest si dirama su questo codice senza analizzare il messaggio, tollerando un codice assente (host più vecchio) o uno non riconosciuto (host più recente) ripiegando sul messaggio. Valori consentiti: "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"

Non sono consentite proprietà aggiuntive.

WorkloadProjection

Il contenuto del workload pre-valutato che l’host passa a un guest del Provider perché il guest ne sintetizzi in memoria manifest nativi del provider, presente quando la Recipe legata dichiara un workload anziché un sorgente di chart. Il determinismo è responsabilità del guest: un input identico deve produrre byte identici.

ProprietàTipoObbligatoriaDescrizione
workloadobjectsìIl Workload valutato dall’host, successivo alla convalida, che il guest sintetizza; opaco a questo livello dello schema, così lo schema del socket non ridichiara il contratto dell’entità Workload.
sensitive_workloadbooleananoVero quando il template che ha prodotto workload legge un valore che un autore ha dichiarato sensibile, o un valore ricondotto a uno di essi. Viene letto dai riferimenti propri del template confrontandoli con le dichiarazioni — un riferimento che raggiunge un valore dichiarato, il template che inoltra la totalità dei propri dati, o un template che non si riesce ad analizzare contano tutti — e mai dal contenuto di alcun campo. I campi di un workload renderizzato non portano alcun collegamento ai dati letti dal suo template, quindi questo campo marca l’intero documento: un guest che compone un testo letto da una persona, un rifiuto o un avviso, tiene fuori da quel testo ogni valore portato dal workload quando questo campo è vero, mentre la forma del documento — le sue chiavi e il punto in cui si trova un valore — resta leggibile. Le voci di associazione che sensitive_rendered_keys della proiezione del nodo nomina sono marcate lì, che questo campo sia impostato o no. Assente quando il template non legge alcun valore di questo tipo; l’assenza non afferma mai che nessun campo sia sensibile.
attachment_providesobjectnoOgni associazione del nodo, proiettata sui suoi provides risolti e indicizzata per il nome di istanza dell’associazione che porta un riferimento di associazione del workload; assente quando il nodo non porta alcuna associazione. L’host copia le stringhe senza interpretarle, così il guest legge quali che siano le voci dei provides di un’associazione di cui ha bisogno per risolvere un riferimento alla risorsa prodotta da quell’associazione. Se un’associazione gestisce materiale dichiarato sensibile non viene ripetuto qui: viaggia sulla voce di feature corrispondente della proiezione del nodo, che un guest legge con lo stesso nome di istanza.

Non sono consentite proprietà aggiuntive.

ArtifactsProjection

L’insieme di artefatti pre-valutato che l’host passa a un guest del Provider perché lo collochi nell’output del nodo. L’host ha già risolto il sorgente di ciascuna voce (contenuto inline o un file importato che ha letto), l’ha valutato come template Go rispetto al contesto di rendering usando la coppia di delimitatori dei template di artefatto dichiarata dal guest, e ha calcolato gli insiemi di chiavi di etichette e annotazioni della provenienza della build. Il guest è responsabile della decisione sul formato, della collocazione della provenienza, del percorso su disco e dei byte finali. Le voci preservano l’ordine dell’autore così l’output collocato è identico byte per byte tra esecuzioni con input identico.

ProprietàTipoObbligatoriaDescrizione
entriesArtifactProjectionEntry[]sìLe voci di artefatto che il guest colloca, nell’ordine dell’autore.

Non sono consentite proprietà aggiuntive.

ArtifactProjectionEntry

Una voce di artefatto pre-valutata che l’host passa a un guest del Provider perché la collochi: il suo nome di output risolto dall’host, la sua origine, i byte del contenuto già valutati come template, se il template da cui provengono quei byte legge un valore dichiarato sensibile, e gli insiemi di chiavi di etichette e annotazioni della provenienza della build che l’host ha calcolato per il nodo. Il guest decide come collocare la provenienza (inserendola nei metadati di un manifest, anteponendola come commento o emettendo un file di accompagnamento) e dove finisce il file.

ProprietàTipoObbligatoriaDescrizione
namestringsìIl nome di output risolto dall’host per la voce: la chiave di mappa dichiarata dall’autore, con un file fornito da un bundle di libreria annidato sotto quella chiave. Il guest colloca la voce con questo nome o sotto un sottopercorso specifico del provider derivato da esso.
originstring (enum)sìSe la voce è stata scritta come contenuto inline o come file importato. Un guest che rifiuta una delle due forme (un provider di umbrella chart rifiuta il contenuto inline) legge questo campo per arrestarsi in modo esplicito. Valori consentiti: "inline", "import"
contentstringsìI byte del contenuto già valutati come template che l’host ha prodotto dal contenuto inline o dal file importato della voce, valutati rispetto al contesto di rendering usando la coppia di delimitatori dei template di artefatto dichiarata dal guest. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.
sensitive_contentbooleananoVero quando il template da cui è stato valutato il contenuto di questa voce legge un valore che un autore ha dichiarato sensibile, o un valore ricondotto a uno di essi. Viene letto dai riferimenti propri del template confrontandoli con le dichiarazioni, con la coppia di delimitatori con cui è stato valutato il contenuto — un riferimento che raggiunge un valore dichiarato, il template che inoltra la totalità dei propri dati, o un template che non si riesce ad analizzare contano tutti — e mai dal contenuto stesso. Il contenuto è l’output di quel template, quindi nulla al suo interno può essere ricondotto al dato da cui proviene: un guest che compone un testo letto da una persona, un rifiuto o un avviso, tiene ogni parte del contenuto fuori da quel testo quando questo campo è vero, compreso il messaggio proprio di un parser sul contenuto. È impostato per voce, quindi, se il template di una voce legge un tale valore, ciò non dice nulla su quello di un’altra. Assente quando il template non legge alcun valore di questo tipo; l’assenza non afferma mai che il contenuto non sia sensibile.
labelsobjectnoL’insieme di chiavi della provenienza della build sicuro per le etichette Kubernetes che l’host ha calcolato per il nodo, indicizzato per nome di etichetta. Un guest che marca la provenienza in metadata.labels di un manifest vi inserisce queste chiavi; un guest il cui output non è YAML di Kubernetes le ignora.
annotationsobjectnoL’insieme di chiavi della provenienza della build, calcolato dall’host per il nodo, che un’etichetta Kubernetes non può rappresentare, indicizzato per nome di annotazione. Un guest che marca la provenienza in metadata.annotations di un manifest vi inserisce queste chiavi; un guest il cui output non è YAML di Kubernetes le ignora.

Non sono consentite proprietà aggiuntive.

AssembleBoundaryInput

Il payload che un guest del Provider riceve tramite la sua esportazione assemble_boundary — l’esportazione che fonde gli output di rendering per nodo di un gruppo di smistamento in un unico artefatto assemblato (un umbrella chart, un file compose fuso). Porta gli output di rendering per nodo con le loro annotazioni fuse e le loro ondate di distribuzione, il percorso di output del gruppo di smistamento in cui finisce l’artefatto assemblato, gli archi uses del grafo per l’inferenza delle dipendenze per servizio, e il contesto al momento del rendering. Non tutti i provider dichiarano l’esportazione: i provider che emettono solo output piatto per nodo la omettono.

ProprietàTipoObbligatoriaDescrizione
rendered_nodesRenderedNode[]sìGli output di rendering per nodo che hanno alimentato questo gruppo di smistamento, in ordine di nodo.
contextobjectsìIl contesto al momento del rendering, portato come i byte del suo documento JSON. Su questa esportazione l’host imposta solo yaml_indent, la larghezza dell’indentazione valida per l’intero rendering con cui vengono serializzati i file assemblati; gli altri membri del contesto qui non portano nulla, perché un assemblaggio fonde contributori le cui annotazioni e i cui confini differiscono, e le annotazioni di ciascun contributore arrivano invece sulla sua voce di rendered_nodes.
boundary_pathstringsìIl percorso di output valutato del gruppo di smistamento in cui finisce l’artefatto assemblato; un assemblatore di confine lo usa come identità di ripiego a livello di confine (per esempio il nome della rete compose per un nodo che non porta alcuna annotazione namespace).
edgesRenderEdge[]noGli archi uses orientati del grafo, così un assemblatore di confine può dedurre l’ordinamento/le dipendenze per servizio tra i contributori del gruppo di smistamento (per esempio depends_on di compose).
sub_chartsSubChart[]noIl payload per sub-chart che un assemblatore di umbrella chart consuma per emettere una dipendenza e un ambito di valori per contributore. Ogni voce porta l’identità del sub-chart, i valori per istanza e, per un sub-chart incluso tramite vendoring da un sorgente di chart, i byte intatti del file Chart.yaml di quel chart. Presente per l’assemblaggio di umbrella chart; un assemblatore che fonde in modo piatto lo omette.
chart_namestringnoIl nome del chart che un assemblatore di umbrella chart usa per il chart assemblato quando viene fornito un nome per il gruppo di smistamento; vuoto quando l’assemblatore deriva il nome dal percorso di output del gruppo di smistamento.
aggregate_namestringnoIl nome dell’aggregato di primo livello che un assemblatore di umbrella chart incorpora nel nome derivato del chart assemblato; vuoto quando nessuna identità di aggregato contribuisce al nome.

Non sono consentite proprietà aggiuntive.

RenderedNode

L’output di rendering di un nodo così come compare in un input di assemble_boundary: l’id del nodo, il suo tipo, le sue annotazioni fuse, la sua sync wave, i valori che il compilatore ha risolto per esso dove spetta al compilatore fornirli e se li ha prodotti una mappatura dei valori, e i file che l’esportazione render_node ha prodotto per esso — portati nella forma dell’output di rendering, con ogni membro di quella forma diverso dai suoi file lasciato assente.

ProprietàTipoObbligatoriaDescrizione
idstringsìL’id assoluto del nodo all’interno del grafo della topologia. Un contributore che non è uno dei nodi del grafo — una Feature associata a un confine anziché a un componente — porta qui invece l’identità di smistamento propria del compilatore, che è la stessa identità portata dalla chiamata render_node per quel contributore; distingue un contributore da un altro e non è un nome che una destinazione accetti. Ciò da cui un tale contributore deriva i nomi all’interno dell’artefatto assemblato è un valore portato separatamente, derived_name_basis.
typestringsìL’etichetta del tipo di componente del nodo, portata su questa forma — a differenza della proiezione di rendering per nodo, che la trattiene. Metadato opaco anziché interruttore di comportamento: è qui perché un assemblatore possa raggruppare ed etichettare i nodi che fonde, non perché un guest possa ramificare in base a essa.
derived_name_basisstringnoL’identità da cui questo contributore deriva i propri nomi all’interno dell’artefatto assemblato — un id logico che un assemblatore conia per una delle voci pubblicate del contributore, un ambito per contributore in un documento fuso, il nome di un’unità figlia collocata in una posizione propria. Vuota significa che l’id viene usato direttamente, che è il valore per un componente ordinario. Un contributore il cui id è un’identità di smistamento che l’alfabeto dei nomi di una destinazione rifiuta porta questo valore esplicitamente, così l’artefatto assemblato indirizza il suo contenuto con un nome che la destinazione accetta, e due contributori che un autore sa distinguere non possono arrivare sotto un unico nome. Dove il contenuto del contributore viene incorporato in un documento che l’assemblatore fonde, questo è lo stesso valore portato che ha ricevuto la chiamata render_node per quel contributore, e portarlo su entrambi è ciò che mantiene uguali le due risposte: un nome che il contributore ha dichiarato durante il rendering e il nome con cui il documento fuso indirizza quel contenuto derivano da un’unica identità anziché da due che si trovano a coincidere. Dove invece il contributore è collocato in una posizione propria, questa è l’identità composta per quel contributore — per una Feature associata a un componente, la propria anziché quella del componente host rispetto a cui è stato eseguito il suo rendering — così un’unità figlia collocata accanto al suo host viene indirizzata separatamente da esso.
output_directorystringnoLa directory in cui si trovano i file renderizzati di questo contributore, relativa alla posizione propria dell’artefatto assemblato, senza separatore finale. Un guest che deve nominare i file di un contributore dall’interno dell’artefatto assemblato — il percorso sorgente di un blocco di modulo, una direttiva include — legge la posizione da qui anziché comporne una a partire dall’identità del contributore, così il percorso a cui punta l’artefatto assemblato è il percorso in cui i file sono stati scritti. I due non distano sempre una sola directory: un contributore che l’host ha collocato all’interno della posizione di un altro contributore si trova più in profondità dei contributori collocati direttamente sotto l’assemblaggio. Presente solo dove il provider che esegue l’assemblaggio colloca ogni contributore in una posizione propria; un provider che incorpora i propri contributori in un unico documento non colloca alcuna directory per contributore e non ne riceve alcuna.
renderedRenderNodeOutputsìIl payload che un guest del Provider restituisce dalla sua esportazione render_node: i byte serializzati di ciascun file di output che il guest ha emesso, i nomi che ha derivato in ciascuno dei propri spazi di chiavi, i fatti che riporta su ciò che ha emesso, a quante unità renderizzate ha corrisposto ciascuna voce omits che ha ricevuto, ed eventuali diagnostiche che il guest ha sollevato durante il rendering. Il guest restituisce i byte serializzati di ciascun file; l’host li scrive alla lettera e non esegue alcun serializzatore. Il determinismo è responsabilità del guest: un input identico deve produrre byte identici.
annotationsmappa di stringnoLe annotazioni fuse del nodo, così un assemblatore di confine può attribuire la collocazione per nodo (per esempio la rete compose derivata dall’annotazione aggrega.ai/namespace).
sync_waveintegernoL’ondata di distribuzione ereditata dal confine che contiene questo nodo (valore predefinito 0; valori negativi consentiti), così un assemblatore di confine può ordinare l’uno rispetto all’altro i contributori che fonde. Un gruppo di smistamento può fondere contributori di più confini, ciascuno con la propria ondata, quindi l’ondata viaggia qui con ogni nodo anziché una sola volta per l’intero payload. Un assemblatore la cui forma di output non esprime alcun ordinamento la ignora.
valuesobjectnoI valori che il compilatore ha risolto per questo nodo, presenti solo per un nodo renderizzato da un sorgente — la chiamata render_node che ha prodotto i suoi file portava un source_listing. È l’unico caso in cui i file provengono da altrove e i valori non potevano essere scritti al loro interno, quindi deve fornirli una posizione esterna a essi: un assemblatore di confine colloca un dizionario presente come input di quel contributore nell’artefatto assemblato stesso, anziché accanto ai file propri del contributore, e dove l’artefatto assemblato è l’unica posizione che la destinazione valuta, questa è la differenza tra un input che la destinazione legge e uno che non raggiunge mai. Un nodo renderizzato da un workload_projection o da un artifacts_projection ha risolto questi valori nei file che ha prodotto, quindi qui non ne porta alcuno e il campo è assente: fornirli una seconda volta offrirebbe all’artefatto assemblato input che i file propri di quel nodo non dichiarano mai, e che la destinazione è libera di rifiutare. Le chiavi arrivano ordinate, non nell’ordine dell’autore, ed è questo ordinamento a rendere il payload identico byte per byte tra esecuzioni con input identico; un guest che ha bisogno di qualsiasi altro ordinamento lo impone da sé. Un assemblatore la cui forma di output non porta input per contributore ignora il campo.
values_mappedbooleananoVero quando i valori che questo nodo porta sono l’output del valuesMapping della sua Recipe o FeatureRecipe legata (la Recipe di un componente, la FeatureRecipe di una Feature associata), anziché i valori del nodo passati così come l’autore li ha scritti — la stessa marcatura che la chiamata render_node per questo nodo portava sulla sua proiezione del nodo, portata qui accanto ai valori che descrive. Assente dove non è stato eseguito alcun valuesMapping, e ovunque values sia assente. Se un assemblatore lo legga è il contratto proprio di quell’assemblatore: uno il cui render_node lega i valori di un nodo mappato agli input che il suo sorgente dichiara può apprendere da esso quali nomi quel legame ha riempito, mentre uno che colloca i valori di un nodo come suoi input in qualunque modo siano stati prodotti non lo legge. Registra come sono stati prodotti i valori e non viene mai derivato dal nome di una chiave o dal contenuto di un valore.

Non sono consentite proprietà aggiuntive.

RenderEdge

Un arco uses orientato del grafo, nominato dai suoi due id di nodo: source è il nodo consumatore e target quello consumato. L’elenco porta ogni arco uses del grafo, quindi ciascuna delle due estremità può essere un nodo esterno a questo gruppo di smistamento.

ProprietàTipoObbligatoriaDescrizione
sourcestringsìL’id del nodo consumatore — l’estremità source di un arco uses orientato.
targetstringsìL’id del nodo consumato — l’estremità target a cui punta un arco uses orientato.

Non sono consentite proprietà aggiuntive.

SubChart

Un sub-chart che contribuisce a un umbrella chart: la sua identità di istanza, la versione che l’umbrella fissa, i valori per istanza che l’umbrella colloca sotto l’alias del sub-chart e, per un sub-chart incluso tramite vendoring da un sorgente di chart, i byte intatti del file Chart.yaml di quel chart. Un assemblatore di umbrella chart costruisce le dipendenze e il file dei valori dell’umbrella solo a partire da queste viste di dati puri e non tocca alcun filesystem.

ProprietàTipoObbligatoriaDescrizione
instance_idstringsìL’identità di istanza del sub-chart all’interno del gruppo di smistamento; l’umbrella colloca sotto di essa l’alias di dipendenza del sub-chart e i suoi valori, così più istanze di uno stesso chart sorgente restano distinte.
versionstringnoLa versione che l’umbrella fissa per il sub-chart. Un sub-chart incluso tramite vendoring da un sorgente di chart ricava invece il nome e la versione della propria dipendenza dal file Chart.yaml di quel chart, così la dipendenza si lega; questo valore si applica a un sub-chart generativo che non porta alcun chart incluso tramite vendoring.
valuesobjectnoI valori per istanza che l’umbrella colloca sotto l’alias del sub-chart nel file values.yaml dell’umbrella. Le chiavi arrivano ordinate, non nell’ordine dell’autore, ed è questo ordinamento a rendere il payload identico byte per byte tra esecuzioni con input identico; un guest che ha bisogno di qualsiasi altro ordinamento lo impone da sé.
chart_yamlstringnoI byte intatti del Chart.yaml del chart incluso tramite vendoring, letti dal sorgente locale in fase di compilazione, da cui l’umbrella ricava il nome e la versione della dipendenza del sub-chart. Vuoto per un sub-chart generativo che non porta alcun chart incluso tramite vendoring. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.

Non sono consentite proprietà aggiuntive.

AssembleBoundaryOutput

Il payload che un guest del Provider restituisce dalla sua esportazione assemble_boundary: i byte serializzati di ciascun file assemblato ed eventuali diagnostiche che il guest ha sollevato durante l’assemblaggio. Dove si trovano i file per nodo del gruppo assemblato non fa parte di questa risposta — è una proprietà statica del provider, dichiarata una sola volta nel suo contratto describe() e disponibile prima che venga renderizzato qualsiasi nodo. Il guest restituisce i byte serializzati di ciascun file; l’host li scrive alla lettera e non esegue alcun serializzatore. Il determinismo è responsabilità del guest: un input identico deve produrre byte identici.

ProprietàTipoObbligatoriaDescrizione
filesRenderedFile[]sìI file di output assemblati che il guest ha emesso, in ordine di emissione. Ciascuno nomina il proprio percorso su disco e porta i byte serializzati che l’host scrive alla lettera.
diagnosticsDiagnostic[]noDiagnostiche che il guest ha sollevato durante l’assemblaggio. Ogni elemento è la forma di diagnostica condivisa dei plugin Wasm.
errorstringnoUn messaggio di errore impostato quando il guest è stato eseguito ma non ha potuto completare l’operazione; assente in caso di successo. È distinto da qualsiasi diagnostica portata dall’output: le diagnostiche riportano problemi trovati durante un’esecuzione che ha comunque prodotto un risultato, mentre error riporta che l’operazione stessa non è stata completata. L’host presenta un errore presente come un’invocazione del plugin non riuscita.
condition_codestringnoL’identità descrittiva e riconoscibile automaticamente della condizione che il fallimento nomina — il codice con cui la condizione è registrata, nello stesso insieme aperto in cui il compilatore registra le proprie condizioni di arresto, e non un membro del catalogo chiuso dei codici di errore delle funzioni host da cui attinge il valore hostfunc_error_code di una busta di risposta. Impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. Un guest che si arresta riporta qui l’identificatore della condizione che il suo messaggio nomina, così un consumatore si dirama su di esso anziché ricostruire un’identità leggendo il messaggio. L’host risolve questo identificatore rispetto alle condizioni che il compilatore dichiara e pubblica gli identificatori propri della condizione risolta sulla diagnostica strutturata, così un codice che raggiunge un lettore si risolve sempre; un identificatore che non nomina alcuna condizione di questo tipo, o uno che la numerazione ha ritirato, arresta la build. Un guest senza una condizione precisa da nominare ricorre invece a una delle condizioni generiche di fallimento dei plugin che il compilatore dichiara a questo scopo, e mette i dettagli nel proprio messaggio. Questo identificatore e condition_short_code vengono riportati insieme, perché nominano una sola condizione in due forme: un guest che imposta l’uno e non l’altro ha nominato una condizione che l’host non può risolvere, e l’host riporta allora la propria condizione generica di fallimento dei plugin mentre il messaggio porta ancora l’intero fallimento.
condition_short_codestringnoL’identificatore compatto della stessa condizione — la lettera E e quattro cifre, la forma che un lettore cita, cerca e incolla in una segnalazione — impostato accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host lo stampa nell’intestazione tra parentesi quadre della diagnostica che produce per questo fallimento, così una condizione che un guest solleva è citabile esattamente come una che solleva il compilatore. L’host risolve il valore rispetto alle condizioni che il compilatore dichiara anziché portarlo sulla fiducia: un valore che non nomina alcuna condizione di questo tipo, un valore che la numerazione ha ritirato, o una grafia che la registrazione non porta arresta la build e cita il valore in questione, con il messaggio proprio del guest ancora riportato. Viene riportato insieme a condition_code, per il motivo indicato lì.

Non sono consentite proprietà aggiuntive.

CarveInput

Il payload che un guest del Provider riceve tramite la sua esportazione facoltativa carve: un file di output nominato che la pipeline suddivide in unità indirizzabili prima che un passo di una FeatureRecipe ne modifichi alcune. Un provider la cui forma di output non può essere suddivisa direttamente dal codec YAML standard (un chart basato su template, per esempio) dichiara carve e reassemble, così la conoscenza della forma del proprio output risiede nel guest; un provider che omette le esportazioni ricorre al codec YAML standard dell’host.

ProprietàTipoObbligatoriaDescrizione
namestringsìIl nome del file di output, così il codec può applicare qualsiasi regola di suddivisione legata al nome.
bodystringsìI byte del file di output da suddividere in unità indirizzabili. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.
yaml_indentintegernoLa larghezza dell’indentazione che il codec usa quando deve sintetizzare nuovo testo strutturato; portata così la suddivisione del guest corrisponde all’indentazione valida per l’intero rendering.

Non sono consentite proprietà aggiuntive.

CarveOutput

Il payload che un guest del Provider restituisce dalla sua esportazione carve: le unità indirizzabili ordinate in cui ha suddiviso il file. Un’unità strutturata porta un albero (una destinazione di PATCH); un’unità opaca porta solo il suo tipo di media e i suoi byte.

ProprietàTipoObbligatoriaDescrizione
unitsobject[]sìLe unità indirizzabili ordinate in cui il guest ha suddiviso il file.

Non sono consentite proprietà aggiuntive.

ReassembleInput

Il payload che un guest del Provider riceve tramite la sua esportazione facoltativa reassemble: il file originale più le sue unità suddivise e le unità modificate tramite patch prodotte da un passo di pipeline, così il guest reinserisce chirurgicamente le modifiche nei byte originali. Un token assente dall’insieme modificato viene ricongiunto alla lettera a partire dai suoi byte originali; di un token modificato vengono modificati solo gli intervalli di byte indirizzati.

ProprietàTipoObbligatoriaDescrizione
namestringsìIl nome del file di output, corrispondente al nome con cui lo stesso file è stato suddiviso.
bodystringsìI byte del file originale in cui il riassemblaggio reinserisce le unità modificate. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.
segsobject[]noLe unità in cui il file è stato suddiviso, come le ha restituite carve.
patchedobject[]noLe unità che un passo di pipeline ha modificato, ciascuna con il proprio token, l’albero modificato e le ops che hanno prodotto la modifica.
yaml_indentintegernoLa larghezza dell’indentazione che il codec usa quando un’op deve sintetizzare nuovo testo strutturato; portata così il riassemblaggio corrisponde all’indentazione valida per l’intero rendering.

Non sono consentite proprietà aggiuntive.

ReassembleOutput

Il payload che un guest del Provider restituisce dalla sua esportazione reassemble: i byte del file con le unità modificate reinserite. Il riassemblaggio è fedele al byte — ogni byte che le ops non hanno toccato sopravvive alla lettera.

ProprietàTipoObbligatoriaDescrizione
bodystringsìI byte del file riassemblato che l’host scrive alla lettera. Ogni kit li porta nel proprio tipo di campo — grezzi dove quel tipo è un tipo di byte, codificati in base64 dove è una stringa che il guest decodifica per recuperarli — e l’encoder generato converte tra il campo e la forma in cui il formato di trasmissione porta i byte.

Non sono consentite proprietà aggiuntive.

NameBoundInput

Il payload che un guest del Provider riceve tramite la sua esportazione facoltativa name_bound: un nome che l’host propone di usare come identità di componente di un nodo, perché il guest lo giudichi rispetto a ogni nome che ne deriverebbe per la propria destinazione, insieme ai fatti del workload risolto del nodo da cui dipendono alcuni di quei nomi, quando l’identità viene stabilita dopo la risoluzione di quel workload. Il guest risponde con un vincolo anziché con un nome proprio — un nome derivato che tornasse indietro metterebbe l’host nella posizione di comporre nomi per una destinazione di cui non sa nulla, che è esattamente ciò che porre la domanda elimina. Un provider la cui destinazione limita o restringe i nomi che accetta dichiara l’esportazione; un provider la cui destinazione accetta qualsiasi nome la omette e non viene mai interpellato, e il suo rendering resta invariato.

ProprietàTipoObbligatoriaDescrizione
proposedstringsìIl nome che l’host propone come identità di componente del nodo. Il guest ne deriva, in memoria, ogni nome che deriva da un’identità di componente e riporta se ciascuno è un nome che la sua destinazione accetta. Un verdetto riguarda la PROPOSTA anziché il nodo: l’host pone una sola domanda ovunque componga un’identità, e non dice di quali nomi di quel nodo questa identità finirà per essere la base, quindi un guest risponde come se fosse la base di tutti. È la direzione conservativa, perché l’host si limita ad accorciare in base alla risposta e non allunga mai — un nome che il nodo deriverà di fatto da qualche altro valore portato viene quindi giudicato in modo troppo severo anziché troppo permissivo.
authoredbooleananoSe il nome proposto è uno scritto da una persona anziché uno che il compilatore ha composto a partire da parti scritte dall’autore. Viene portato perché un guest possa formulare la propria motivazione per il lettore in grado di agire di conseguenza. Non decide che cosa fa un rifiuto: un nome scritto dall’autore viene rifiutato e uno composto viene accorciato, e quella decisione spetta all’host.
workload_formstringnoLa forma del workload in cui si risolve la Recipe o la FeatureRecipe del nodo, così come l’ha prodotta il suo template di workload, trasportata quando l’identità viene stabilita dopo la risoluzione di quel workload e il workload indica una forma. Viene trasportata così come è scritta; l’host non la interpreta. Un guest la cui destinazione limita un nome che emette per una sola forma — un job pianificato, il cui nome la destinazione vuole più corto degli altri suoi nomi perché vi si aggiunge un suffisso a ogni esecuzione — la legge per giudicare quel nome. Assente significa che l’host non trasporta alcuna forma per questa domanda: il nodo non dichiara alcun workload, il suo workload non ne indica nessuna, oppure l’identità viene stabilita prima che venga risolto qualsiasi workload. Un guest allora non giudica alcun nome che dipenda dalla forma, e risponde esattamente come farebbe se il campo non esistesse.
service_keysstring[]noLe chiavi dei Service che il workload risolto del nodo dichiara, nell’ordine in cui il workload le dichiara, trasportate quando l’identità viene stabilita dopo la risoluzione di quel workload e il workload ne dichiara almeno uno. Un guest la cui destinazione nomina ogni Service che emette per il nodo a partire dall’identità del componente e dalla chiave del Service le legge per giudicare ciascuno di quei nomi. Una chiave è scritta dall’autore della Recipe o della FeatureRecipe anziché da chi ha scritto l’identità, quindi un guest formula anche per quell’autore un rifiuto causato da una chiave. Assente significa che l’host non trasporta alcuna chiave per questa domanda: il nodo non dichiara alcun workload, il suo workload non dichiara alcun Service, oppure l’identità viene stabilita prima che venga risolto qualsiasi workload. Un guest allora non giudica alcun nome costruito da una chiave di Service, e risponde esattamente come farebbe se il campo non esistesse.

Non sono consentite proprietà aggiuntive.

DerivedNameVerdict

Il verdetto di un tipo di nome su un’identità proposta: se il nome che il guest deriverebbe per quel tipo è uno che la sua destinazione accetta e — dove un’identità più corta sarebbe accettata — la lunghezza massima che lo sarebbe. Porta un vincolo e una motivazione, mai un nome costruito dal guest.

ProprietàTipoObbligatoriaDescrizione
kindstringsìIl nome proprio del guest per il tipo di nome che questo verdetto copre, scritto nel vocabolario della destinazione anziché in quello del compilatore — il nome della release di un installer di chart, il nome del servizio di un orchestratore di container. Raggiunge un lettore alla lettera in un rifiuto, quindi è scritto per qualcuno che conosce la destinazione.
usablebooleanasìSe il nome che il guest deriverebbe per questo tipo dall’identità proposta è uno che la destinazione accetta.
boundintegernoIl numero massimo di caratteri che un’identità proposta può portare affinché il nome derivato di questo tipo sia uno che la destinazione accetta. Presente solo su un rifiuto che un’identità più corta soddisferebbe. ASSENTE significa che la lunghezza non è ciò a cui la destinazione ha obiettato — o non esiste alcun limite di lunghezza, oppure l’obiezione è una che nessun accorciamento ripara, come un carattere che la grammatica della destinazione rifiuta nella posizione in cui è finito. L’assenza è quindi distinta da un limite pari a zero, che invece afferma una lunghezza: che nessuna identità di alcuna lunghezza produce un nome accettabile di questo tipo. L’host accorcia fino a un limite presente e chiede di nuovo; con un limite assente si ferma, perché non resta nulla da tentare.
reasonstringnoPerché la destinazione non accetta il nome derivato, nei termini propri della destinazione, per un lettore che decide che cosa scrivere al suo posto. Vuoto quando il verdetto è utilizzabile.

Non sono consentite proprietà aggiuntive.

NameBoundOutput

Il payload che un guest del Provider restituisce dalla sua esportazione name_bound: un verdetto per ogni tipo di nome che deriverebbe dall’identità proposta. Una proposta è utilizzabile quando lo è ogni verdetto; dove uno non lo è, l’host accorcia la proposta al limite più piccolo che portano i verdetti di rifiuto e chiede di nuovo, e si ferma quando un verdetto di rifiuto non porta alcun limite. Un elenco di verdetti vuoto significa che il guest non deriva alcun nome da un’identità di componente, il che è la stessa risposta che accettare la proposta.

ProprietàTipoObbligatoriaDescrizione
namesDerivedNameVerdict[]noUna voce per ogni tipo di nome che il guest deriva da un’identità di componente, nell’ordine proprio del guest. Un guest riporta ogni tipo che deriverebbe anziché solo i tipi che hanno rifiutato, così un lettore vede quali nomi sono stati giudicati e un host che legge le voci non ha bisogno di una seconda chiamata per conoscere il resto.
errorstringnoUn messaggio di fallimento impostato quando il guest è stato eseguito ma non ha potuto completare l’operazione; assente in caso di successo. È distinto da un verdetto di rifiuto: un verdetto riporta un nome che la destinazione non accetterà, mentre error riporta che non è stato possibile rispondere alla domanda stessa. L’host presenta un error presente come un’invocazione di plugin fallita.
condition_codestringnoL’identità descrittiva e riconoscibile automaticamente della condizione che il fallimento nomina — il codice con cui la condizione è registrata, nello stesso insieme aperto in cui il compilatore registra le proprie condizioni di arresto, e non un membro del catalogo chiuso dei codici di errore delle funzioni host da cui attinge il valore hostfunc_error_code di una busta di risposta. Impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. Un guest che si arresta riporta qui l’identificatore della condizione che il suo messaggio nomina, così un consumatore si dirama su di esso anziché ricostruire un’identità leggendo il messaggio. L’host risolve questo identificatore rispetto alle condizioni che il compilatore dichiara e pubblica gli identificatori propri della condizione risolta sulla diagnostica strutturata, così un codice che raggiunge un lettore si risolve sempre; un identificatore che non nomina alcuna condizione di questo tipo, o uno che la numerazione ha ritirato, arresta la build. Un guest senza una condizione precisa da nominare ricorre invece a una delle condizioni generiche di fallimento dei plugin che il compilatore dichiara a questo scopo, e mette i dettagli nel proprio messaggio. Questo identificatore e condition_short_code vengono riportati insieme, perché nominano una sola condizione in due forme: un guest che imposta l’uno e non l’altro ha nominato una condizione che l’host non può risolvere, e l’host riporta allora la propria condizione generica di fallimento dei plugin mentre il messaggio porta ancora l’intero fallimento.
condition_short_codestringnoL’identificatore compatto della stessa condizione — la lettera E e quattro cifre, la forma che un lettore cita, cerca e incolla in una segnalazione — impostato accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host lo stampa nell’intestazione tra parentesi quadre della diagnostica che produce per questo fallimento, così una condizione che un guest solleva è citabile esattamente come una che solleva il compilatore. L’host risolve il valore rispetto alle condizioni che il compilatore dichiara anziché portarlo sulla fiducia: un valore che non nomina alcuna condizione di questo tipo, un valore che la numerazione ha ritirato, o una grafia che la registrazione non porta arresta la build e cita il valore in questione, con il messaggio proprio del guest ancora riportato. Viene riportato insieme a condition_code, per il motivo indicato lì.

Non sono consentite proprietà aggiuntive.

RenderedNameInput

Il payload che un guest del Provider riceve tramite la sua esportazione facoltativa rendered_name: le due identità da cui una destinazione deriva i propri nomi, e quali tipi di input dichiara la Recipe del nodo — un sorgente fornito dall’autore, un workload che il guest sintetizza. Il guest risponde con il nome che la sua destinazione darà alle risorse che renderizza per quel nodo: per un sorgente fornito, il nome rispetto a cui vengono renderizzati i template propri dell’autore, come il nome della release che legge un chart; per un workload sintetizzato, il nome che il guest dà alle risorse che costruisce, dove ne deriva uno anziché scrivere l’identità del nodo così com’è. Un guest che non deriva alcun nome di questo tipo non ne riporta nessuno, il che è la risposta onesta per una destinazione i cui nomi delle risorse sono scritti alla lettera da una Recipe, e per una il cui nome è funzione di dove vengono collocati i file anziché del nodo. Questa esportazione riporta un nome che il guest stesso compone e non è lo scambio che chiede al guest di giudicare un nome proposto dall’host; si tratta di domande diverse e ciascuna ha la propria esportazione.

ProprietàTipoObbligatoriaDescrizione
node_idstringsìL’identità propria del nodo, così come è stata scritta. Viene portata senza codifica: una destinazione la restringe attraverso il proprio alfabeto, quindi codificarla prima metterebbe un escape dentro un altro e scriverebbe il nome in modo diverso da quello con cui l’autore di una ricetta lo prevede.
derived_name_basisstringnoL’identità rispetto a cui viene renderizzato il sorgente proprio di un contributore quando non è quella propria del nodo — impostata per un contributore la cui identità è rifiutata dall’alfabeto dei nomi di una destinazione, assente altrimenti. Un guest risolve la coppia nello stesso modo di ogni altra superficie: questo valore quando è presente, l’id del nodo quando non lo è.
sourcedbooleananoSe la Recipe legata del nodo dichiara un sorgente fornito dall’autore, letto dal testo che l’autore ha scritto. Viene portato, insieme a synthesized, così la domanda può essere posta per qualsiasi nodo e ricevere una risposta corretta: un guest non riporta alcun nome per un nodo che non dichiara né l’uno né l’altro, il cui output è solo un insieme di artefatti, perché le risorse di un tale insieme sono nominate dagli artefatti che l’autore ha scritto anziché da un nome che il guest deriva.
synthesizedbooleananoSe la Recipe legata del nodo dichiara un workload che il guest deve sintetizzare, letto dal testo che l’autore ha scritto, come lo è sourced. Un guest la cui destinazione nomina le risorse che sintetizza in base a un nome che deriva, anziché in base all’identità del nodo così come è scritta, riporta quel nome per un nodo di questo tipo, così un indirizzo che una Recipe pubblica per una di quelle risorse può essere costruito a partire dal nome che la risorsa porta.

Non sono consentite proprietà aggiuntive.

RenderedNameOutput

Il payload che un guest del Provider restituisce dalla sua esportazione rendered_name: il nome che la sua destinazione dà alle risorse che renderizza per il nodo — a partire dal sorgente del nodo fornito dall’autore, o dal workload che sintetizza — oppure nessun nome. Un nome assente o vuoto è una risposta positiva anziché un fallimento — dice che questa destinazione non deriva alcun nome di questo tipo — e l’host usa ciò che gli è stato detto senza leggerlo, così nessuna conoscenza della denominazione della destinazione attraversa il confine.

ProprietàTipoObbligatoriaDescrizione
namestringnoIl nome con cui il guest renderizza il sorgente fornito dall’autore di questo nodo, o che dà alle risorse che sintetizza per il nodo, già scritto nell’alfabeto che la sua destinazione accetta in quella posizione. Vuoto o assente significa che il guest non deriva alcun nome di questo tipo.
errorstringnoUn messaggio di fallimento impostato quando il guest è stato eseguito ma non ha potuto completare l’operazione; assente in caso di successo. È distinto dal non riportare alcun nome: nessun nome è una risposta sulla destinazione, mentre error riporta che non è stato possibile rispondere alla domanda stessa. L’host presenta un error presente come un’invocazione di plugin fallita.
condition_codestringnoL’identità descrittiva e riconoscibile automaticamente della condizione che il fallimento nomina — il codice con cui la condizione è registrata, nello stesso insieme aperto in cui il compilatore registra le proprie condizioni di arresto. Impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host risolve questo identificatore rispetto alle condizioni che il compilatore dichiara e pubblica gli identificatori propri della condizione risolta sulla diagnostica strutturata, così un codice che raggiunge un lettore si risolve sempre; un identificatore che non nomina alcuna condizione di questo tipo, o uno che la numerazione ha ritirato, arresta la build. Un guest senza una condizione precisa da nominare ricorre invece a una delle condizioni generiche di fallimento dei plugin che il compilatore dichiara a questo scopo, e mette i dettagli nel proprio messaggio. Questo identificatore e condition_short_code vengono riportati insieme, perché nominano una sola condizione in due forme: un guest che imposta l’uno e non l’altro ha nominato una condizione che l’host non può risolvere, e l’host riporta allora la propria condizione generica di fallimento dei plugin mentre il messaggio porta ancora l’intero fallimento.
condition_short_codestringnoL’identificatore compatto della stessa condizione — la lettera E e quattro cifre, la forma che un lettore cita, cerca e incolla in una segnalazione — impostato accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host lo stampa nell’intestazione tra parentesi quadre della diagnostica che produce per questo fallimento, così una condizione che un guest solleva è citabile esattamente come una che solleva il compilatore. L’host risolve il valore rispetto alle condizioni che il compilatore dichiara anziché portarlo sulla fiducia: un valore che non nomina alcuna condizione di questo tipo, un valore che la numerazione ha ritirato, o una grafia che la registrazione non porta arresta la build e cita il valore in questione, con il messaggio proprio del guest ancora riportato. Viene riportato insieme a condition_code, per il motivo indicato lì.

Non sono consentite proprietà aggiuntive.

LinkEndpoint

Un endpoint di un collegamento tra confini: il nodo, il percorso del confine in cui si assembla il suo output renderizzato e il provider che lo ha renderizzato. I due endpoint di un collegamento nominano l’estremità consumatrice e quella consumata di un arco uses le cui estremità si assemblano in gruppi di smistamento diversi.

ProprietàTipoObbligatoriaDescrizione
nodestringsìL’id assoluto del nodo dell’endpoint all’interno del grafo della topologia.
boundarystringsìIl percorso del confine dell’endpoint — il gruppo di smistamento in cui si assembla il suo output renderizzato.
providerstringsìIl provider che ha renderizzato l’endpoint (il semplice nome del provider). Entrambi gli endpoint di un collegamento cablato nominano lo stesso provider; l’host non instrada un collegamento i cui endpoint nominano provider diversi.
releasestringnoLa Release a cui appartiene l’output renderizzato dell’endpoint — l’ambito entro cui sono nominati i suoi artefatti assemblati. L’host la assembla a partire dalla Release che la build ha risolto e la passa alla lettera; non deduce alcun significato dal valore. Un provider la legge per circoscrivere alla Release un nome di riferimento incrociato. Un valore assente è la stringa vuota, che un provider tratta come un nome senza ambito.

Non sono consentite proprietà aggiuntive.

LinkEdge

Il payload per arco generalizzato e agnostico rispetto al dominio che l’host assembla per un arco uses le cui estremità consumatrice e consumata si assemblano in gruppi di smistamento diversi. Porta entrambi gli endpoint, le annotazioni di collocazione di entrambi gli endpoint come mappe scalari opache che l’host non interpreta, l’output provides dell’endpoint consumato, e il socket e la mappatura inject che l’arco cabla. Un provider lo legge per produrre il cablaggio dei riferimenti incrociati nativo del provider di cui hanno bisogno le due estremità; l’host lo assembla e passa la mappa delle annotazioni come scalari opachi, senza dedurre alcun significato da alcun valore.

ProprietàTipoObbligatoriaDescrizione
sourceLinkEndpointsìL’endpoint consumatore — l’estremità di origine dell’arco uses orientato, nel cui output assemblato viene iniettato il cablaggio lato consumatore.
targetLinkEndpointsìL’endpoint consumato — l’estremità di destinazione a cui punta l’arco uses, il cui output assemblato viene pubblicato dal cablaggio lato produttore.
target_annotationsmappa di stringnoLe annotazioni di collocazione dell’endpoint consumato (destinazione) come mappa scalare opaca, indicizzata per nome di annotazione. L’host le assembla a partire dalle annotazioni risolte della destinazione e le passa alla lettera; non deduce alcun significato da alcun valore. Un provider le legge per decidere come dare forma a un riferimento incrociato (per esempio se le due estremità condividono una collocazione o hanno bisogno di un riferimento tra collocazioni). Le chiavi vengono serializzate ordinate, così il payload è identico byte per byte tra esecuzioni con input identico.
source_annotationsmappa di stringnoLe annotazioni di collocazione dell’endpoint consumatore (origine) come mappa scalare opaca, indicizzata per nome di annotazione. L’host le assembla a partire dalle annotazioni risolte dell’origine e le passa alla lettera; non deduce alcun significato da alcun valore. Un provider le legge per confrontare la collocazione delle due estremità — per esempio se l’origine e la destinazione condividono una collocazione o si trovano in collocazioni diverse. Le chiavi vengono serializzate ordinate, così il payload è identico byte per byte tra esecuzioni con input identico.
socketstringsìL’alias del socket sotto cui è legato l’arco uses.
providesmappa di stringsìL’output provides dell’endpoint consumato, un insieme di chiavi ordinato dall’autore che espone gli output dichiarati della destinazione. Conserva l’ordine dell’autore, così il payload è identico byte per byte tra esecuzioni con input identico.
injectobjectsìLa mappatura inject dell’endpoint consumatore, indicizzata per meccanismo di consegna su un insieme di chiavi ordinato dall’autore, che descrive come l’estremità consumatrice riceve l’output dell’endpoint consumato. Conserva l’ordine dell’autore, così il payload è identico byte per byte tra esecuzioni con input identico.
read_provides_keysstring[]noLe chiavi dell’output provides dell’endpoint consumato che i template dell’endpoint consumatore leggono direttamente tramite .context.uses, che la mappatura inject le consegni anche o meno, nell’ordine dell’autore di provides. Ogni voce è una delle chiavi che provides porta. L’elenco viaggia sull’arco così la pubblicazione lato produttore e la risoluzione lato consumatore leggono un unico elenco. Assente quando l’endpoint consumatore non ha letto direttamente alcuna chiave di provides, e un provider che non ne riceve nessuna cabla il collegamento esattamente come farebbe se il campo non esistesse.

Non sono consentite proprietà aggiuntive.

LinkPatch

Una patch strutturale per file che un provider restituisce come cablaggio degli artefatti: il file di output e le operazioni strutturali ordinate da applicarvi. Un passaggio successivo dell’host suddivide il file nominato, applica le operazioni e lo riassembla in modo fedele al byte. La forma dell’operazione è il vocabolario condiviso delle operazioni di patch della pipeline; è opaca a questo livello dello schema, così un guest porta ogni operazione alla lettera mentre l’host realizza l’operazione tipizzata che la sua pipeline applica.

ProprietàTipoObbligatoriaDescrizione
filestringsìIl file di output a cui si applicano le operazioni, nominato come il provider lo ha emesso.
opsany[]sìLe operazioni strutturali ordinate da applicare al file, nell’ordine di applicazione.

Non sono consentite proprietà aggiuntive.

LinkPublishInput

Il payload che un provider riceve tramite la sua esportazione link_publish: un collegamento tra confini il cui output dell’endpoint consumato è referenziato attraverso un confine, e i file assemblati di quell’endpoint. L’esportazione restituisce l’identità pubblicata rispetto a cui il consumatore risolve ed eventuale cablaggio degli artefatti lato produttore di cui ha bisogno l’output dell’endpoint consumato.

ProprietàTipoObbligatoriaDescrizione
edgeLinkEdgesìIl collegamento tra confini in corso di pubblicazione, letto dal lato dell’endpoint consumato (destinazione).
producer_filesRenderedFile[]noI file assemblati dell’endpoint consumato, così il provider può leggere ciò che quell’endpoint dichiara già e confrontare con essi i nomi che sta per pubblicare. Ciascuno nomina il proprio percorso su disco e porta i byte assemblati. Assente quando l’host non ha alcun output assemblato del produttore da passare alla pubblicazione; un provider che non ha bisogno di alcun documento per scrivere il proprio cablaggio lo ignora.

Non sono consentite proprietà aggiuntive.

LinkPublishOutput

Il payload che un provider restituisce dalla sua esportazione link_publish: l’handle dell’identità pubblicata rispetto a cui il consumatore risolve, e il cablaggio degli artefatti lato produttore da applicare all’output assemblato dell’endpoint consumato.

ProprietàTipoObbligatoriaDescrizione
handlemappa di stringsìL’identità pubblicata che l’endpoint consumato espone perché il consumatore risolva rispetto a essa, una mappa opaca di stringhe puntatore deterministiche indicizzata per nome di campo (per esempio un nome di export, un nome di stack, una regione, un riferimento a un ruolo). I valori sono stringhe puntatore deterministiche che il compilatore convoglia e non risolve mai; l’ambiente di runtime le risolve al momento della distribuzione. Le chiavi vengono serializzate ordinate, così il payload è identico byte per byte tra esecuzioni con input identico.
patchesLinkPatch[]noIl cablaggio degli artefatti lato produttore, una patch strutturale per ogni file di output dell’endpoint consumato che la pubblicazione deve modificare. Vuoto quando l’output dell’endpoint consumato non richiede alcuna modifica per il collegamento.
errorstringnoUn messaggio di fallimento impostato quando il guest è stato eseguito ma non ha potuto pubblicare il collegamento; assente in caso di successo. L’host presenta un error presente come un’invocazione di plugin fallita. Una pubblicazione che non può procedere — un nome di export che lo stack dichiara già sotto un’altra voce, per esempio — viene riportata qui anziché solo come un crash, così la condizione che vi sta dietro può essere nominata.
condition_codestringnoL’identità descrittiva e riconoscibile automaticamente della condizione che il fallimento nomina — il codice con cui la condizione è registrata, nello stesso insieme aperto in cui il compilatore registra le proprie condizioni di arresto, e non un membro del catalogo chiuso dei codici di errore delle funzioni host da cui attinge il valore hostfunc_error_code di una busta di risposta. Impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. Un guest che si arresta riporta qui l’identificatore della condizione che il suo messaggio nomina, così un consumatore si dirama su di esso anziché ricostruire un’identità leggendo il messaggio. L’host risolve questo identificatore rispetto alle condizioni che il compilatore dichiara e pubblica gli identificatori propri della condizione risolta sulla diagnostica strutturata, così un codice che raggiunge un lettore si risolve sempre; un identificatore che non nomina alcuna condizione di questo tipo, o uno che la numerazione ha ritirato, arresta la build. Un guest senza una condizione precisa da nominare ricorre invece a una delle condizioni generiche di fallimento dei plugin che il compilatore dichiara a questo scopo, e mette i dettagli nel proprio messaggio. Questo identificatore e condition_short_code vengono riportati insieme, perché nominano una sola condizione in due forme: un guest che imposta l’uno e non l’altro ha nominato una condizione che l’host non può risolvere, e l’host riporta allora la propria condizione generica di fallimento dei plugin mentre il messaggio porta ancora l’intero fallimento.
condition_short_codestringnoL’identificatore compatto della stessa condizione — la lettera E e quattro cifre, la forma che un lettore cita, cerca e incolla in una segnalazione — impostato accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host lo stampa nell’intestazione tra parentesi quadre della diagnostica che produce per questo fallimento, così una condizione che un guest solleva è citabile esattamente come una che solleva il compilatore. L’host risolve il valore rispetto alle condizioni che il compilatore dichiara anziché portarlo sulla fiducia: un valore che non nomina alcuna condizione di questo tipo, un valore che la numerazione ha ritirato, o una grafia che la registrazione non porta arresta la build e cita il valore in questione, con il messaggio proprio del guest ancora riportato. Viene riportato insieme a condition_code, per il motivo indicato lì.

Non sono consentite proprietà aggiuntive.

LinkResolveInput

Il payload che un provider riceve tramite la sua esportazione link_resolve: un collegamento tra confini, l’handle dell’identità pubblicata esposto dal suo endpoint consumato e i file assemblati dell’endpoint consumatore. L’esportazione restituisce il cablaggio degli artefatti lato consumatore che inietta il riferimento nell’output assemblato dell’endpoint consumatore.

ProprietàTipoObbligatoriaDescrizione
edgeLinkEdgesìIl collegamento tra confini in corso di risoluzione, letto dal lato dell’endpoint consumatore (origine).
handlemappa di stringsìL’handle dell’identità pubblicata restituito dal link_publish dell’endpoint consumato, rispetto a cui il consumatore risolve il proprio riferimento. Stringhe puntatore deterministiche opache indicizzate per nome di campo; il compilatore le convoglia e non le risolve mai. Le chiavi vengono serializzate ordinate, così il payload è identico byte per byte tra esecuzioni con input identico.
consumer_filesRenderedFile[]noI file assemblati dell’endpoint consumatore, così il provider può individuare il segnaposto che l’host ha marcato nell’output consumatore e scriverne la sostituzione nel percorso reale del segnaposto. Ciascuno nomina il proprio percorso su disco e porta i byte assemblati. Assente quando l’host non ha alcun output assemblato del consumatore da passare alla risoluzione; un provider che non ha bisogno di alcun documento per scrivere il proprio cablaggio lo ignora.

Non sono consentite proprietà aggiuntive.

LinkResolveOutput

Il payload che un provider restituisce dalla sua esportazione link_resolve: il cablaggio degli artefatti lato consumatore da applicare all’output assemblato dell’endpoint consumatore, che inietta il riferimento all’identità pubblicata dell’endpoint consumato.

ProprietàTipoObbligatoriaDescrizione
patchesLinkPatch[]sìIl cablaggio degli artefatti lato consumatore, una patch strutturale per ogni file di output dell’endpoint consumatore che la risoluzione deve modificare.
errorstringnoUn messaggio di fallimento impostato quando il guest è stato eseguito ma non ha potuto risolvere il collegamento; assente in caso di successo. L’host presenta un error presente come un’invocazione di plugin fallita. Una risoluzione che non può procedere — un riferimento che la destinazione può portare solo come uno scalare intero, trovato all’interno di una stringa più lunga — viene riportata qui anziché solo come un crash, così la condizione che vi sta dietro può essere nominata.
condition_codestringnoL’identità descrittiva e riconoscibile automaticamente della condizione che il fallimento nomina — il codice con cui la condizione è registrata, nello stesso insieme aperto in cui il compilatore registra le proprie condizioni di arresto, e non un membro del catalogo chiuso dei codici di errore delle funzioni host da cui attinge il valore hostfunc_error_code di una busta di risposta. Impostata accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. Un guest che si arresta riporta qui l’identificatore della condizione che il suo messaggio nomina, così un consumatore si dirama su di esso anziché ricostruire un’identità leggendo il messaggio. L’host risolve questo identificatore rispetto alle condizioni che il compilatore dichiara e pubblica gli identificatori propri della condizione risolta sulla diagnostica strutturata, così un codice che raggiunge un lettore si risolve sempre; un identificatore che non nomina alcuna condizione di questo tipo, o uno che la numerazione ha ritirato, arresta la build. Un guest senza una condizione precisa da nominare ricorre invece a una delle condizioni generiche di fallimento dei plugin che il compilatore dichiara a questo scopo, e mette i dettagli nel proprio messaggio. Questo identificatore e condition_short_code vengono riportati insieme, perché nominano una sola condizione in due forme: un guest che imposta l’uno e non l’altro ha nominato una condizione che l’host non può risolvere, e l’host riporta allora la propria condizione generica di fallimento dei plugin mentre il messaggio porta ancora l’intero fallimento.
condition_short_codestringnoL’identificatore compatto della stessa condizione — la lettera E e quattro cifre, la forma che un lettore cita, cerca e incolla in una segnalazione — impostato accanto al messaggio di errore leggibile dalle persone; assente in caso di successo, e assente quando il guest non nomina alcuna condizione di questo tipo. L’host lo stampa nell’intestazione tra parentesi quadre della diagnostica che produce per questo fallimento, così una condizione che un guest solleva è citabile esattamente come una che solleva il compilatore. L’host risolve il valore rispetto alle condizioni che il compilatore dichiara anziché portarlo sulla fiducia: un valore che non nomina alcuna condizione di questo tipo, un valore che la numerazione ha ritirato, o una grafia che la registrazione non porta arresta la build e cita il valore in questione, con il messaggio proprio del guest ancora riportato. Viene riportato insieme a condition_code, per il motivo indicato lì.

Non sono consentite proprietà aggiuntive.