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

Entità per ruolo

Ogni tipo di entità ha un ruolo che tipicamente lo scrive. Questa pagina è la mappa completa — usala quando conosci il tuo aspetto ma non ancora il file a cui appartiene. L’assegnazione dei ruoli è un’indicazione, non un vincolo imposto dal compilatore (vedi Personas); nomina chi di solito possiede un tipo in una configurazione ben fattorizzata.

La mappa in sintesi

RuoloTipi di entitàAspetto
SviluppatoreAggregateIntento applicativo: che cos’è l’app e di che cosa ha bisogno
Architetto della piattaformaComponent, FeatureIl contratto di catalogo riutilizzabile e versionato
Operations della piattaformaRecipe, FeatureRecipe, Plugin di rendering dei providerTraduzione specifica del Provider in infrastruttura renderizzata
Operatore della piattaformaManifest, ReleaseRouting e collegamento del deployment
Supporto trasversaleSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, WorkloadForme condivise, codice di estensione e il tipo del compilatore di proprietà della piattaforma

Sviluppatore

Aggregate — l’unica superficie di authoring dello sviluppatore e l’unica fonte di verità per la topologia dell’applicazione. Dichiara i componenti di cui è composta l’applicazione, i values che ciascuno accetta, le Features il cui comportamento è intento applicativo (con i loro values), i parameters esposti per le variazioni per ambiente e gli archi uses che collegano i componenti tra loro. Resta deliberatamente agnostico rispetto all’infrastruttura fisica: nulla nell’Aggregate nomina un cloud, un cluster o un provider. È questo agnosticismo rispetto alle capacità che permette a un Aggregate di essere distribuito ovunque.

Architetto della piattaforma

Component — un contratto riutilizzabile e versionato per un tipo di elemento costitutivo. Dichiara, tramite uno JSON Schema, i values che uno sviluppatore può fornire; gli output provides che convoglia ai consumatori; e i socket usesSchema che espone per il collegamento. I Components portano le etichette semantiche che guidano policy e rendering. L’architetto mantiene stabile il contratto del Component affinché gli sviluppatori possano farvi affidamento.

Feature — una capacità collegabile che uno sviluppatore o un operatore può aggiungere a un componente: un exporter di metriche, il mascheramento del testo sensibile su un gateway IA, un binding di credenziali. Una Feature dichiara ciò di cui ha bisogno e ciò con cui è incompatibile; il modo in cui viene realizzata — le risorse che genera, o le impostazioni che scrive in ciò che il suo componente già renderizza — risiede nella sua FeatureRecipe.

Operations della piattaforma

Recipe — la realizzazione specifica per provider di un Component. Mappa i valori dichiarati dal Component sull’output di un provider concreto — una release Helm, un servizio Compose, un modulo Terraform — tramite template, e convoglia i valori provides ai consumatori. Una Recipe non cambia mai i valori rivolti allo sviluppatore che un Component dichiara; decide solo come vengono renderizzati.

FeatureRecipe — la realizzazione specifica per provider di una Feature, applicata al momento del binding. Genera le risorse che il collegamento di una Feature implica per un dato provider, oppure scrive le impostazioni che implica in ciò che il componente collegato già renderizza.

Plugin di rendering del Provider — un provider è il guest Wasm che trasforma l’input di una Recipe in manifest nativi del provider. Viene fornito come Plugin con pluginType: provider che dichiara il nome o i nomi dei provider che renderizza e il proprio contratto di socket del provider. Le operations (o un autore di plugin) forniscono i provider affinché le Recipes abbiano un provider rispetto a cui renderizzare. Vedi la Panoramica dei Providers per i provider inclusi e i loro contratti.

Leggere una credenziale in modo sicuro in una Recipe

Una credenziale raggiunge una Recipe sulla pipe di iniezione, .context.inject.env, come qualunque testo il suo autore abbia scelto, quindi può contenere caratteri che un template non può scrivere nello YAML così come sono. Dentro uno scalare tra virgolette doppie, una virgoletta doppia termina il valore in anticipo e una barra rovesciata avvia un escape: la build si interrompe, oppure la barra rovesciata va persa silenziosamente. Esegui l’escape di entrambi nel punto in cui il valore viene scritto:

