Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Terraform RDS (artefact HCL inline)

Une base de données MariaDB unique écrite une seule fois comme intention du développeur et rendue en un fichier HCL Terraform qui provisionne une instance AWS RDS gérée.

Cet exemple illustre la forme artifact du fournisseur Terraform : la Recipe porte un corps main.tf inline sous artifacts:, et le compilateur émet ce corps tel quel après avoir résolu ses expressions de template. Le fournisseur n’exécute jamais terraform ; il produit le HCL qu’un terraform apply en aval exécute.

Fichiers

  • aggregate.yaml — intention du développeur : un composant db de type core/datastore/mariadb, avec un nom logique de base de données. Rien de la cible cloud ne se trouve ici.
  • release.yaml — dimensionnement par l’opérateur : version du moteur, stockage et HA pour la frontière infra. Son entrée pour db lie l’emplacement root_password requis du Component avec core/generated-secret — la Feature d’identifiants qui indique que le moteur possède les identifiants (voir plus bas) — et rattache core/backup, qui fixe la durée pendant laquelle l’instance conserve ses sauvegardes.
  • manifest.yaml — lie le type de composant MariaDB à la Recipe Terraform terraform/mariadb-rds, le type de Feature d’identifiants à terraform/generated-secret, et le type de Feature de sauvegarde à terraform/backup-native.
  • .aggrega-config.yaml — nomme le registre du hub depuis lequel se résolvent les entités du catalogue.

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 :

Terminal window
aggrega scaffold --example terraform-rds

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd terraform-rds

Build

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

--auto-pull écrit pendant le build le fichier de verrouillage qui manque à un clone récent. Le main.tf rendu arrive sous dist/infra/terraform/modules/db/, avec la configuration racine de la frontière, aggrega.modules.tf, sous dist/infra/terraform/, qui déclare db comme un bloc module pointant vers lui. Le corps s’ouvre sur un bloc de provenance en commentaires # identifiant le build, suivi d’un bloc required_providers contraignant la version du fournisseur AWS, de la ressource aws_db_instance résolue — valeurs de stockage et de HA substituées depuis la Release, rétention des sauvegardes fixée par le rattachement core/backup, et identifiants gérés par RDS via manage_master_user_password — et d’une sortie address portant le nom d’hôte de l’instance, que la Recipe publie comme host sous la forme ${module.db.address}.

Ce bloc module ne porte aucun argument, et la raison en est la forme de cet exemple. La Recipe a écrit le corps, si bien qu’elle a substitué les valeurs de la Release directement dans la ressource ; le module ne déclare aucun bloc variable et il ne reste rien à transmettre pour le compilateur :

module "db" {
source = "./modules/db"
}

Une Recipe qui embarque plutôt un module — l’exemple terraform-rds-module — laisse ces entrées non déclarées dans le corps, si bien que le compilateur les fournit comme arguments de ce bloc.

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 d’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`, appelez une fois l’outil `scaffold` avec `example` défini sur `terraform-rds` et sans `dir` : il écrit l’exemple dans un nouveau dossier `terraform-rds`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `terraform-rds`, `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/dist/`.

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. Un MariaDB auto-hébergé a besoin d’un mot de passe lié au moment de l’écriture ; une instance RDS gérée non — RDS génère et fait tourner lui-même le mot de passe principal, et manage_master_user_password dans cette Recipe est ce qui active cela.

L’opérateur lie donc l’emplacement dans la Release, sur son entrée pour db, avec core/generated-secret, la Feature d’identifiants dont le moteur possède le matériel. Le fait que le moteur possède les identifiants découle de la Recipe que choisit le Manifest, si bien que la liaison revient à l’opérateur, et l’Aggregate n’en dit rien :

components:
db:
features:
root_password:
type: core/generated-secret

Le rattachement ne configure rien parce qu’il n’y a rien à écrire, et la FeatureRecipe que sélectionne le Manifest (terraform/generated-secret) est un pur câblage qui ne rend rien. Le main.tf rendu est donc octet pour octet ce qu’il serait sans aucun rattachement : l’emplacement est lié, et aucun artefact n’est émis pour lui.

Notez que la référence de FeatureRecipe du Manifest est qualifiée par le fournisseur (terraform/generated-secret:1.0.0). 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 generated-secret:1.0.0 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.

Sauvegarde sur une cible gérée

RDS sauvegarde lui-même l’instance, en conservant chaque sauvegarde automatique pendant 7 jours lorsque rien n’indique le contraire. L’opérateur change cela en rattachant core/backup dans la Release, à côté des identifiants :

backup:
type: core/backup
infra:
retention_days: 14

Le Manifest lie la Feature à terraform/backup-native, qui ne rend rien par lui-même : la sauvegarde est un paramètre de l’instance, si bien que la Recipe lit le rattachement et l’écrit dans la ressource qu’elle rend déjà. La section de sauvegarde de aws_db_instance dans main.tf :

## ── Backup ───────────────────────────────────────────────
backup_retention_period = 14

Un infra.schedule tel que 30 2 * * * fixerait aussi le backup_window de l’instance à 02:30-03:00, lu en UTC ; s’il est omis, comme ici, RDS choisit la fenêtre. Une valeur que RDS ne peut pas respecter — une rétention supérieure à 35 jours, une planification autre qu’une heure de chaque jour — arrête le build en nommant le rattachement.