Terraform RDS (artefatto HCL inline)
Un singolo database MariaDB scritto una sola volta come intento dello sviluppatore e renderizzato in un file HCL di Terraform che effettua il provisioning di un’istanza AWS RDS gestita.
Questo esempio mostra la forma artifact del provider Terraform: la Recipe porta un corpo main.tf inline sotto artifacts:, e il compilatore emette quel corpo così com’è dopo averne risolto le espressioni di template. Il provider non esegue mai terraform; produce l’HCL che un terraform apply a valle esegue.
File
aggregate.yaml— intento dello sviluppatore: un componentedbdi tipocore/datastore/mariadb, con un nome logico di database. Qui non c’è nulla del target cloud.release.yaml— dimensionamento dell’operatore: versione del motore, storage e HA per il confineinfra. La sua voce perdblega lo slot obbligatorioroot_passworddel Component concore/generated-secret— la Feature di credenziale che dice che è il motore a possedere la credenziale (vedi sotto) — e associacore/backup, che stabilisce per quanto tempo l’istanza conserva i propri backup.manifest.yaml— lega il tipo di componente MariaDB alla Recipe Terraformterraform/mariadb-rds, il tipo di Feature di credenziale aterraform/generated-secret, e il tipo di Feature di backup aterraform/backup-native..aggrega-config.yaml— nomina il registry dell’hub da cui si risolvono le entità del catalogo.
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-rdsPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd terraform-rdsBuild
aggrega build --release release.yaml --auto-pull--auto-pull scrive durante la build il lockfile che manca a un clone appena creato. Il main.tf renderizzato finisce sotto dist/infra/terraform/modules/db/, con la configurazione radice del confine, aggrega.modules.tf, in dist/infra/terraform/ che dichiara db come blocco module che punta a esso. Il corpo si apre con un blocco di provenienza di commenti con # che identifica la build, seguito da un blocco required_providers che vincola la versione del provider AWS, dalla risorsa aws_db_instance risolta — con i valori di storage e HA sostituiti dalla Release, la conservazione dei backup impostata dall’associazione core/backup e le credenziali gestite da RDS tramite manage_master_user_password — e da un output address che porta l’hostname dell’istanza, che la Recipe pubblica come host nella forma ${module.db.address}.
Quel blocco module non porta argomenti, e il motivo è la forma di questo esempio. La Recipe ha scritto il corpo, quindi ha sostituito i valori della Release direttamente nella risorsa; il modulo non dichiara blocchi variable e al compilatore non resta nulla da passare:
module "db" { source = "./modules/db"}Una Recipe che invece incorpora un modulo — l’esempio terraform-rds-module — lascia quegli input non dichiarati nel corpo, così il compilatore li fornisce come argomenti di questo blocco.
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 alcuna cartella da solo. Se la cartella del workspace non contiene ancora una cartella `terraform-rds`, chiama una volta lo strumento `scaffold` con `example` impostato a `terraform-rds` e senza `dir`: scrive l’esempio in una nuova cartella `terraform-rds`. Poi chiama lo strumento `build` con `workspace_root` impostato a `terraform-rds`, `release` impostato a `release.yaml`, `auto_pull` impostato a true e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `terraform-rds/dist/`.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. Un MariaDB self-hosted ha bisogno di una password legata in fase di scrittura; un’istanza RDS gestita no — RDS genera e ruota da sé la password master, e manage_master_user_password in questa Recipe è ciò che lo attiva.
L’operatore lega quindi lo slot nella Release, sulla sua voce per db, con core/generated-secret, la Feature di credenziale il cui materiale appartiene al motore. Che il motore possieda la credenziale dipende dalla Recipe che il Manifest sceglie, quindi il legame spetta all’operatore, e l’Aggregate non dice nulla in merito:
components: db: features: root_password: type: core/generated-secretL’associazione non configura nulla perché non c’è nulla da scrivere, e la FeatureRecipe che il Manifest seleziona (terraform/generated-secret) è puro cablaggio che non renderizza nulla. Così il main.tf renderizzato è byte per byte identico a come sarebbe senza alcuna associazione: lo slot è legato, e per esso non viene emesso alcun artefatto.
Si noti che il riferimento alla FeatureRecipe del Manifest è qualificato dal provider (terraform/generated-secret:1.0.0). 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 generated-secret:1.0.0 non qualificato non si risolve affatto, e la build si arresta in modo evidente anziché scegliere silenziosamente un provider al posto tuo.
Backup su un target gestito
RDS esegue da sé il backup dell’istanza, conservando ciascun backup automatico per 7 giorni quando nulla dice altrimenti. L’operatore lo cambia associando core/backup nella Release, accanto alla credenziale:
backup: type: core/backup infra: retention_days: 14Il Manifest lega la Feature a terraform/backup-native, che non renderizza nulla di proprio: il backup è un’impostazione dell’istanza, quindi la Recipe legge l’associazione e la scrive nella risorsa che già renderizza. La sezione di backup di aws_db_instance in main.tf:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14Un infra.schedule come 30 2 * * * imposterebbe anche il backup_window dell’istanza a 02:30-03:00, letto in UTC; se omesso, come qui, è RDS a scegliere la finestra. Un valore che RDS non può mantenere — una conservazione superiore a 35 giorni, una programmazione diversa da un orario di ogni giorno — arresta la build nominando l’associazione.