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

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 componente db di tipo core/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 confine infra. La sua voce per db lega lo slot obbligatorio root_password del Component con core/generated-secret — la Feature di credenziale che dice che è il motore a possedere la credenziale (vedi sotto) — e associa core/backup, che stabilisce per quanto tempo l’istanza conserva i propri backup.
  • manifest.yaml — lega il tipo di componente MariaDB alla Recipe Terraform terraform/mariadb-rds, il tipo di Feature di credenziale a terraform/generated-secret, e il tipo di Feature di backup a terraform/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:

Terminal window
aggrega scaffold --example terraform-rds

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

Terminal window
cd terraform-rds

Build

Terminal window
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-secret

L’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: 14

Il 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 = 14

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