Terraform RDS (módulo incorporado)
La misma intención de MariaDB que el ejemplo terraform-rds, renderizada mediante la forma sourced del proveedor Terraform: en lugar de un cuerpo HCL en línea, la Recipe apunta a un módulo de Terraform local y el compilador lo copia tal cual, y después proporciona sus variables de entrada a partir de los pilares del desarrollador y del operador.
Qué emite el compilador
Bajo dist/infra/terraform/ la compilación produce la configuración raíz del límite, y bajo dist/infra/terraform/modules/db/ los archivos propios del componente db:
aggrega.modules.tfen la raíz del límite — la configuración raíz, que declaradbcomo un bloquemodulecuyosourcees./modules/dby cuyos argumentos son las variables de entrada del módulo, en un orden de claves determinista. Cada límite terraform recibe uno, y es lo que coloca los componentes de un límite en una única configuración de Terraform;- los archivos del módulo copiados byte a byte (
variables.tf,main.tf, incluida cualquier interpolación${...}que haya escrito el autor del módulo); aggrega.provenance.tfjunto a esos archivos — un archivo de comentarios#que identifica la compilación.
El bloque db que emite este ejemplo:
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"}Dos de esos argumentos merecen seguirse hasta donde se escribieron. subnet_id es el nombre del grupo de subredes de base de datos que la Release proporciona bajo infra.overrides — el grupo se opera fuera de esta Release, su nombre difiere según el entorno y la declaración propia del módulo no lleva ningún valor predeterminado, así que la Recipe lo exige y la compilación se detiene de forma visible cuando falta, en lugar de planificar contra la red equivocada. instance_class proviene del mismo pilar pero lleva un valor predeterminado en la Recipe, así que una Release que no indica nada obtiene db.t3.small.
Lo que una Recipe asigne a estos argumentos, el compilador lo canaliza sin tocarlo y nunca lo resuelve — incluido un puntero ${...} de Terraform. Lo que cambia con la posición es dónde aterriza ese puntero: un argumento de módulo es una de las posiciones que Terraform evalúa, así que un puntero escrito ahí se resuelve contra la configuración raíz en el momento del plan en lugar de llegar al módulo como cadena literal. Aun así, tiene que nombrar algo que esa configuración declare.
Como las entradas se indican en la raíz, modules/db/ por sí solo no es una configuración que puedas planificar tal como se despliega — consulta la página del proveedor Terraform para ver qué hace el motor si lo intentas.
Archivos
aggregate.yaml— intención del desarrollador: un componentedbde tipocore/datastore/mariadb.release.yaml— dimensionamiento del operador para el límiteinfra. Su entrada paradbenlaza la ranuraroot_passwordobligatoria del Component concore/generated-secret(ver más abajo), y vinculacore/backuppara conservar cada una de las copias de seguridad automáticas de la instancia durante 14 días — elbackup_retention_periodde arriba; sin vinculación, la instancia las conserva durante 7.manifest.yaml— enlaza el tipo de componente MariaDB con la Recipe de Terraformterraform/mariadb-rds-module, que obtiene su módulo de una fuente local, el tipo de Feature de credenciales conterraform/generated-secret, y el tipo de Feature de copia de seguridad conterraform/backup-native, que no renderiza nada: la Recipe lee la vinculación y proporciona ella misma las entradas de copia de seguridad del módulo..aggrega-config.yaml— nombra el registro del hub desde el que se resuelven las entidades del catálogo.
La ranura de credenciales en un destino gestionado
core/datastore/mariadb declara root_password como ranura obligatoria: una compilación se detiene mientras nada la enlace. RDS genera y rota él mismo la contraseña maestra, y el módulo incorporado que copia esta Recipe establece manage_master_user_password para activarlo — así que la ranura se delega al motor en lugar de rellenarse con un valor escrito por el autor.
Que el motor sea dueño de la credencial se deriva de la Recipe que elige el Manifest, así que es el operador quien enlaza la ranura, en la Release, en su entrada para db. La enlaza con core/generated-secret, que no configura nada porque no hay nada que escribir, y cuya FeatureRecipe (terraform/generated-secret) es puro cableado que no renderiza nada. El módulo incorporado y la configuración raíz salen byte a byte como serían sin ninguna vinculación. La referencia del Manifest está calificada por proveedor porque un nombre de receta sin calificar solo se resuelve cuando exactamente un proveedor lo lleva, y la biblioteca estándar incluye una FeatureRecipe generated-secret bajo más de uno — así que un nombre sin calificar no se resuelve en absoluto, y la compilación se detiene de forma visible en lugar de elegir silenciosamente un proveedor por ti.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example terraform-rds-moduleDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd terraform-rds-moduleCompilación
aggrega build --release release.yaml --auto-pull--auto-pull escribe durante la compilación el archivo de bloqueo que le falta a un clon nuevo.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `terraform-rds-module`, llama una vez a la herramienta `scaffold` con `example` establecido en `terraform-rds-module` y sin `dir`: escribe el ejemplo en una nueva carpeta `terraform-rds-module`. Luego llama a la herramienta `build` con `workspace_root` establecido en `terraform-rds-module`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `terraform-rds-module/dist/`.