variables:
{{- $env := optional (default dict .context.inject) "env" dict }}
DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"

optional legge la chiave dalla mappa della pipe con un fallback vuoto, così una password che nulla ha consegnato viene resa come testo vuoto. Le due chiamate replace eseguono l’escape prima della barra rovesciata e poi della virgoletta, in quest’ordine perché l’escape della virgoletta stessa non venga sottoposto di nuovo a escape, e lasciano ogni altro carattere com’era. Un valore letto tramite index, che si interrompe quando la chiave è assente, riceve le stesse due chiamate replace così come sono.

Un carattere che questa forma non trasporta è l’a capo. YAML ripiega un a capo dentro uno scalare tra virgolette doppie in uno spazio, quindi una credenziale che ne contiene uno viene consegnata con uno spazio al posto dell’a capo. Una FeatureRecipe che scrive una credenziale nel proprio injectMapping la scrive invece tramite toJson, che trasporta allo stesso modo una virgoletta, una barra rovesciata e un a capo, come mostra il riferimento della FeatureRecipe.

Quella FeatureRecipe scrive la credenziale sotto il meccanismo da cui la Recipe la legge — env: per .context.inject.env, file:, arg:, oppure un meccanismo proprio del componente sotto il suo nome. .context.inject.all è costruito a partire da quei meccanismi e mai dall’output di una mappatura, quindi una mappatura che scrivesse sotto all: non consegnerebbe nulla; la build invece si interrompe su di essa, nominando l’associazione, la chiave e la FeatureRecipe.

Operatore della piattaforma

Manifest — il livello di routing. Indica al compilatore quale Recipe realizza ciascun Component per un dato target, così lo stesso Aggregate può essere puntato su implementazioni diverse tra ambienti — una Recipe cloud per la produzione, una Recipe Compose per i test locali — senza alcuna modifica al file dello sviluppatore.

Release — l’unico input di compilazione, che registra ciò che un ambiente costruisce. Punta all’Aggregate e al Manifest, soddisfa i parameters esposti dallo sviluppatore, collega le Features i cui input sono operativi, dimensiona con infra quelle collegate dallo sviluppatore e collega archi propri all’interno dei socket dichiarati dall’architetto. Una Release soddisfa i punti di variazione esposti; non può introdurre nuovi values applicativi né nuova capacità di calcolo — questi provengono solo dall’Aggregate.

Tipi di supporto trasversali

Questi tipi servono autori di ruoli diversi anziché appartenere a uno solo.

SchemaLibrary — una libreria condivisa di forme di schema che ricorrono in molti Components e Features. Quando la stessa struttura (ad esempio un blocco di risorse del pod) compare in molte entità, un architetto la fattorizza in una voce di SchemaLibrary così da definirla e aggiornarla una sola volta.

MappingLibrary — una libreria condivisa di logica di mappatura riutilizzabile a cui attingono Recipes e FeatureRecipes, così gli schemi di traduzione comuni hanno un’unica fonte anziché essere copiati.

WorkloadLibrary — una libreria condivisa di contenuto Workload riutilizzabile, così una forma di deployment che ricorre in molte Recipes viene dichiarata una volta e importata in ciascun blocco workload:.

ArtifactLibrary — una libreria condivisa di bundle di artefatti riutilizzabili: insiemi con nome di file di output ausiliari che vanno insieme, come una CRD con il suo RBAC. Una Recipe o una FeatureRecipe importa un bundle in una voce di artifacts: ed emette ogni file che contiene.

Plugin — il tipo di estensione. Oltre al rendering dei provider, i Plugins impacchettano il codice WebAssembly che fornisce intelligenza specifica del dominio — validazione delle policy, mutazione, linting e altri socket. L’authoring di un Plugin è un compito del team di piattaforma che supporta ogni altro ruolo.

Workload — un tipo del compilatore di proprietà della piattaforma, non un file che uno sviluppatore o un operatore scrive a mano come entità di primo livello. Viene consumato all’interno del blocco workload: di una Recipe, dove il provider con cui la Recipe esegue il rendering traduce la forma di workload normalizzata nella propria forma nativa. Gli autori di Recipe interagiscono con esso tramite quel blocco; il riferimento del Workload ne documenta la forma.

Prossimi passi