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

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 tramite type:, una credenziale obbligatoria come associazione che riempie uno slot, e un arco uses che collega il database al socket databases di Adminer.
  • release.yaml — l’adempimento per ambiente dell’operatore: quanto grande e dove. I blocchi infra: (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/mariadb e type: core/devtool/adminer sono 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 blocco values: di una sola riga che le ha prodotte).
  • La String Pipe. Il Component di catalogo di Adminer dichiara un uses-socket databases che accetta qualsiasi componente etichettato component.aggrega.ai/type=stateful-server. L’arco dell’Aggregate inietta il provides.host della Recipe del database in ADMINER_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 featuresSchema del Component del database richiede uno slot root_password, riempito con la Feature core/secret-value del 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.0 su compose/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:

Terminal window
aggrega scaffold --example catalog-only

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd catalog-only

Build

Da questa directory, con le entità del catalogo risolte da hub.aggrega.ai, il registry predefinito che .aggrega-config.yaml nomina:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Il 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 web porta ADMINER_DEFAULT_SERVER: db — il provides.host della 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_SERVER e MARIADB_COLLATION_SERVER del servizio db provengono da valori predefiniti dello schema che l’Aggregate non menziona mai;
  • image: mariadb:11.4 e il binding di porta 8080:8080 provengono dai blocchi infra: della Release — il pilastro dell’operatore, renderizzato accanto a quello dello sviluppatore.

Esecuzione

Terminal window
cd dist/compose
docker compose up -d

Apri 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.