Schema del contesto di template di Aggrega
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/template-context-v1beta1.schema.json
La vista che il compilatore assembla e passa ai template di Recipe e FeatureRecipe durante il rendering. Quando esegue il rendering di una FeatureRecipe di associazione, il compilatore popola inoltre .attachment_name e .inject con il contesto limitato all’associazione, .context.render_facts con ciò che il provider del suo host ha riportato sul rendering dell’host e, sui template che producono le risorse proprie dell’associazione, .context.used_by con i componenti che usano il suo host. Per una FeatureRecipe con ambito di confine (spec.executionScope: boundary), i template che esegue una volta per il confine — tra cui i suoi locals, provides, source, valuesMapping, artifacts e passi di pipeline — trovano assenti i pilastri .context, .workload, .attachment_name, .inject e .inject_raw e popolato invece un pilastro .boundary.* — vedi il blocco del confine in fondo alle proprietà; il suo injectMapping viene eseguito una volta per ciascun componente che l’associazione raggiunge, nel contesto di quel componente, quindi legge .context.* e .attachment_name, e lì .boundary non è impostato. Questo NON viene reso persistente su disco; esiste solo nella memoria del compilatore durante il rendering. Questo schema documenta il contratto tra il compilatore e gli autori di template di Ops.
Disponibilità per fase del rendering di base, nell’ordine in cui vengono eseguite le fasi:
- Valutazione dei provides (preambolo dei locals, poi provides): solo pilastri locali al nodo. Una voce di locals legge le voci sopra di essa nel proprio blocco; un template di provides legge l’intero .locals risolto del nodo. Autoriferimento vietato (nessuna voce di provides ne legge un’altra).
- Risoluzione della sorgente (pubblicazione dei locals + valutazione di source): tutti i pilastri; .source e .workload assenti. Quei locals vengono pubblicati qui su .locals, poi source: viene valutato rispetto a essi.
- Mappatura dei valori (valuesMapping): tutti i pilastri + .source; .workload assente.
- Sintesi del Workload (valutazione di workload): tutti i pilastri + .source; .workload in corso di valutazione (assente dall’autoriferimento).
- Valutazione degli artefatti (artifacts): tutti i pilastri + .source + .workload (contesto più completo).
Tipo di primo livello: object
Proprietà
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
context | object | sì | Il contesto di esecuzione assemblato dal compilatore, che fornisce dati di identità, topologia e consegna. |
values | object | sì | Il payload cognitivo opaco per questo nodo, già validato dal validatore di schema alla risoluzione. Passato senza modifiche. |
infra | object | sì | Il payload di dimensionamento fisico iniettato dalla Release per questo nodo. Scavalca completamente lo sviluppatore. |
locals | mappa di string | sì | Lo stato privato proprio della Recipe (ad es. primary_compute, volumes_path). Valutato nel preambolo dei locals — prima dei provides di quel nodo — e pubblicato su questo pilastro alla risoluzione della sorgente. Ogni voce è un template Go valutato rispetto a un contesto autosufficiente locale al nodo che porta le voci dello stesso blocco risolte fino a quel momento, quindi una voce PUÒ leggere una voce sorella definita SOPRA di essa e riceve il valore risolto di quella voce sorella. L’ordine dell’autore fa parte del contratto ovunque una voce ne legga un’altra: spostare una definizione sotto chi la legge rompe la build. Un riferimento ‘.locals. |
provides | mappa di string | no | Il contratto API pubblico della Recipe. Popolato dalla valutazione dei provides. Disponibile nel valuesMapping del rendering di base per l’autoriferimento (ad es. {{ .provides.host }}). NON disponibile all’interno del template dei provides stesso (l’invariante di autocontenimento dei provides). I chiamanti risolvono le chiavi di inject rispetto a questi valori. |
features | mappa di template_attachment | no | Ogni associazione su questo nodo, indicizzata per il nome di istanza che l’autore le ha dato. Un unico pilastro le porta tutte qualunque cosa producano — una Feature operativa, una Feature di credenziali, una Feature di identità — perché ciò che differisce tra le associazioni è ciò che producono, non il modo in cui un template le legge. Una Recipe le legge per adattare il proprio rendering alle capacità associate e per consumare ciò che un’associazione pubblica. Un’associazione scritta su una delle connessioni del nodo non è tra queste: viene letta sotto quella connessione, in .context.uses. |
metadata | object | no | Metadati della Release e della compilazione che forniscono un’identità globale per la denominazione deterministica. Disponibili in tutti i blocchi di template (valuesMapping, injectMapping, pipeline with). |
attachment_name | string | no | Popolato solo quando si esegue il rendering di una FeatureRecipe di associazione. Contiene il nome di istanza dell’associazione — lo slot che riempie nel featuresSchema dell’entità proprietaria, o il nome libero che l’autore le ha dato (ad es. ‘admin_password’, ‘db_credentials’). Usato per costruire nomi di risorse deterministici che differiscono per associazione, composti dopo il nome del componente host: ’{{ .context.rendered_name }}-{{ .attachment_name | replace ”_” ”-” }}’ dove il provider dell’host riporta un nome di rendering, come fa helm — il nome dell’host scritto nei caratteri che un nome Kubernetes consente, con i trattini bassi del nome dell’associazione convertiti in trattini — e ’{{ .context.instance_id }}-{{ .attachment_name }}’ dove il provider dell’host non ne riporta alcuno. |
inject | object | no | Popolato solo quando si esegue il rendering di una FeatureRecipe di associazione che porta un blocco inject scritto dall’autore (ad es. { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Distinto da .context.inject, che è la pipe di consegna pre-idratata del componente di base proveniente dagli archi uses. Vale null/assente per le associazioni senza inject scritto dall’autore e per le Recipes di base. |
inject_raw | object o null | no | L’intento dello sviluppatore per il blocco inject, immutabile e non mutato. Ogni meccanismo che il blocco nomina — env, file, arg o uno personalizzato come ssm_param — si trova sotto il proprio nome e contiene le voci esattamente come sono scritte (in, con from o value), nell’ordine in cui sono scritte, così .inject_raw.ssm_param legge un meccanismo personalizzato nello stesso modo in cui .inject_raw.env legge uno di base. Vale null se lo sviluppatore ha omesso completamente il blocco inject. Usato da Ops per controlli logici (ad es. {{ if not .inject_raw }}) per rilevare l’omissione prima delle mutazioni della mappatura di inject. Quale dei values o dei provides propri del componente consegni ciascuna voce si legge in .context.self_inject anziché dal testo delle voci. |
steps | mappa di object | no | Comunicazione tra i passi della pipeline. Disponibile solo all’interno dei blocchi ‘with:’ di una pipeline Wasm. Ogni chiave è l’ID di un passo della pipeline, che contiene gli output esportati da quel passo. |
source | string o object o null | no | Contenuto risolto del campo source. Sui template di una Recipe: popolato alla risoluzione della sorgente dal campo source: della Recipe dopo la valutazione del template Go, disponibile dalla mappatura dei valori in poi (valuesMapping, workload, artifacts), e null quando la Recipe non ha source:. Sui template di una FeatureRecipe: il campo source: proprio della FeatureRecipe dopo la valutazione del template Go, valutato prima del suo valuesMapping e letto lì e in ogni template valutato dopo di esso (omits, workload, artifacts, passi della pipeline), mai quello del componente host; null quando la FeatureRecipe non ha source:. L’injectMapping di una FeatureRecipe viene valutato prima della sua sorgente e legge quella del componente host. Forma stringa = percorso URI; forma oggetto = sorgente strutturata (ad es. descrittore OCI con versione risolta). |
workload | workload-v1beta1.schema.json o null | no | Spec del Workload analizzata per questo nodo. Popolata alla sintesi del workload dal campo workload: della Recipe dopo la valutazione del template Go + la validazione JSON Schema del Workload (rispetto a workload-v1beta1.schema.json). Disponibile dalla valutazione degli artefatti in poi (artifacts), così gli artefatti possono fare riferimento ai campi del workload senza duplicazione (ad es. un ServiceMonitor che legge .workload.services.metrics.ports.prom). Vale null quando la Recipe non ha un blocco workload:. I tentativi di un template di dereferenziare .workload.* su un valore null falliscono con un errore chiaro al momento della valutazione del template. |
boundary | object | no | Contesto con ambito di confine — popolato solo quando si valuta un template che una FeatureRecipe il cui spec.executionScope è ‘boundary’ esegue una volta per il confine. Le FeatureRecipes con ambito di Component non ricevono questo pilastro; i loro context.instance_id, context.inject, context.uses e il pilastro .workload portano invece dati per componente. I template di una FeatureRecipe con ambito di confine eseguiti per il confine ricevono .boundary.* al posto di quei pilastri per componente; il suo injectMapping viene eseguito nel contesto di ciascun componente che l’associazione raggiunge, legge quei pilastri per componente, e non riceve questo. |
Non sono consentite proprietà aggiuntive.
template-context.context
Il contesto di esecuzione assemblato dal compilatore, che fornisce dati di identità, topologia e consegna.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
instance_id | string | sì | L’ID assoluto appiattito del nodo corrente (ad es. ‘backend’, oppure ‘data-layer-zdmain-db’ per il componente main-db dell’istanza di modulo data-layer), scritto nell’alfabeto che ogni nome di componente scritto da un autore rispetta. Deterministico e stabile tra le compilazioni per lo stesso Aggregate. È il nome delle risorse costruite per questo nodo per cui nessun provider ricava un nome — un insieme di artefatti collocato dalla Recipe, e un workload sintetizzato da un provider che gli dà il nome dell’identità — quindi un indirizzo pubblicato per una di esse è costruito a partire da questo valore. |
rendered_name | string | no | Il nome che il provider legato a questo nodo dà alle risorse che renderizza per il nodo — per una sorgente fornita dall’autore, il nome rispetto a cui renderizzano gli stessi template forniti, come il nome della release che un chart legge; per un workload che sintetizza, il nome che dà alle risorse di quel workload quando ne ricava uno invece di scrivere l’identità del nodo, come fa il provider helm con lo stesso nome della release. Leggilo ovunque questa Recipe nomini una risorsa dichiarata da un chart o da un modulo forniti o sintetizzata da un tale provider, che sia in una voce di provides, in un valuesMapping, in un workload, in una voce di artifacts o nel with o nel when di un passo della pipeline, perché il provider può scrivere quel nome in un alfabeto più povero di quello in cui è scritto il nome di un componente dell’autore, e allora i due differiscono. Vuoto quando il provider legato non ricava alcun nome di questo tipo: le risorse di un insieme di artefatti collocato, e di un workload sintetizzato da un provider che gli dà il nome dell’identità, portano l’identità del nodo, quindi per quelle leggi ’{{ .context.instance_id }}’, e una Recipe che ha scritto i propri nomi di risorsa li conosce già. Leggere questa chiave dove il provider legato non riporta alcun nome arresta la build e indica che cosa scrivere al suo posto. Il rifiuto copre i template che una Recipe scrive inline; un valuesMapping, un workload o una voce di artifacts forniti tramite ‘$import’ vengono risolti solo quando il rendering li raggiunge, quindi un riferimento al loro interno viene renderizzato come valore vuoto invece di arrestare la build. Nei template di una FeatureRecipe legata all’associazione di un componente è il nome del componente HOST così come lo riporta il provider dell’host stesso — il valore che legge la Recipe dell’host stesso, così come lì instance_id è l’identità dell’host — quindi un’associazione, a partire da esso, dà a una risorsa il nome del suo host e ottiene un nome che la piattaforma dell’host accetta. Quando il provider dell’host non riporta alcun nome è vuoto, e leggerlo da un template inline dell’associazione diverso dal suo injectMapping arresta la build; lì leggi invece ’{{ .context.instance_id }}’. |
labels | mappa di string | no | Le etichette di duck-typing e di ontologia del nodo corrente, inclusa qualsiasi modifica apportata durante la costruzione della topologia da un plugin di governance associato con il ruolo label-transform. |
annotations | object | no | I tre contenitori di annotazioni a cascata del nodo corrente, separati per origine. |
inject | object | sì | La pipe di consegna pre-idratata e intercettata. Parte come una mappa generata dal compilatore che risolve le chiavi inject dello sviluppatore nei valori provides della destinazione. Modificata sul posto dai deep merge di injectMapping. Nel momento in cui la Recipe di base esegue il rendering, contiene le stringhe fisiche completamente risolte. |
uses | mappa di enriched_edge | sì | La mappa arricchita degli archi topologici. Indicizzata per l’alias dello sviluppatore (ad es. ‘my_db’, ‘my_api’). Ogni voce è una vista assemblata dal compilatore dell’identità del nodo di destinazione, dei provides risolti, della mappatura di iniezione e delle annotazioni in cascata, e delle associazioni scritte su quella connessione — e, per una FeatureRecipe che dichiara readsTargetRenderFacts, di ciò che i rendering della destinazione hanno riportato. Questo NON è l’arco IR grezzo — è una proiezione arricchita costruita dal compilatore appositamente per l’uso nei template. Un template che percorre questa mappa vede le connessioni in ordine di chiave — ordinate per alias — non nell’ordine in cui sono state scritte. |
self_inject | object | sì | Quali dei values e dei provides propri del componente lo sviluppatore ha già dotato di un nome di consegna, letto dal blocco inject: scritto sul componente stesso — il blocco che .inject_raw contiene così come è scritto e .context.inject contiene risolto. Ogni meccanismo che il blocco nomina (env, file, arg o uno personalizzato come ssm_param) mappa ogni nome scritto dallo sviluppatore alla chiave propria che quella voce consegna, così come .context.uses. |
used_by | inbound_edge[] | no | I componenti che usano questo: una voce per ogni connessione uses che un altro componente stabilisce verso di esso, nell’ordine in cui sono scritti i componenti che si connettono e poi nell’ordine delle voci uses di ciascuno. Un componente che si connette due volte compare due volte. Letto solo da una FeatureRecipe associata al componente, e solo nei template che producono le risorse proprie dell’associazione — il suo valuesMapping, workload e artifacts. È assente dai template della Recipe propria del componente, da un injectMapping e dal with e dal when di un passo della pipeline, perché l’output di ciascuno di essi può finire nell’output renderizzato proprio del componente, che resta lo stesso chiunque vi si connetta. Ogni voce è un elemento di lista anziché una chiave, quindi un template che la percorre incontra i chiamanti in quell’ordine. |
render_facts | render_facts | no | Ciò che il provider che ha renderizzato questo componente ha riportato sull’output che ha emesso — i fatti di rendering che riporta — indicizzato per nome del fatto. Quali nomi un provider riporta, e che cosa contiene ciascuna voce, è il contratto documentato proprio di quel provider. Ogni valore è una lista, anche con una sola voce, quindi un template la percorre sempre; quando il rendering del componente ha richiesto più di una chiamata al provider e un nome è stato riportato da più di una di esse, le sue liste vengono unite in una sola nell’ordine in cui sono state eseguite le chiamate. Presente in ogni template di una FeatureRecipe associata al componente — il suo valuesMapping, workload, artifacts e il with e il when dei passi della pipeline — una volta che il componente è stato renderizzato, e vuoto quando il suo provider non riporta nulla, quindi un nome che nessuno ha riportato si legge come una lista vuota. Assente dai template della Recipe propria del componente e da un injectMapping, che vengono eseguiti prima che il componente sia stato renderizzato. |
Non sono consentite proprietà aggiuntive.
template-context.context.annotations
I tre contenitori di annotazioni a cascata del nodo corrente, separati per origine.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
release | mappa di string | no | Stringhe di topologia fisica che discendono a cascata dai confini della Release. |
catalog | mappa di string | no | Tratti intrinseci immutabili scritti dal Platform Architect nel Dominio 2. |
aggregate | mappa di string | no | Metadati cognitivi che discendono a cascata dai sottosistemi dell’Aggregate. |
Non sono consentite proprietà aggiuntive.
template-context.context.inject
La pipe di consegna pre-idratata e intercettata. Parte come una mappa generata dal compilatore che risolve le chiavi inject dello sviluppatore nei valori provides della destinazione. Modificata sul posto dai deep merge di injectMapping. Nel momento in cui la Recipe di base esegue il rendering, contiene le stringhe fisiche completamente risolte.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
env | mappa di string | no | Consegna tramite variabili d’ambiente. Le chiavi sono i nomi delle variabili locali dello sviluppatore, i valori sono le stringhe risolte della destinazione. |
file | mappa di string | no | Consegna tramite mount di file. Le chiavi sono percorsi di file locali, i valori sono le stringhe risolte della destinazione. |
arg | mappa di string | no | Consegna tramite argomenti della riga di comando. Le chiavi sono prefissi di flag, i valori sono le stringhe risolte della destinazione. |
all | mappa di string | no | Unione piatta precalcolata dei meccanismi env + file + arg + personalizzati. Popolata dopo la risoluzione di uses-inject e ricalcolata dopo la mappatura di inject. I template usano {{ toJson .context.inject.all }} per una serializzazione universale. |
template-context.context.self_inject
Quali dei values e dei provides propri del componente lo sviluppatore ha già dotato di un nome di consegna, letto dal blocco inject: scritto sul componente stesso — il blocco che .inject_raw contiene così come è scritto e .context.inject contiene risolto. Ogni meccanismo che il blocco nomina (env, file, arg o uno personalizzato come ssm_param) mappa ogni nome scritto dallo sviluppatore alla chiave propria che quella voce consegna, così come .context.uses.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
env | mappa di string | no | Consegna tramite variabili d’ambiente: le chiavi sono i nomi di variabile dello sviluppatore, i valori sono la chiave propria che ciascuna voce consegna. |
file | mappa di string | no | Consegna tramite montaggio di file: le chiavi sono i percorsi di file dello sviluppatore, i valori sono la chiave propria che ciascuna voce consegna. |
arg | mappa di string | no | Consegna tramite argomenti della riga di comando: le chiavi sono i prefissi dei flag dello sviluppatore, i valori sono la chiave propria che ciascuna voce consegna. |
template-context.metadata
Metadati della Release e della compilazione che forniscono un’identità globale per la denominazione deterministica. Disponibili in tutti i blocchi di template (valuesMapping, injectMapping, pipeline with).
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
release_name | string | no | Il nome della Release in costruzione (ad es. ‘prod-billing’). Usato da Ops per costruire nomi di risorse cloud univoci a livello globale (bucket S3, ruoli IAM). Combinato con .context.instance_id per garantire l’univocità tra gli ambienti. |
release_version | string | no | La versione semantica della Release. |
environment | string | no | La stringa dell’ambiente presa dai metadati della Release (ad es. ‘production’, ‘local’). |
aggregate_name | string | no | Il nome dell’Aggregate radice in compilazione. |
Non sono consentite proprietà aggiuntive.
template-context.inject
Popolato solo quando si esegue il rendering di una FeatureRecipe di associazione che porta un blocco inject scritto dall’autore (ad es. { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Distinto da .context.inject, che è la pipe di consegna pre-idratata del componente di base proveniente dagli archi uses. Vale null/assente per le associazioni senza inject scritto dall’autore e per le Recipes di base.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
env | mappa di string | no | Consegna tramite variabili d’ambiente con ambito dell’associazione. |
file | mappa di string | no | Consegna tramite mount di file con ambito dell’associazione. |
arg | mappa di string | no | Consegna tramite argomenti con ambito dell’associazione. |
all | mappa di string | no | Unione di comodo, generata dal compilatore, di tutti i paradigmi di inject dell’associazione. |
template-context.boundary
Contesto con ambito di confine — popolato solo quando si valuta un template che una FeatureRecipe il cui spec.executionScope è ‘boundary’ esegue una volta per il confine. Le FeatureRecipes con ambito di Component non ricevono questo pilastro; i loro context.instance_id, context.inject, context.uses e il pilastro .workload portano invece dati per componente. I template di una FeatureRecipe con ambito di confine eseguiti per il confine ricevono .boundary.* al posto di quei pilastri per componente; il suo injectMapping viene eseguito nel contesto di ciascun componente che l’associazione raggiunge, legge quei pilastri per componente, e non riceve questo.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
path | string | no | Il percorso del confine della Release a cui è associata la FeatureRecipe: i nomi dei confini dal più esterno verso l’interno, uniti con ’/’ (ad es. ‘bridge’, ‘bridge/frontend’). Nomina il confine, non la directory in cui viene scritto il suo output, che è impostata dal directory: del confine. |
assembly_path | string | no | La directory, relativa alla directory di output della build, in cui viene assemblato l’output proprio di questa associazione: il directory: e il subDirectory: valutati del suo confine, la directory verso cui la build instrada quell’output (ad es. ‘bridge/compose’). È uguale al source_assembly_path o al target_assembly_path di un estremo di connessione esattamente quando quell’estremo viene renderizzato nello stesso file assemblato, quindi una FeatureRecipe li confronta per distinguere una connessione all’interno del proprio file da una in un altro file. Dati opachi; il core non li interpreta. |
boundary_name | string | no | Il nome del confine (la chiave della mappa in release.spec.boundaries). |
components | object | no | Mappa da instance_id a una voce per ogni componente nel sottoalbero del confine (ricorsiva, include i componenti dei confini annidati). Ogni voce porta l’URI del tipo risolto del componente, l’ID d’istanza e i valori forniti dalla valutazione di provides per componente. |
internal_uses_edges | object[] | no | Archi uses in cui la sorgente E la destinazione si trovano entrambe nel sottoalbero di questo confine. |
outgoing_cross_boundary_uses_edges | object[] | no | Archi uses la cui sorgente si trova nel sottoalbero di questo confine e la cui destinazione ne è al di fuori. |
incoming_cross_boundary_uses_edges | object[] | no | Archi uses in cui la destinazione si trova nel sottoalbero e la sorgente al di fuori. Usati da aggregatori di tipo ingress che hanno bisogno di sapere chi sta chiamando dall’esterno. |
cross_boundary_uses_edges | object[] | no | Unione di comodo degli archi tra confini in uscita e in entrata. |
labels | mappa di string | no | Unione delle etichette dei componenti nel sottoalbero, con conservazione dell’ordine dell’autore. |
annotations | mappa di string | no | Le annotazioni proprie del confine dopo la risoluzione della cascata. |
feature_attachments | template_attachment[] | no | Le associazioni fatte direttamente su questo confine (per i riferimenti tra associazioni nell’ambito del confine), nella stessa forma di associazione che porta .features. |
Non sono consentite proprietà aggiuntive.
Definizioni
inbound_edge
Una connessione che un altro componente stabilisce verso il componente per cui renderizza una FeatureRecipe associata: chi si connette, attraverso quale socket, che cosa pubblica il componente che si connette, e il namespace e il confine in cui è collocato. Ogni valore è una stringa che il compilatore porta senza interpretarla.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
component_id | string | sì | L’ID d’istanza appiattito del componente che si connette (ad es. ‘frontend’ o ‘data-layer.etl’) — il valore che un template di percorso subDirectory legge come .component_id, scritto come .context.uses. |
socket | string | sì | La categoria di usesSchema attraverso cui il componente che si connette traccia questa connessione (ad es. ‘databases’, ‘apis’). |
provides | mappa di string | sì | I provides risolti del componente che si connette, ristretti alle chiavi che dichiara il suo Component — gli stessi valori che un consumatore di quel componente legge in .context.uses. |
source_namespace | string | no | Il namespace in cui è collocato il componente che si connette: l’annotazione aggrega.ai/namespace che riceve il suo rendering — le annotazioni dei suoi confini, con le annotazioni della sua voce nella Release applicate per ultime, quindi un componente la cui voce imposta o cancella il namespace porta la propria impostazione anziché quella del suo confine. È il valore che una FeatureRecipe con ambito di confine legge come source_namespace nella voce della stessa connessione nelle liste degli archi uses di .boundary. Assente quando nessun namespace si applica al componente che si connette; proteggilo con if o with prima di stamparlo. |
source_boundary_path | string | no | Il percorso separato da barre del confine della Release che contiene il componente che si connette (ad es. ‘edge’ o ‘aws-prod/payments’) — il valore che una FeatureRecipe con ambito di confine legge come source_boundary_path nella voce della stessa connessione nelle liste degli archi uses di .boundary. |
render_facts | render_facts | no | Ciò che i rendering del componente che si connette hanno riportato sull’output che hanno emesso, indicizzato per nome del fatto: i fatti riportati dalle chiamate al suo stesso provider, poi quelli di ciascuna Feature associata a esso che è stata renderizzata con esso, nell’ordine in cui sono state renderizzate, con le liste che un nome riceve da più di esse unite in una sola in quell’ordine. Ogni valore è una lista, anche con una sola voce, quindi un template la percorre sempre. Presente solo per una FeatureRecipe che dichiara readsCallerRenderFacts — le cui associazioni vengono renderizzate una volta che ogni componente è stato renderizzato, quindi il rendering di ogni chiamante è completo — e in tal caso in ogni voce, vuoto per un chiamante i cui provider non riportano nulla. Assente per ogni altra FeatureRecipe. |
Non sono consentite proprietà aggiuntive.
render_facts
Fatti di rendering indicizzati per nome: ciò che i provider che hanno renderizzato un componente hanno riportato sull’output che hanno emesso. Quali nomi un provider riporta, e che cosa contiene ciascuna voce, è il contratto documentato proprio di quel provider; il compilatore non apprende nulla su nessuno dei due oltre al fatto che ogni valore è una lista. Una lista mantiene l’ordine delle sue voci. Una voce oggetto viene portata con le sue chiavi nell’ordine in cui il provider le ha scritte, e un template che la percorre le incontra in ordine di chiave, come accade per ogni mappa con chiavi di questo contesto.
Oggetto in forma libera; i valori sono any[].
template_attachment
Un’associazione così come la legge un template: la vista per istanza di una Feature associata. Ogni associazione espone gli stessi campi indipendentemente da ciò che produce, quindi .features.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
type | string | no | L’URI di Feature di catalogo della Feature associata. |
resolved_version | string | no | La versione della Feature associata dopo la risoluzione del Manifest — la versione effettivamente legata per questa build, letta come .features. |
labels | mappa di string | no | Le etichette di catalogo della Feature associata, portate alla lettera nell’ordine in cui la Feature le dichiara — nulla viene filtrato, rinominato o privato del prefisso, quindi un template legge esattamente ciò che ha scritto l’autore della Feature. Consente a un template di diramarsi in base a ciò che la Feature associata è anziché in base al suo nome o al suo URI. Rispecchia .context.uses.if o percorri la mappa prima di accedere a una singola etichetta. |
values | object | no | Il pilastro dell’intento dello sviluppatore proprio dell’associazione, portato alla lettera dalla dichiarazione dell’associazione. |
infra | object | no | Il pilastro del dimensionamento operativo proprio dell’associazione, portato alla lettera dalla dichiarazione dell’associazione. |
provides | mappa di string | no | Il contratto pubblico risolto della FeatureRecipe legata a questa associazione — il nome della risorsa emessa, la sua chiave, un’identità ed eventuali chiavi aggiuntive prodotte — esposto al consumatore come .features. |
Non sono consentite proprietà aggiuntive.
enriched_edge
Un singolo arco topologico arricchito assemblato dal compilatore. Contiene l’identità risolta della destinazione, i provides e le annotazioni in cascata.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
target | string | sì | L’ID assoluto appiattito del nodo di destinazione (ad es. ‘data-layer.main-db’). |
socket | string | sì | La categoria di usesSchema a cui appartiene questo arco (ad es. ‘databases’, ‘apis’). |
source | string | no | L’ID assoluto appiattito del nodo sorgente (consumatore). Popolato per le viste con ambito di confine che indicizzano gli output per consumatore in base al nodo consumatore. |
source_namespace | string | no | Annotazione aggrega.ai/namespace grezza dell’estremo sorgente (vuota quando è assente). Popolata solo per le viste con ambito di confine, come lo è source; la voce .context.uses propria di un componente la porta vuota. Dati opachi per la risoluzione dell’identità di rete di un provider; il core non li interpreta. |
source_boundary_path | string | no | Percorso del confine dell’estremo sorgente: il percorso separato da barre del confine della Release che lo contiene (ad es. ‘bridge/frontend’). Popolato solo per le viste con ambito di confine, come lo è source; la voce .context.uses propria di un componente lo porta vuoto. |
source_assembly_path | string | no | Percorso di assemblaggio dell’estremo sorgente: la directory, relativa alla directory di output della build, in cui viene assemblato il suo output, composta dal directory: e dal subDirectory: valutati del suo confine (ad es. ‘bridge/compose’). Due estremi con lo stesso percorso di assemblaggio vengono renderizzati in un unico file assemblato, e un estremo il cui percorso di assemblaggio è uguale a .boundary.assembly_path viene renderizzato nel file in cui viene assemblato l’output proprio della FeatureRecipe che lo legge. Una FeatureRecipe con ambito di confine che colloca gli estremi su reti può leggerlo come la rete dell’estremo sorgente quando non si applica alcun aggrega.ai/namespace. Popolato solo per le viste con ambito di confine, come lo è source; la voce .context.uses propria di un componente lo porta vuoto. Dati opachi; il core non li interpreta. |
target_namespace | string | no | Annotazione aggrega.ai/namespace grezza dell’estremo di destinazione (vuota quando è assente). Popolata solo per le viste con ambito di confine, come lo è source; la voce .context.uses propria di un componente la porta vuota. Dati opachi per la risoluzione dell’identità di rete di un provider. |
target_boundary_path | string | no | Percorso del confine dell’estremo di destinazione: il percorso separato da barre del confine della Release che lo contiene (ad es. ‘bridge/backend’). Popolato solo per le viste con ambito di confine, come lo è source; la voce .context.uses propria di un componente lo porta vuoto. |
target_assembly_path | string | no | Percorso di assemblaggio dell’estremo di destinazione: la directory, relativa alla directory di output della build, in cui viene assemblato il suo output, composta dal directory: e dal subDirectory: valutati del suo confine (ad es. ‘bridge/compose’). Un estremo il cui percorso di assemblaggio è uguale a .boundary.assembly_path viene renderizzato nel file in cui viene assemblato l’output proprio della FeatureRecipe che lo legge. Una FeatureRecipe con ambito di confine che colloca gli estremi su reti può leggerlo come la rete dell’estremo di destinazione quando non si applica alcun aggrega.ai/namespace. Popolato solo per le viste con ambito di confine, come lo è source; la voce .context.uses propria di un componente lo porta vuoto. Dati opachi; il core non li interpreta. |
provides | mappa di string | sì | Il dizionario provides completamente risolto del nodo di destinazione. Valutato alla valutazione dei provides, prima dell’idratazione di inject. |
inject | object | sì | La mappatura inject originale dello sviluppatore per questo arco (chiavi = nomi delle variabili locali, valori = chiavi provides della destinazione). Questa è la mappatura GREZZA, non i valori risolti. |
labels | mappa di string | no | Le etichette di duck-typing e di ontologia del nodo di destinazione (dopo le modifiche apportate durante la costruzione della topologia). |
annotations | object | no | I tre contenitori di annotazioni a cascata del nodo di destinazione. |
component | string | no | L’URI del tipo di componente di catalogo del nodo di destinazione (ad es. ‘core/postgres’). |
resolved_version | string | no | La SemVer risolta del nodo di destinazione. |
boundary_path | string | no | La gerarchia spaziale fisica del nodo di destinazione presa dalla Release (ad es. ‘aws-eks-cluster/backend-ns’). |
origin_feature | string | no | Se questo arco è stato dichiarato autonomamente da una Feature (comprese le Features di credenziali etichettate feature.aggrega.ai/kind: secret), il nome d’istanza della Feature. Null/assente per gli archi dichiarati dallo sviluppatore. |
origin_release | booleana | no | Vale true quando è la Release ad aver collegato questa connessione anziché l’Aggregate ad averla dichiarata. Assente per una connessione che l’Aggregate dichiara. |
values | object | no | La configurazione dello sviluppatore per connessione scritta nella voce uses dell’Aggregate per questa connessione, portata alla lettera. Assente quando la connessione non ne porta alcuna. Raggiunge solo il contesto del nodo consumatore, mai quello della destinazione. |
infra | object | no | La configurazione operativa per connessione scritta nella voce uses della Release per questa connessione, portata alla lettera. Assente quando la connessione non ne porta alcuna. Raggiunge solo il contesto del nodo consumatore, mai quello della destinazione. |
features | mappa di template_attachment | no | Le associazioni scritte su questa connessione, indicizzate per il nome di slot che il socket della connessione dichiara per ciascuna, ognuna nella forma di associazione che porta .features: il suo tipo, la versione risolta, le etichette, i values, l’infra e i provides risolti della FeatureRecipe legata a essa. Una Recipe legge la credenziale di una connessione come .context.uses. |
render_facts | render_facts | no | Ciò che i rendering della destinazione hanno riportato sull’output che hanno emesso, indicizzato per nome del fatto, nella forma che porta la voce di un chiamante in .context.used_by: i fatti riportati dalle chiamate al suo stesso provider, poi quelli di ciascuna Feature associata a essa che è stata renderizzata con essa, nell’ordine in cui sono state renderizzate, con le liste che un nome riceve da più di esse unite in una sola in quell’ordine. Ogni valore è una lista, anche con una sola voce, quindi un template la percorre sempre. Presente solo su .context.uses per una FeatureRecipe che dichiara readsTargetRenderFacts — le cui associazioni vengono renderizzate una volta che ogni componente è stato renderizzato, quindi il rendering di ogni destinazione è completo — e in tal caso in ogni voce, vuoto per una destinazione i cui provider non riportano nulla. Assente per ogni altra FeatureRecipe, dal with e dal when di un passo della pipeline, dai template della Recipe propria del componente e dalle liste di archi che legge una FeatureRecipe con ambito di confine. |
Non sono consentite proprietà aggiuntive.
enriched_edge.inject
La mappatura inject originale dello sviluppatore per questo arco (chiavi = nomi delle variabili locali, valori = chiavi provides della destinazione). Questa è la mappatura GREZZA, non i valori risolti.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
env | mappa di string | no | Consegna tramite variabili d’ambiente: le chiavi sono i nomi delle variabili locali del consumatore, i valori sono le chiavi provides della destinazione. |
file | mappa di string | no | Consegna tramite montaggio di file: le chiavi sono i percorsi dei file locali del consumatore, i valori sono le chiavi provides della destinazione. |
arg | mappa di string | no | Consegna tramite argomenti della riga di comando: le chiavi sono i prefissi dei flag del consumatore, i valori sono le chiavi provides della destinazione. |
enriched_edge.annotations
I tre contenitori di annotazioni a cascata del nodo di destinazione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
release | mappa di string | no | Stringhe di topologia fisica provenienti dai confini della Release del nodo di destinazione. |
catalog | mappa di string | no | Tratti immutabili provenienti dall’entità di catalogo del nodo di destinazione. |
aggregate | mappa di string | no | Metadati cognitivi provenienti dai sottosistemi dell’Aggregate del nodo di destinazione. |
Non sono consentite proprietà aggiuntive.