Filosofia dell’ecosistema
La filosofia dell’ecosistema
L’architettura di Aggrega è guidata da principi di progettazione fondamentali che bilanciano flessibilità e prevedibilità. Mantenendo confini chiari e contratti standardizzati, un compilatore fondamentalmente generico può orchestrare senza soluzione di continuità qualsiasi cosa, dall’infrastruttura cloud-native standard fino all’intelligenza AI altamente specializzata.
1. Meccaniche di base: la fisica dell’architettura
- Separazione delle responsabilità (legge di Conway): gli sviluppatori non scrivono codice di infrastruttura fisica, e gli Ops non codificano in modo fisso la logica applicativa. Le indicazioni dell’architettura suddividono la scrittura in confini Domain-Driven, una separazione che il compilatore non impone (vedi Invariante 7).
- Late binding (inversione delle dipendenze): gli sviluppatori richiedono interfacce astratte (ad es.
type: enterprise-agent), non implementazioni specifiche (ad es.helm-chart-v2). Il Manifest risolve l’interfaccia nell’implementazione corretta in fase di compilazione, consentendo veri deployment multi-target a partire da un unico file sorgente. - Purezza AOT (nessun recupero dal cloud live): Il compilatore è agnostico rispetto al cloud live. Non si autentica mai presso le API dell’infrastruttura né recupera indirizzi IP live durante la compilazione. Opera interamente sull’inversione del controllo, mappando puntatori deterministici e passando in anticipo contratti di iniezione astratti, così che l’ambiente di runtime possa risolvere in sicurezza le connessioni fisiche finali.
2. L’esperienza dello sviluppatore: intento e astrazione
- Esperienza semantica dello sviluppatore (lo standard della mappa a 5 parole chiave): per prevenire attriti cognitivi, gli sviluppatori usano esattamente cinque parole chiave universalmente comprese all’interno di una topologia YAML basata su mappe:
parameters: il contratto d’ambiente globale (ad es. il passaggio di dimensioni dinamiche dei dischi).values: il payload centrale della logica cognitiva/di business (di proprietà degli sviluppatori).uses: gli archi di rete e le dipendenze dichiarati esplicitamente (di proprietà degli sviluppatori).infra: l’impronta fisica e il dimensionamento meccanico (di proprietà degli Ops, vietato nell’Aggregate).inject: il contratto di consegna rigoroso che mappa le variabili locali sulle chiavi di destinazione di provides (env,file,arg). Questo meccanismo è estensibile.
- Terminologia indipendente dalle capability: per evitare che le realtà dell’infrastruttura sottostante (come il termine Kubernetes
namespace) si riversino nell’esperienza dello sviluppatore, la piattaforma utilizza concetti universali comeboundaries. - Intento esplicito e il «guardrail rumoroso» (nessuna infrastruttura fantasma): il compilatore non deve mai inventare risorse di calcolo o funzionalità che lo sviluppatore non ha dichiarato esplicitamente. Usare un motore di policy per iniettare silenziosamente un proxy di sicurezza crea «infrastruttura fantasma»: quando si guasta, lo sviluppatore finisce per fare il debug di un proxy che non esiste nel suo YAML. Invece di modificare silenziosamente l’architettura, i plugin di policy Wasm agiscono rigorosamente come guardrail rumorosi. Se una topologia viola la sicurezza, il compilatore interrompe la build e restituisce un errore molto specifico (ad es. «Errore: dati PII che fluiscono verso un provider di modelli attraverso il gateway AI
router. Devi collegarvi esplicitamente la funzionalitàcore/data-masking»), costringendo lo sviluppatore a correggere la propria unica fonte di verità.
3. Il compilatore privo di opinioni: elaborazione e orchestrazione
- Policy programmabili (il compilatore privo di opinioni): Il compilatore Go di base è un meccanismo di calcolo neutrale rispetto ai contenuti. Analizza YAML, attraversa grafi e valuta le intersezioni di label. La vera «intelligenza» (ad esempio, imporre che il traffico verso i modelli che trasporta dati riservati passi attraverso un gateway AI che maschera il testo sensibile) viene programmata dinamicamente dall’azienda tramite socket WebAssembly (Wasm) collegabili per le mutazioni dell’albero sintattico astratto (AST)—che alterano la rappresentazione in memoria della configurazione analizzata—e per la validazione delle policy.
- Agnosticismo rispetto agli schemi (dizionario open source): Il compilatore di base è agnostico rispetto ai livelli di esecuzione fisici. Non possiede schemi codificati in modo fisso per Helm, Terraform o Docker Compose. Al contrario, il blocco
sourcedi una Recipe di Ops è un dizionario aperto le cui chiavi sono definite dal provider e arrivano ai template della Recipe come.source.*. Il core risolve una source recuperata tramite una forma integrata{ kind, url, version }(kind:helm-oci-chart,helm-https-chart,compose-https-fragment,git-repository), che già disaccoppia il compilatore dai linguaggi cloud che manipola. Consulta il riferimentosourcedella Recipe per il modello di recupero. - Orchestrazione esplicita dei Plugin: il compilatore Go centrale agisce rigorosamente come costruttore di grafi neutrale e non indovina mai come elaborare un nodo. Tutta l’intelligenza di dominio è invece orchestrata esplicitamente tramite socket WebAssembly (Wasm) dedicati, su due livelli distinti.
1. Socket globali: le policy e la formattazione aziendali sono valutate da socket del compilatore registrati esplicitamente (ad es. il ruolo di governance
label-transformper l’auto-tagging dei metadati, un ruolo di governance di verdetto per la sicurezza topologica e il socket del renderer per la generazione finale degli artefatti). 2. Pipeline di implementazione: la logica di mutazione specifica del Component è orchestrata dalManifest; quando questo risolve un’interfaccia astratta in unaRecipeconcreta, tale implementazione dichiara esplicitamente un array sequenzialepipelinedi plugin Wasm da eseguire. Il compilatore si limita a fornire il grafo della rappresentazione intermedia (IR), indipendente dalle capability, a questi socket definiti, garantendo che tutta la logica specifica di dominio resti rigorosamente versionata nell’ecosistema anziché codificata in modo fisso nel nucleo del compilatore. - Compilazione piatta e atomicità delle Feature: Aggrega non gestisce lo stato, non interroga endpoint e non attende la conclusione di un rollout. Il compilatore valuta i moduli annidati e li risolve in un grafo piatto e monodimensionale di rappresentazione intermedia (IR) prima di passare i dati ai plugin di rendering Wasm. Soprattutto, sebbene il grafo venga appiattito, il compilatore preserva l’atomicità delle Feature. Se una funzionalità proxy dichiara autonomamente un arco di rete verso un vault sicuro, il compilatore registra l’origine semantica di quell’arco, così che i motori di policy Wasm possano eseguire ricerche $O(1)$ senza attribuire erroneamente la connessione al componente padre. Infine, per supportare la sequenzializzazione temporale, ogni confine nella Release riporta un valore
syncWave: <integer>; ogni plugin di rendering traduce l’ondata del confine nel mezzo con cui il proprio target esprime l’ordinamento — un’annotazione dell’ordine di esecuzione letta dal controller GitOps a valle, oppure una dipendenza tra i servizi del file che produce — mentre un target del tutto privo di una superficie di ordinamento registra l’ondata senza basarvi alcuna sequenza.
4. L’ontologia semantica: identificazione e tassonomia
- L’ontologia operativa cloud-native: per garantire che i plugin Wasm open source e le policy aziendali possano interoperare universalmente, l’etichetta
component.aggrega.ai/typecorrisponde esclusivamente a un insieme chiuso di primitive cloud universali (server,worker,task,function,stateful-server,resource). Questa è la chiave propria di Aggrega: lo schema pubblicato del Component enumera i valori che assume, e un documento che ne riporti qualsiasi altro viene rifiutato al caricamento. Fissare centralmente quel vocabolario è ciò che garantisce che i motori di policy autonomi e i plugin di rendering Wasm costruiti dalla comunità leggano la stessa parola per la stessa forma quando incontrano un Component che nessuno dei loro autori ha scritto. Il compilatore comunque non inferisce nulla dalla stringa: confronta il valore con un selettore e non effettua alcun provisioning di propria iniziativa; ciò che l’insieme chiuso garantisce è che il selettore di ciascuno confronti lo stesso vocabolario. - Classificare su un asse che Aggrega non definisce: l’insieme chiuso copre questa unica chiave riservata. Un catalogo che necessita di una propria classificazione (un livello, una zona dati, una classe di servizio, una suddivisione più fine delle primitive) definisce la propria chiave di etichetta accanto a quella riservata, poiché lo schema del Component accetta qualsiasi ulteriore chiave di etichetta con un valore stringa e ogni superficie di selezione la legge allo stesso modo. L’estensione avviene sulla tua chiave, non all’interno di quella di Aggrega, ed è questo che permette a un vocabolario aziendale di crescere senza che quello condiviso diverga.
- Duck typing (tratti semantici tramite etichette): se i tipi di base sono puramente cloud-native, tutta l’intelligenza cognitiva, operativa e di conformità è stratificata interamente tramite duck typing semantico. Le etichette definite dal Platform Architect (ad es.
model.aggrega.ai/capability: generative,compliance.aggrega.ai/data-class: restricted) fungono da vera identità del nodo. Le Features si legano dinamicamente ai componenti in base a questi selettori di etichette.
5. Governance aziendale: schemi ed ereditarietà
-
Partizionamento rigoroso delle API e rintracciabilità aziendale: seguendo gli standard Kubernetes, tutte le definizioni di payload risiedono uniformemente in un blocco
spec:. L’identità della risorsa, le etichette caratteristiche e le istruzioni esplicite per il compilatore risiedono rigorosamente nel bloccometadata:. Per garantire una risoluzione rigorosa, ogni artefatto YAML condivisibile impone rigorosamente una stringa SemVerversionverificata tramite espressione regolare. Inoltre, per supportare la rintracciabilità nei registri OCI e la governance del ciclo di vita, il bloccometadatasupporta una suite di metadati aziendali opzionale. Questa suite includedescription, un array strutturato di oggettimaintainers(nome, email, url),license,repository,home(URL della documentazione) ekeywords(per l’indicizzazione nella ricerca). La fine del ciclo di vita si gestisce fuori dal documento:aggrega deprecateallega un marcatore di deprecazione firmato — una gravità, un motivo e un’eventuale sostituzione — a un artefatto già pubblicato senza modificarne i byte pubblicati. -
Estensibilità degli schemi (il pattern CRD di Kubernetes): per evitare di aggiornare lo schema del compilatore centrale per ogni nuova funzionalità AI o di infrastruttura, la piattaforma usa JSON Schema 2020-12 per validare le configurazioni. I Platform Architect scrivono tipi rigorosi, logica di validazione e valori predefiniti direttamente nel blocco
schema:dei componenti del catalogo, di norma in forma compatta, una notazione abbreviata dall’aspetto YAML che fa stare su una riga i vincoli di ciascun campo (port: { type: integer, min: 1, max: 65535, default: 8080 }) e viene compilata in JSON Schema 2020-12 prima dell’esecuzione della validazione. Lo YAML in JSON Schema completo resta un’opzione di authoring di pari livello per gli schemi che richiedono il suo vocabolario completo. I cataloghi che crescono abbastanza da trarre vantaggio dal riuso degli schemi tra un Component e l’altro spostano le forme comuni (blocchi di probe, limiti delle risorse, forme di porte con nome) in un’entità dedicata SchemaLibrary e vi fanno riferimento tramite la parola chiave JSON Schema$ref:. -
Ereditarietà degli schemi (baseline del payload): per mantenere una baseline definita una sola volta, la piattaforma divide l’ereditarietà in due livelli distinti. I metadati YAML standard (incluse le etichette semantiche), le mappature del
Manifeste le configurazioni dellaReleaseutilizzano strategie di merge tradizionali per consentire le necessarie sostituzioni per ambiente. Gli schemi del payload (schema:) non si uniscono in quel modo, e i due tipi di catalogo prendono strade diverse: loschema:di una Feature si compone con quello della sua base secondo la semantica di composizione di JSON Schema 2020-12, percorso al caricamento del workspace da un merger che etichetta la provenienza per posizione nel sorgente, così che ogni foglia dello schema unito riporti il file da cui proviene; un Component che estende non definisce alcun contenuto di payload: scrive il marcatore letteraleschema: inheritede riceve il blocco della sua base esattamente come la base lo ha definito, a ogni profondità di una catena. La baseline di un Component è quindi garantita per costruzione anziché per policy: il contratto del figlio è semplicemente quello della base, quindi non c’è nulla che il figlio possa allentare. Ciò che un tale Component compone invece è la struttura (i suoi slot di collegamento, i socket di topologia, l’allowlist di self-inject e leassertionscon nome), e un figlio che necessita di una regola più restrittiva di quella dichiarata dalla sua base la esprime come voceassertions:aggiuntiva, che si affianca alle regole della base anziché sostituirle. La sicurezza topologica più ampia e la governance delle etichette restano opportunamente delegate al socket di governance Wasm. -
Parità di interfaccia e implementazione automatica: per evitare che gli Ops duplichino gli YAML delle Recipe quando un Architect crea una variante leggermente modificata di un Component di base, una Recipe scritta per una base serve ogni Component che la estende, a qualsiasi profondità della catena. Il Component che estende scrive
schema: inherited, quindi non aggiunge avalues/infra/providesalcuna chiave radice che la Recipe della base non sarebbe in grado di consumare. Il Manifest mappa comunque il tipo che estende con una voce propria, e il controllo della mappatura accetta quella voce quando l’implementsdella Recipe mappata nomina il tipo o una qualsiasi base che esso estende (vedi Una Recipe scritta per una base serve tutto ciò che la estende). Il tracker dell’infrastruttura fantasma (che emette avvisi quando nessun template dichiarato dalla Recipe associata legge una chiave scritta, per evitare l’«infrastruttura fantasma») è il guardrail corrispondente nella fase di rendering. -
Corrispondenza della versione di
implements: il campoimplementsdelle Recipes e delle FeatureRecipes supporta tre forme per bilanciare il rigore con la flessibilità dell’ecosistema:- Versione esatta:
implements: "core/api-server:1.0.0"— corrisponde solo a1.0.0. Per le Recipes strettamente legate a una specifica versione dello schema. - Compatibile con la major (intervallo SemVer):
implements: "core/api-server:^1.0.0"— corrisponde a>=1.0.0, <2.0.0. Pensata per le Recipes che si affidano alle garanzie di compatibilità SemVer del Component: si presume che gli incrementi minor e patch siano retrocompatibili secondo SemVer, e il compilatore verifica che la versione del Component soddisfi l’intervallo. - Senza versione:
implements: "core/api-server"— corrisponde a qualsiasi versione. Per le Recipes realmente indipendenti dalla versione (ad es. una Recipe generica per worker che usa solo.context.inject.enve nessun campovaluesspecifico di una versione).
implementsnon seleziona mai una Recipe: il Manifest nomina la Recipe per ciascun tipo di componente, e il compilatore verifica che l’implementsdella Recipe mappata accetti quel tipo in una delle tre forme, interrompendosi in caso di mancata corrispondenza. La stessa dichiarazione è il modo in cui il compilatore suggerisce Recipes candidate quando un tipo di componente non ha alcuna mappatura.Il pattern a tre forme consente alle Recipes di dichiarare il contratto di versione adatto al loro effettivo accoppiamento con lo schema del Component. Le Recipes strettamente legate a una specifica versione dello schema la fissano esattamente; le Recipes che si affidano alle garanzie di compatibilità SemVer del Component usano un intervallo compatibile con la major; le Recipes il cui comportamento non dipende affatto dalla versione del Component restano senza versione. Il risultato è che gli incrementi minor della versione del Component non costringono gli Ops né a fissare le versioni dei Component né a mantenere Recipes parallele per ciascuna versione.
- Versione esatta: