Solo catalogo — MariaDB + Adminer senza scrivere alcuna entità di piattaforma
Questo esempio distribuisce uno stack piccolo e reale — un database MariaDB con davanti un’interfaccia web Adminer — facendo riferimento solo a entità del catalogo della libreria standard. Qui non si scrive alcun Component, Feature o Recipe: tre brevi file YAML instradano tutto verso entità che il catalogo fornisce già.
È la superficie di authoring più piccola che Aggrega offra, e il primo contatto naturale con il linguaggio. L’esempio gemello del livello authoring distribuisce lo stesso stack costruendo il proprio livello di catalogo — leggi prima questo esempio per vedere che cosa ti offre un catalogo finito, poi quello per imparare come è fatto il livello sottostante.
I tre file
aggregate.yaml— l’intento dello sviluppatore: che cosa è lo stack. Due componenti scelti dal catalogo tramitetype:, una credenziale obbligatoria come associazione che riempie uno slot, e un arcousesche collega il database al socketdatabasesdi Adminer.release.yaml— l’adempimento per ambiente dell’operatore: quanto grande e dove. I blocchiinfra:(versione del motore, dimensione dello storage, porta pubblicata) appartengono all’operatore; l’Aggregate non li porta mai.manifest.yaml— l’instradamento dell’operatore: quale Recipe realizza ciascun tipo su questa destinazione. Più sotto si spiega perché i riferimenti sono qualificati per provider.
Che cosa dimostra
- I Components come riferimenti al catalogo.
type: core/datastore/mariadbetype: core/devtool/adminersono l’intera dichiarazione delle risorse di calcolo. Lo sviluppatore scrive solo i valori che gli schemi dei Component espongono — ogni campo omesso prende il valore predefinito del suo schema (confronta le variabili d’ambiente di charset e collation dell’output renderizzato con il bloccovalues:di una sola riga che le ha prodotte). - La String Pipe. Il Component di catalogo di Adminer dichiara un uses-socket
databasesche accetta qualsiasi componente etichettatocomponent.aggrega.ai/type=stateful-server. L’arco dell’Aggregate inietta ilprovides.hostdella Recipe del database inADMINER_DEFAULT_SERVER. Il compilatore instrada la stringa senza interpretarla — su questa destinazione è il nome di un servizio compose; lo stesso arco su una destinazione Kubernetes porterebbe il nome DNS di un Service. - Il pilastro delle associazioni. Il
featuresSchemadel Component del database richiede uno slotroot_password, riempito con la Featurecore/secret-valuedel catalogo. Lo slot è a scatola nera: la FeatureRecipe selezionata dal Manifest controlla la consegna, e lo sviluppatore non può imporla. - Instradamento della Recipe qualificato per Provider. Il Manifest mappa
core/datastore/mariadb:1.0.0sucompose/mariadb:1.0.0— qualificato per provider — perché la libreria standard fornisce una Recipe mariadb sotto più di un provider (tra cui compose e helm). È la mappatura dell’operatore a disambiguare la destinazione: un riferimento nudo, non qualificato, che corrisponde alla Recipe di più di un provider arresta il build in modo esplicito anziché sceglierne una in silenzio. Per cambiare la destinazione dello stack si ripuntano queste mappature; l’Aggregate non cambia.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example catalog-onlyPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd catalog-onlyBuild
Da questa directory, con le entità del catalogo risolte da hub.aggrega.ai, il registry predefinito che .aggrega-config.yaml nomina:
aggrega pull --release release.yamlaggrega build --release release.yamlIl comando pull risolve ogni entità referenziata e la fissa in release.lock (identità + digest del contenuto; eseguilo di nuovo per rigenerare un lockfile non aggiornato). Con un checkout del catalogo della libreria standard (dove procurarselo), indica la sua directory aggrega-catalog con --catalog su entrambi i comandi per leggere le entità da lì. Il build legge quel lockfile — senza di esso, il build si arresta e nomina le due strade possibili, il comando pull oppure --auto-pull — e renderizza dist/compose/docker-compose.yaml. La Release scrive i suoi componenti direttamente (nessun blocco boundaries:), quindi il compilatore li raccoglie nell’ambito predefinito sintetizzato ed emette in modo piatto sotto dist/ — un solo confine, nessun segmento con il nome del confine nel percorso.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu stesso alcuna cartella. Se la cartella del workspace non contiene ancora una cartella `catalog-only`, chiama una sola volta lo strumento `scaffold` con `example` impostato su `catalog-only` e senza `dir`: scrive l’esempio in una nuova cartella `catalog-only`. Poi chiama lo strumento `build` con `workspace_root` impostato su `catalog-only`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `catalog-only/dist/`.Leggere l’output
Il file compose renderizzato è il punto in cui il cablaggio diventa visibile:
- il servizio
webportaADMINER_DEFAULT_SERVER: db— ilprovides.hostdella Recipe del database (il nome del servizio compose) consegnato attraverso l’arco uses; - lo stesso arco ha prodotto
depends_on: [db]— topologia, non solo stringhe; MARIADB_CHARACTER_SET_SERVEReMARIADB_COLLATION_SERVERdel serviziodbprovengono da valori predefiniti dello schema che l’Aggregate non menziona mai;image: mariadb:11.4e il binding di porta8080:8080provengono dai blocchiinfra:della Release — il pilastro dell’operatore, renderizzato accanto a quello dello sviluppatore.
Esecuzione
cd dist/composedocker compose up -dApri http://localhost:8080: il campo del server è precompilato con db. Accedi come root con la password di sviluppo presa dall’associazione dell’Aggregate (dev-root-pw-change-me — un segnaposto da sostituire in qualsiasi uso che vada oltre lo sviluppo locale), database appdb.
Dove proseguire
Il livello authoring ti fa costruire da te questo stesso livello di piattaforma — i Components, le Recipes e le FeatureRecipes di credenziale che questo esempio ha consumato già pronti — e compila un Aggregate per quattro destinazioni.