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

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àTipoObbligatoriaDescrizione
contextobjectsìIl contesto di esecuzione assemblato dal compilatore, che fornisce dati di identità, topologia e consegna.
valuesobjectsìIl payload cognitivo opaco per questo nodo, già validato dal validatore di schema alla risoluzione. Passato senza modifiche.
infraobjectsìIl payload di dimensionamento fisico iniettato dalla Release per questo nodo. Scavalca completamente lo sviluppatore.
localsmappa di stringsì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.’ a una voce successiva, o a una chiave che il blocco non dichiara, provoca un arresto. Il controllo legge il percorso in cui un riferimento SI RISOLVE anziché i tasti digitati, quindi copre allo stesso modo la forma diretta, una lettura all’interno di un blocco ’{{ with .locals }}’, una lettura tramite una variabile legata direttamente a ‘.locals’, e una chiave letta dal blocco tra parentesi, ‘(.locals).’ o ’($.locals).’. Una grafia che non copre: un riferimento il cui percorso il testo del template non determina — uno raggiunto tramite una funzione, come ‘index .locals’ o ‘(default dict .locals).’, o tramite un blocco ‘with’ o un legame di variabile la cui pipeline ne applica una. Non viene analizzato, e una chiave assente raggiunta in quel modo non provoca un arresto: nel rendering produce il testo letterale '' anziché nulla del tutto. L’unica eccezione è ‘index’ stesso: su ogni superficie di template provoca un arresto, nominando la chiave, quando la mappa che legge non contiene la chiave richiesta, quindi una chiave assente raggiunta tramite ‘index .locals’ provoca un arresto. Una voce di locals non può leggere ‘.provides’. Disponibile in provides (alla valutazione dei provides, dopo il preambolo), source, valuesMapping, workload, artifacts, assertions, e per i plugin Wasm a valle tramite pipeline[].with (e pipeline[].when). Mai esposto ai chiamanti.
providesmappa di stringnoIl 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.
featuresmappa di template_attachmentnoOgni 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..features., così un template che percorre questo pilastro incontra solo le associazioni proprie del nodo.
metadataobjectnoMetadati 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_namestringnoPopolato 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.
injectobjectnoPopolato 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_rawobject o nullnoL’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.
stepsmappa di objectnoComunicazione 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.
sourcestring o object o nullnoContenuto 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).
workloadworkload-v1beta1.schema.json o nullnoSpec 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.
boundaryobjectnoContesto 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àTipoObbligatoriaDescrizione
instance_idstringsì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_namestringnoIl 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 }}’.
labelsmappa di stringnoLe 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.
annotationsobjectnoI tre contenitori di annotazioni a cascata del nodo corrente, separati per origine.
injectobjectsì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.
usesmappa di enriched_edgesì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_injectobjectsì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..inject mappa i nomi di una connessione alle chiavi che leggono: ‘provides.’ per una voce scritta con from: ; ‘values.’ per una voce il cui template value: legge esattamente uno dei values propri del componente e nient’altro, dove è la chiave di primo livello di quel valore, qualunque testo o funzione circondi la lettura e per quanto in profondità essa legga nel valore — ’{{ .values.config.port }}’, ’{{ index .values.config “port” }}’ e ’{{ (default dict .values.config).port }}’ corrispondono tutti a ‘values.config’; e una stringa vuota per ogni altra voce — un letterale, un template che legge due valori, un template che legge qualcosa oltre ai values, o un template la cui lettura dei values il testo non attribuisce a una sola chiave di primo livello, come ’{{ index .values “role” }}’, i values letti per intero, o l’intero contesto passato a una funzione. Così una Recipe che consegna un proprio valore sotto un nome predefinito verifica se qualche voce corrisponde già a ‘values.’ e, se ce n’è una, salta il proprio nome predefinito, ad es. {{ range $name, $key := .context.self_inject.env }}{{ if eq $key “values.role” }}…{{ end }}{{ end }}. Presente e vuoto quando lo sviluppatore non ha scritto alcun blocco; un meccanismo compare solo quando il blocco lo nomina, e un template incontra i nomi ordinati in qualunque modo li legga. Letto dal testo scritto dallo sviluppatore, mai da un valore risolto.
used_byinbound_edge[]noI 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_factsrender_factsnoCiò 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àTipoObbligatoriaDescrizione
releasemappa di stringnoStringhe di topologia fisica che discendono a cascata dai confini della Release.
catalogmappa di stringnoTratti intrinseci immutabili scritti dal Platform Architect nel Dominio 2.
aggregatemappa di stringnoMetadati 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àTipoObbligatoriaDescrizione
envmappa di stringnoConsegna tramite variabili d’ambiente. Le chiavi sono i nomi delle variabili locali dello sviluppatore, i valori sono le stringhe risolte della destinazione.
filemappa di stringnoConsegna tramite mount di file. Le chiavi sono percorsi di file locali, i valori sono le stringhe risolte della destinazione.
argmappa di stringnoConsegna tramite argomenti della riga di comando. Le chiavi sono prefissi di flag, i valori sono le stringhe risolte della destinazione.
allmappa di stringnoUnione 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..inject mappa i nomi di una connessione alle chiavi che leggono: ‘provides.’ per una voce scritta con from: ; ‘values.’ per una voce il cui template value: legge esattamente uno dei values propri del componente e nient’altro, dove è la chiave di primo livello di quel valore, qualunque testo o funzione circondi la lettura e per quanto in profondità essa legga nel valore — ’{{ .values.config.port }}’, ’{{ index .values.config “port” }}’ e ’{{ (default dict .values.config).port }}’ corrispondono tutti a ‘values.config’; e una stringa vuota per ogni altra voce — un letterale, un template che legge due valori, un template che legge qualcosa oltre ai values, o un template la cui lettura dei values il testo non attribuisce a una sola chiave di primo livello, come ’{{ index .values “role” }}’, i values letti per intero, o l’intero contesto passato a una funzione. Così una Recipe che consegna un proprio valore sotto un nome predefinito verifica se qualche voce corrisponde già a ‘values.’ e, se ce n’è una, salta il proprio nome predefinito, ad es. {{ range $name, $key := .context.self_inject.env }}{{ if eq $key “values.role” }}…{{ end }}{{ end }}. Presente e vuoto quando lo sviluppatore non ha scritto alcun blocco; un meccanismo compare solo quando il blocco lo nomina, e un template incontra i nomi ordinati in qualunque modo li legga. Letto dal testo scritto dallo sviluppatore, mai da un valore risolto.

