Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

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 componente db do tipo core/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 fronteira infra. A sua entrada para db associa o slot root_password obrigatório do Component a core/generated-secret — a Feature de credencial que diz que o mecanismo é dono da credencial (veja abaixo) — e vincula core/backup, que define por quanto tempo a instância mantém os seus backups.
  • manifest.yaml — associa o tipo de componente MariaDB à Recipe do Terraform terraform/mariadb-rds, o tipo de Feature de credencial a terraform/generated-secret, e o tipo de Feature de backup a terraform/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:

Terminal window
aggrega scaffold --example terraform-rds

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd terraform-rds

Build

Terminal window
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-secret

A 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: 14

O 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 = 14

Um 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.