Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Terraform RDS (artefacto HCL en línea)

Una única base de datos MariaDB escrita una sola vez como intención del desarrollador y renderizada a un archivo HCL de Terraform que aprovisiona una instancia gestionada de AWS RDS.

Este ejemplo muestra la forma artifact del proveedor Terraform: la Recipe lleva un cuerpo main.tf en línea bajo artifacts:, y el compilador emite ese cuerpo tal cual después de resolver sus expresiones de plantilla. El proveedor nunca ejecuta terraform; produce el HCL que ejecuta un terraform apply posterior.

Archivos

  • aggregate.yaml — intención del desarrollador: un componente db de tipo core/datastore/mariadb, con un nombre lógico de base de datos. Aquí no hay nada sobre el destino en la nube.
  • release.yaml — dimensionamiento del operador: versión del motor, almacenamiento y HA para el límite infra. Su entrada para db enlaza la ranura root_password obligatoria del Component con core/generated-secret — la Feature de credenciales que indica que el motor es dueño de la credencial (ver más abajo) — y vincula core/backup, que establece cuánto tiempo conserva la instancia sus copias de seguridad.
  • manifest.yaml — enlaza el tipo de componente MariaDB con la Recipe de Terraform terraform/mariadb-rds, el tipo de Feature de credenciales con terraform/generated-secret, y el tipo de Feature de copia de seguridad con terraform/backup-native.
  • .aggrega-config.yaml — nombra el registro del hub desde el que se resuelven las entidades del catálogo.

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:

Terminal window
aggrega scaffold --example terraform-rds

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd terraform-rds

Compilación

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

--auto-pull escribe durante la compilación el archivo de bloqueo que le falta a un clon recién creado. El main.tf renderizado queda bajo dist/infra/terraform/modules/db/, con la configuración raíz del límite, aggrega.modules.tf, en dist/infra/terraform/, que declara db como un bloque module que apunta a él. El cuerpo se abre con un bloque de procedencia de comentarios # que identifica la compilación, seguido de un bloque required_providers que restringe la versión del proveedor de AWS, el recurso aws_db_instance resuelto — con los valores de almacenamiento y HA sustituidos desde la Release, la retención de copias de seguridad que establece la vinculación core/backup y las credenciales gestionadas por RDS mediante manage_master_user_password — y una salida address que lleva el nombre de host de la instancia, que la Recipe publica como host en la forma ${module.db.address}.

Ese bloque module no lleva argumentos, y la razón es la forma de este ejemplo. La Recipe escribió el cuerpo, así que sustituyó los valores de la Release directamente en el recurso; el módulo no declara bloques variable y no le queda nada que pasar al compilador:

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

Una Recipe que en cambio incorpora un módulo — el ejemplo terraform-rds-module — deja esas entradas sin declarar en el cuerpo, así que el compilador las proporciona como argumentos de este bloque.

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`, llama una vez a la herramienta `scaffold` con `example` establecido en `terraform-rds` y sin `dir`: escribe el ejemplo en una nueva carpeta `terraform-rds`. Luego llama a la herramienta `build` con `workspace_root` establecido en `terraform-rds`, `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/dist/`.

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. Un MariaDB autoalojado necesita una contraseña enlazada en el momento de la escritura; una instancia RDS gestionada no — RDS genera y rota él mismo la contraseña maestra, y manage_master_user_password en esta Recipe es lo que lo activa.

Por eso el operador enlaza la ranura en la Release, en su entrada para db, con core/generated-secret, la Feature de credenciales cuyo material es del motor. Que el motor sea dueño de la credencial se deriva de la Recipe que elige el Manifest, así que el enlace corresponde al operador, y el Aggregate no dice nada al respecto:

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

La vinculación no configura nada porque no hay nada que escribir, y la FeatureRecipe que selecciona el Manifest (terraform/generated-secret) es puro cableado que no renderiza nada. Así que el main.tf renderizado es byte a byte lo que sería sin ninguna vinculación: la ranura está enlazada y no se emite ningún artefacto para ella.

Ten en cuenta que la referencia a la FeatureRecipe del Manifest está calificada por proveedor (terraform/generated-secret:1.0.0). 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 generated-secret:1.0.0 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.

Copia de seguridad en un destino gestionado

RDS hace él mismo la copia de seguridad de la instancia y conserva cada copia de seguridad automática durante 7 días cuando nada indica lo contrario. El operador lo cambia vinculando core/backup en la Release, junto a la credencial:

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

El Manifest enlaza la Feature con terraform/backup-native, que no renderiza nada propio: la copia de seguridad es un ajuste de la instancia, así que la Recipe lee la vinculación y la escribe en el recurso que ya renderiza. La sección de copia de seguridad de aws_db_instance en main.tf:

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

Un infra.schedule como 30 2 * * * establecería también el backup_window de la instancia en 02:30-03:00, leído en UTC; si se omite, como aquí, RDS elige la ventana. Un valor que RDS no puede respetar — una retención superior a 35 días, una programación distinta de una hora de cada día — detiene la compilación nombrando la vinculación.