ProprietàTipoObbligatoriaDescrizione
envmappa di stringnoConsegna tramite variabili d’ambiente: le chiavi sono i nomi di variabile dello sviluppatore, i valori sono la chiave propria che ciascuna voce consegna.
filemappa di stringnoConsegna tramite montaggio di file: le chiavi sono i percorsi di file dello sviluppatore, i valori sono la chiave propria che ciascuna voce consegna.
argmappa di stringnoConsegna 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àTipoObbligatoriaDescrizione
release_namestringnoIl 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_versionstringnoLa versione semantica della Release.
environmentstringnoLa stringa dell’ambiente presa dai metadati della Release (ad es. ‘production’, ‘local’).
aggregate_namestringnoIl 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àTipoObbligatoriaDescrizione
envmappa di stringnoConsegna tramite variabili d’ambiente con ambito dell’associazione.
filemappa di stringnoConsegna tramite mount di file con ambito dell’associazione.
argmappa di stringnoConsegna tramite argomenti con ambito dell’associazione.
allmappa di stringnoUnione 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àTipoObbligatoriaDescrizione
pathstringnoIl 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_pathstringnoLa 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_namestringnoIl nome del confine (la chiave della mappa in release.spec.boundaries).
componentsobjectnoMappa 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_edgesobject[]noArchi uses in cui la sorgente E la destinazione si trovano entrambe nel sottoalbero di questo confine.
outgoing_cross_boundary_uses_edgesobject[]noArchi uses la cui sorgente si trova nel sottoalbero di questo confine e la cui destinazione ne è al di fuori.
incoming_cross_boundary_uses_edgesobject[]noArchi 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_edgesobject[]noUnione di comodo degli archi tra confini in uscita e in entrata.
labelsmappa di stringnoUnione delle etichette dei componenti nel sottoalbero, con conservazione dell’ordine dell’autore.
annotationsmappa di stringnoLe annotazioni proprie del confine dopo la risoluzione della cascata.
feature_attachmentstemplate_attachment[]noLe 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àTipoObbligatoriaDescrizione
component_idstringsì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..target scrive l’altro estremo di una connessione.
socketstringsìLa categoria di usesSchema attraverso cui il componente che si connette traccia questa connessione (ad es. ‘databases’, ‘apis’).
providesmappa di stringsì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..provides. Vuoto quando non ne pubblica nessuno.
source_namespacestringnoIl 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_pathstringnoIl 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_factsrender_factsnoCiò 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. si legge allo stesso modo sia che quel nome sia uno slot dichiarato dall’entità sia che sia un’associazione libera.

