Terraform RDS (module embarqué)
La même intention MariaDB que l’exemple terraform-rds, rendue par la forme sourced du fournisseur Terraform : au lieu d’un corps HCL inline, la Recipe pointe vers un module Terraform local et le compilateur le copie tel quel, puis fournit ses variables d’entrée à partir des piliers du développeur et de l’opérateur.
Ce qu’émet le compilateur
Sous dist/infra/terraform/, le build produit la configuration racine de la frontière, et sous dist/infra/terraform/modules/db/ les fichiers propres du composant db :
aggrega.modules.tfà la racine de la frontière — la configuration racine, déclarantdbcomme un blocmoduledont lesourceest./modules/dbet dont les arguments sont les variables d’entrée du module, dans un ordre de clés déterministe. Chaque frontière terraform en reçoit un, et c’est lui qui place les composants d’une frontière dans une seule configuration Terraform ;- les fichiers du module copiés octet pour octet (
variables.tf,main.tf, y compris toute interpolation${...}écrite par l’auteur du module) ; aggrega.provenance.tfà côté de ces fichiers — un fichier de commentaires#identifiant le build.
Le bloc db qu’émet cet exemple :
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"}Deux de ces arguments méritent d’être suivis jusqu’à l’endroit où ils ont été écrits. subnet_id est le nom du groupe de sous-réseaux de base de données que la Release fournit sous infra.overrides — le groupe est exploité en dehors de cette Release, son nom diffère selon l’environnement, et la déclaration propre du module ne porte aucune valeur par défaut, si bien que la Recipe l’exige et que le build s’arrête de façon visible lorsqu’il manque, plutôt que de planifier contre le mauvais réseau. instance_class provient du même pilier mais porte une valeur par défaut dans la Recipe, si bien qu’une Release qui n’indique rien obtient db.t3.small.
Quoi qu’une Recipe mappe dans ces arguments, le compilateur le transmet sans y toucher et ne le résout jamais — un pointeur Terraform ${...} compris. Ce qui change avec la position, c’est l’endroit où ce pointeur aboutit : un argument de module est l’une des positions que Terraform évalue, si bien qu’un pointeur écrit là est résolu par rapport à la configuration racine au moment du plan au lieu d’atteindre le module comme chaîne littérale. Il doit tout de même nommer quelque chose que cette configuration déclare.
Comme les entrées sont indiquées dans la racine, modules/db/ seul n’est pas une configuration que vous pouvez planifier telle que déployée — voir la page du fournisseur Terraform pour ce que fait le moteur si vous essayez.
Fichiers
aggregate.yaml— intention du développeur : un composantdbde typecore/datastore/mariadb.release.yaml— dimensionnement par l’opérateur pour la frontièreinfra. Son entrée pourdblie l’emplacementroot_passwordrequis du Component aveccore/generated-secret(voir plus bas), et rattachecore/backuppour conserver chacune des sauvegardes automatiques de l’instance pendant 14 jours — lebackup_retention_periodci-dessus ; sans rattachement, l’instance les conserve 7 jours.manifest.yaml— lie le type de composant MariaDB à la Recipe Terraformterraform/mariadb-rds-module, qui tire son module d’une source locale, le type de Feature d’identifiants àterraform/generated-secret, et le type de Feature de sauvegarde àterraform/backup-native, qui ne rend rien : la Recipe lit le rattachement et fournit elle-même les entrées de sauvegarde du module..aggrega-config.yaml— nomme le registre du hub depuis lequel se résolvent les entités du catalogue.
L’emplacement d’identifiants sur une cible gérée
core/datastore/mariadb déclare root_password comme emplacement requis : un build s’arrête tant que rien ne le lie. RDS génère et fait tourner lui-même le mot de passe principal, et le module embarqué que copie cette Recipe définit manage_master_user_password pour activer cela — si bien que l’emplacement est délégué au moteur au lieu d’être rempli avec une valeur écrite par l’auteur.
Le fait que le moteur possède les identifiants découle de la Recipe que choisit le Manifest, si bien que c’est l’opérateur qui lie l’emplacement, dans la Release, sur son entrée pour db. Il le lie avec core/generated-secret, qui ne configure rien parce qu’il n’y a rien à écrire, et dont la FeatureRecipe (terraform/generated-secret) est un pur câblage qui ne rend rien. Le module embarqué et la configuration racine sortent octet pour octet tels qu’ils seraient sans aucun rattachement. La référence du Manifest est qualifiée par le fournisseur, car un nom de recette non qualifié n’est résolu que lorsqu’exactement un fournisseur le porte, et la bibliothèque standard livre une FeatureRecipe generated-secret sous plus d’un — si bien qu’un nom non qualifié n’est pas résolu du tout, et le build s’arrête de façon visible plutôt que de choisir silencieusement un fournisseur à votre place.
Générer l’exemple
Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example terraform-rds-moduleElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd terraform-rds-moduleBuild
aggrega build --release release.yaml --auto-pull--auto-pull écrit pendant le build le fichier de verrouillage qui manque à un clone récent.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `terraform-rds-module`, appelez une fois l’outil `scaffold` avec `example` défini sur `terraform-rds-module` et sans `dir` : il écrit l’exemple dans un nouveau dossier `terraform-rds-module`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `terraform-rds-module`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `terraform-rds-module/dist/`.