Terraform RDS (módulo incorporado)
A mesma intenção de MariaDB do exemplo terraform-rds, renderizada pela forma sourced do provedor Terraform: em vez de um corpo HCL inline, a Recipe aponta para um módulo Terraform local e o compilador o copia tal como está, e depois fornece as suas variáveis de entrada a partir dos pilares do desenvolvedor e do operador.
O que o compilador emite
Em dist/infra/terraform/ o build produz a configuração raiz da fronteira, e em dist/infra/terraform/modules/db/ os arquivos próprios do componente db:
aggrega.modules.tfna raiz da fronteira — a configuração raiz, que declaradbcomo um blocomodulecujosourceé./modules/dbe cujos argumentos são as variáveis de entrada do módulo, em ordem determinística de chaves. Toda fronteira terraform recebe um, e é ele que coloca os componentes de uma fronteira em uma única configuração do Terraform;- os arquivos do módulo copiados byte a byte (
variables.tf,main.tf, incluindo qualquer interpolação${...}que o autor do módulo tenha escrito); aggrega.provenance.tfao lado desses arquivos — um arquivo de comentários#que identifica o build.
O bloco db que este exemplo emite:
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"}Dois desses argumentos merecem ser seguidos até onde foram escritos. subnet_id é o nome do grupo de sub-redes de banco de dados que a Release fornece em infra.overrides — o grupo é operado fora desta Release, o seu nome difere por ambiente e a declaração própria do módulo não traz nenhum valor padrão, então a Recipe o exige e o build é interrompido de forma visível quando ele falta, em vez de planejar contra a rede errada. instance_class vem do mesmo pilar, mas traz um valor padrão na Recipe, então uma Release que não informa nada recebe db.t3.small.
O que quer que uma Recipe mapeie para esses argumentos, o compilador repassa intacto e nunca resolve — incluindo um ponteiro ${...} do Terraform. O que muda com a posição é onde esse ponteiro chega: um argumento de módulo é uma das posições que o Terraform avalia, então um ponteiro escrito ali é resolvido em relação à configuração raiz no momento do plano, em vez de chegar ao módulo como string literal. Ele ainda precisa nomear algo que essa configuração declara.
Como as entradas são informadas na raiz, modules/db/ sozinho não é uma configuração que você possa planejar como implantada — veja a página do provedor Terraform para saber o que o mecanismo faz se você tentar.
Arquivos
aggregate.yaml— intenção do desenvolvedor: um componentedbdo tipocore/datastore/mariadb.release.yaml— dimensionamento do operador para a fronteirainfra. A sua entrada paradbassocia o slotroot_passwordobrigatório do Component acore/generated-secret(veja abaixo), e vinculacore/backuppara manter cada um dos backups automáticos da instância por 14 dias — obackup_retention_periodacima; sem vinculação, a instância os mantém por 7.manifest.yaml— associa o tipo de componente MariaDB à Recipe do Terraformterraform/mariadb-rds-module, que obtém o seu módulo de uma fonte local, o tipo de Feature de credencial aterraform/generated-secret, e o tipo de Feature de backup aterraform/backup-native, que não renderiza nada: a Recipe lê a vinculação e fornece ela mesma as entradas de backup do módulo..aggrega-config.yaml— nomeia o registro do hub a partir do qual as entidades do catálogo são resolvidas.
O slot de credencial em um destino gerenciado
core/datastore/mariadb declara root_password como slot obrigatório: um build é interrompido enquanto nada o associa. O RDS gera e rotaciona ele mesmo a senha mestre, e o módulo incorporado que esta Recipe copia define manage_master_user_password para ativar isso — então o slot é delegado ao mecanismo em vez de ser preenchido com um valor escrito pelo autor.
Se o mecanismo é dono da credencial decorre da Recipe que o Manifest escolhe, então é o operador quem associa o slot, na Release, na sua entrada para db. Ele o associa a core/generated-secret, que não configura nada porque não há nada a escrever, e cuja FeatureRecipe (terraform/generated-secret) é pura fiação que não renderiza nada. O módulo incorporado e a configuração raiz saem byte a byte como seriam sem nenhuma vinculação. A referência do Manifest é qualificada pelo provedor porque um nome de receita não qualificado só é resolvido quando exatamente um provedor o traz, e a biblioteca padrão inclui uma FeatureRecipe generated-secret em mais de um — então um nome não qualificado não é resolvido de forma alguma, e o build é interrompido de forma visível em vez de escolher silenciosamente um provedor por você.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example terraform-rds-moduleEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd terraform-rds-moduleBuild
aggrega build --release release.yaml --auto-pull--auto-pull grava durante o build o arquivo de bloqueio que falta a um clone recém-criado.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do espaço de trabalho ainda não contiver uma pasta `terraform-rds-module`, chame uma vez a ferramenta `scaffold` com `example` definido como `terraform-rds-module` e sem `dir`: ela grava o exemplo em uma nova pasta `terraform-rds-module`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `terraform-rds-module`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `terraform-rds-module/dist/`.