ProprietàTipoObbligatoriaDescrizione
typestringnoL’URI di Feature di catalogo della Feature associata.
resolved_versionstringnoLa versione della Feature associata dopo la risoluzione del Manifest — la versione effettivamente legata per questa build, letta come .features..resolved_version. Rispecchia .context.uses..resolved_version, quindi un’associazione e un arco riportano una versione legata allo stesso modo. Vuoto quando il tipo dell’associazione non si risolve in alcuna entità di catalogo.
labelsmappa di stringnoLe 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..labels. La chiave è del tutto assente quando la Feature non dichiara etichette e quando il tipo dell’associazione non si risolve in alcuna entità di catalogo, quindi proteggila con if o percorri la mappa prima di accedere a una singola etichetta.
valuesobjectnoIl pilastro dell’intento dello sviluppatore proprio dell’associazione, portato alla lettera dalla dichiarazione dell’associazione.
infraobjectnoIl pilastro del dimensionamento operativo proprio dell’associazione, portato alla lettera dalla dichiarazione dell’associazione.
providesmappa di stringnoIl 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..provides.. Il consumatore legge questi valori invece di ricavare di nuovo l’identità fisica dell’associazione. Un’associazione la cui FeatureRecipe legata non pubblica nulla non porta affatto una chiave provides, anziché una mappa vuota, quindi un template si protegge prima di accedere a una singola chiave.

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àTipoObbligatoriaDescrizione
targetstringsìL’ID assoluto appiattito del nodo di destinazione (ad es. ‘data-layer.main-db’).
socketstringsìLa categoria di usesSchema a cui appartiene questo arco (ad es. ‘databases’, ‘apis’).
sourcestringnoL’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_namespacestringnoAnnotazione 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_pathstringnoPercorso 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_pathstringnoPercorso 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_namespacestringnoAnnotazione 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_pathstringnoPercorso 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_pathstringnoPercorso 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.
providesmappa di stringsìIl dizionario provides completamente risolto del nodo di destinazione. Valutato alla valutazione dei provides, prima dell’idratazione di inject.
injectobjectsì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.
labelsmappa di stringnoLe etichette di duck-typing e di ontologia del nodo di destinazione (dopo le modifiche apportate durante la costruzione della topologia).
annotationsobjectnoI tre contenitori di annotazioni a cascata del nodo di destinazione.
componentstringnoL’URI del tipo di componente di catalogo del nodo di destinazione (ad es. ‘core/postgres’).
resolved_versionstringnoLa SemVer risolta del nodo di destinazione.
boundary_pathstringnoLa gerarchia spaziale fisica del nodo di destinazione presa dalla Release (ad es. ‘aws-eks-cluster/backend-ns’).
origin_featurestringnoSe 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_releasebooleananoVale true quando è la Release ad aver collegato questa connessione anziché l’Aggregate ad averla dichiarata. Assente per una connessione che l’Aggregate dichiara.
valuesobjectnoLa 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.
infraobjectnoLa 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.
featuresmappa di template_attachmentnoLe 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..features..provides., così un consumatore che raggiunge più destinazioni legge la credenziale propria di ciascuna destinazione. Queste associazioni non fanno mai parte del .features proprio del nodo consumatore, quindi un template che percorre .features per trovare le associazioni del nodo per tipo non incontra quelle di una connessione. Percorsi in un template, gli slot arrivano in ordine di chiave. Assente quando la connessione non ne porta alcuna.
render_factsrender_factsnoCiò 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àTipoObbligatoriaDescrizione
envmappa di stringnoConsegna tramite variabili d’ambiente: le chiavi sono i nomi delle variabili locali del consumatore, i valori sono le chiavi provides della destinazione.
filemappa di stringnoConsegna tramite montaggio di file: le chiavi sono i percorsi dei file locali del consumatore, i valori sono le chiavi provides della destinazione.
argmappa di stringnoConsegna 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àTipoObbligatoriaDescrizione
releasemappa di stringnoStringhe di topologia fisica provenienti dai confini della Release del nodo di destinazione.
catalogmappa di stringnoTratti immutabili provenienti dall’entità di catalogo del nodo di destinazione.
aggregatemappa di stringnoMetadati cognitivi provenienti dai sottosistemi dell’Aggregate del nodo di destinazione.

Non sono consentite proprietà aggiuntive.