Terraform RDS (artefato HCL inline)
Um único banco de dados MariaDB escrito uma única vez como intenção do desenvolvedor e renderizado em um arquivo HCL do Terraform que provisiona uma instância gerenciada do AWS RDS.
Este exemplo demonstra a forma artifact do provedor Terraform: a Recipe traz um corpo main.tf inline em artifacts:, e o compilador emite esse corpo tal como está depois de resolver as suas expressões de template. O provedor nunca executa terraform; ele produz o HCL que um terraform apply posterior executa.
Arquivos
aggregate.yaml— intenção do desenvolvedor: um componentedbdo tipocore/datastore/mariadb, com um nome lógico de banco de dados. Nada sobre o destino na nuvem fica aqui.release.yaml— dimensionamento do operador: versão do mecanismo, armazenamento e HA para a fronteirainfra. A sua entrada paradbassocia o slotroot_passwordobrigatório do Component acore/generated-secret— a Feature de credencial que diz que o mecanismo é dono da credencial (veja abaixo) — e vinculacore/backup, que define por quanto tempo a instância mantém os seus backups.manifest.yaml— associa o tipo de componente MariaDB à Recipe do Terraformterraform/mariadb-rds, o tipo de Feature de credencial aterraform/generated-secret, e o tipo de Feature de backup aterraform/backup-native..aggrega-config.yaml— nomeia o registro do hub a partir do qual as entidades do catálogo são resolvidas.
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-rdsEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd terraform-rdsBuild
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. O main.tf renderizado fica em dist/infra/terraform/modules/db/, com a configuração raiz da fronteira, aggrega.modules.tf, em dist/infra/terraform/, declarando db como um bloco module que aponta para ele. O corpo começa com um bloco de proveniência de comentários # que identifica o build, seguido de um bloco required_providers que restringe a versão do provedor AWS, do recurso aws_db_instance resolvido — com os valores de armazenamento e HA substituídos a partir da Release, a retenção de backups que a vinculação core/backup define e as credenciais gerenciadas pelo RDS via manage_master_user_password — e de uma saída address que traz o hostname da instância, que a Recipe publica como host na forma ${module.db.address}.
Esse bloco module não traz argumentos, e o motivo é a forma deste exemplo. A Recipe escreveu o corpo, então substituiu os valores da Release diretamente no recurso; o módulo não declara blocos variable e não sobra nada para o compilador passar:
module "db" { source = "./modules/db"}Uma Recipe que em vez disso incorpora um módulo — o exemplo terraform-rds-module — deixa essas entradas sem declaração no corpo, então o compilador as fornece como argumentos deste bloco.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do workspace ainda não contiver uma pasta `terraform-rds`, chame a ferramenta `scaffold` uma vez com `example` definido como `terraform-rds` e sem `dir`: ela escreve o exemplo em uma nova pasta `terraform-rds`. Depois chame a ferramenta `build` com `workspace_root` definido como `terraform-rds`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build escreveu; eles ficam em `terraform-rds/dist/`.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. Um MariaDB auto-hospedado precisa de uma senha associada no momento da escrita; uma instância RDS gerenciada não — o RDS gera e rotaciona ele mesmo a senha mestre, e manage_master_user_password nesta Recipe é o que ativa isso.
Por isso o operador associa o slot na Release, na sua entrada para db, a core/generated-secret, a Feature de credencial cujo material pertence ao mecanismo. Se o mecanismo é dono da credencial decorre da Recipe que o Manifest escolhe, então a associação cabe ao operador, e o Aggregate não diz nada sobre ela:
components: db: features: root_password: type: core/generated-secretA vinculação não configura nada porque não há nada a escrever, e a FeatureRecipe que o Manifest seleciona (terraform/generated-secret) é pura fiação que não renderiza nada. Assim, o main.tf renderizado é byte a byte o que seria sem nenhuma vinculação: o slot está associado, e nenhum artefato é emitido para ele.
Observe que a referência à FeatureRecipe do Manifest é qualificada pelo provedor (terraform/generated-secret:1.0.0). 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 generated-secret:1.0.0 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ê.
Backup em um destino gerenciado
O RDS faz ele mesmo o backup da instância, mantendo cada backup automático por 7 dias quando nada diz o contrário. O operador muda isso vinculando core/backup na Release, ao lado da credencial:
backup: type: core/backup infra: retention_days: 14O Manifest associa a Feature a terraform/backup-native, que não renderiza nada próprio: o backup é uma configuração da instância, então a Recipe lê a vinculação e a grava no recurso que já renderiza. A seção de backup de aws_db_instance em main.tf:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14Um infra.schedule como 30 2 * * * também definiria o backup_window da instância como 02:30-03:00, lido em UTC; se omitido, como aqui, o RDS escolhe a janela. Um valor que o RDS não consegue manter — uma retenção acima de 35 dias, um agendamento diferente de um horário de todos os dias — interrompe o build nomeando a vinculação.