Terraform RDS (modulo incorporato)
Lo stesso intento MariaDB dell’esempio terraform-rds, renderizzato attraverso la forma sourced del provider Terraform: invece di un corpo HCL inline, la Recipe punta a un modulo Terraform locale e il compilatore lo copia così com’è, poi ne fornisce le variabili di input dai pilastri dello sviluppatore e dell’operatore.
Che cosa emette il compilatore
Sotto dist/infra/terraform/ la build produce la configurazione radice del confine, e sotto dist/infra/terraform/modules/db/ i file propri del componente db:
aggrega.modules.tfalla radice del confine — la configurazione radice, che dichiaradbcome bloccomoduleil cuisourceè./modules/dbe i cui argomenti sono le variabili di input del modulo, in ordine deterministico delle chiavi. Ogni confine terraform ne riceve uno, ed è ciò che mette i componenti di un confine in un’unica configurazione Terraform;- i file del modulo copiati byte per byte (
variables.tf,main.tf, compresa qualsiasi interpolazione${...}scritta dall’autore del modulo); aggrega.provenance.tfaccanto a quei file — un file di commenti con#che identifica la build.
Il blocco db che questo esempio emette:
module "db" { source = "./modules/db"
allocated_storage = 100 backup_retention_period = 14 db_name = "appdb" engine_version = "11.4" instance_class = "db.t3.small" multi_az = true port = 3306 skip_final_snapshot = false storage_type = "gp3" subnet_id = "production-private-db-subnets"}Due di quegli argomenti meritano di essere seguiti fino al punto in cui sono stati scritti. subnet_id è il nome del gruppo di subnet DB che la Release fornisce sotto infra.overrides — il gruppo è gestito al di fuori di questa Release, il suo nome varia per ambiente e la dichiarazione propria del modulo non porta alcun valore predefinito, quindi la Recipe lo esige e la build si arresta in modo evidente quando manca, anziché pianificare sulla rete sbagliata. instance_class proviene dallo stesso pilastro ma porta un valore predefinito nella Recipe, quindi una Release che non indica nulla ottiene db.t3.small.
Qualunque cosa una Recipe mappi in questi argomenti, il compilatore la convoglia senza toccarla e non la risolve mai — compreso un puntatore Terraform ${...}. Ciò che cambia con la posizione è dove arriva quel puntatore: un argomento di modulo è una delle posizioni che Terraform valuta, quindi un puntatore scritto lì viene risolto rispetto alla configurazione radice al momento del piano, anziché raggiungere il modulo come stringa letterale. Deve comunque nominare qualcosa che quella configurazione dichiara.
Poiché gli input sono indicati nella radice, modules/db/ da solo non è una configurazione che si possa pianificare così come viene distribuita — vedi la pagina del provider Terraform per ciò che fa il motore se ci provi.
File
aggregate.yaml— intento dello sviluppatore: un componentedbdi tipocore/datastore/mariadb.release.yaml— dimensionamento dell’operatore per il confineinfra. La sua voce perdblega lo slot obbligatorioroot_passworddel Component concore/generated-secret(vedi sotto), e associacore/backupper conservare ciascuno dei backup automatici dell’istanza per 14 giorni — ilbackup_retention_periodmostrato sopra; senza associazione l’istanza li conserva per 7.manifest.yaml— lega il tipo di componente MariaDB alla Recipe Terraformterraform/mariadb-rds-module, che prende il proprio modulo da una sorgente locale, il tipo di Feature di credenziale aterraform/generated-secret, e il tipo di Feature di backup aterraform/backup-native, che non renderizza nulla: la Recipe legge l’associazione e fornisce da sé gli input di backup del modulo..aggrega-config.yaml— nomina il registry dell’hub da cui si risolvono le entità del catalogo.
Lo slot di credenziali su un target gestito
core/datastore/mariadb dichiara root_password come slot obbligatorio: una build si arresta finché nulla lo lega. RDS genera e ruota da sé la password master, e il modulo incorporato che questa Recipe copia imposta manage_master_user_password per attivarlo — così lo slot viene delegato al motore anziché essere riempito con un valore scritto dall’autore.
Che il motore possieda la credenziale dipende dalla Recipe che il Manifest sceglie, quindi è l’operatore a legare lo slot, nella Release, sulla sua voce per db. Lo lega con core/generated-secret, che non configura nulla perché non c’è nulla da scrivere, e la cui FeatureRecipe (terraform/generated-secret) è puro cablaggio che non renderizza nulla. Il modulo incorporato e la configurazione radice risultano byte per byte identici a come sarebbero senza alcuna associazione. Il riferimento del Manifest è qualificato dal provider perché un nome di ricetta non qualificato si risolve solo quando esattamente un provider lo porta, e la libreria standard distribuisce una FeatureRecipe generated-secret sotto più di uno — quindi un nome non qualificato non si risolve affatto, e la build si arresta in modo evidente anziché scegliere silenziosamente un provider al posto tuo.
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 terraform-rds-modulePoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd terraform-rds-moduleBuild
aggrega build --release release.yaml --auto-pull--auto-pull scrive durante il build il lockfile che manca a un clone appena creato.
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 alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `terraform-rds-module`, chiama una volta lo strumento `scaffold` con `example` impostato su `terraform-rds-module` e senza `dir`: scrive l’esempio in una nuova cartella `terraform-rds-module`. Poi chiama lo strumento `build` con `workspace_root` impostato su `terraform-rds-module`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano sotto `terraform-rds-module/dist/`.