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

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.tf en la raíz del límite — la configuración raíz, que declara db como un bloque module cuyo source es ./modules/db y 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.tf junto 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 componente db de tipo core/datastore/mariadb.
  • release.yaml — dimensionamiento del operador para el límite infra. Su entrada para db enlaza la ranura root_password obligatoria del Component con core/generated-secret (ver más abajo), y vincula core/backup para conservar cada una de las copias de seguridad automáticas de la instancia durante 14 días — el backup_retention_period de arriba; sin vinculación, la instancia las conserva durante 7.
  • manifest.yaml — enlaza el tipo de componente MariaDB con la Recipe de Terraform terraform/mariadb-rds-module, que obtiene su módulo de una fuente local, el tipo de Feature de credenciales con terraform/generated-secret, y el tipo de Feature de copia de seguridad con terraform/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:

Terminal window
aggrega scaffold --example terraform-rds-module

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

Terminal window
cd terraform-rds-module

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 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/`.