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

Terraform RDS (artefacto HCL inline)

Uma única base de dados MariaDB escrita uma única vez como intenção do programador e renderizada num ficheiro HCL do Terraform que aprovisiona uma instância gerida do AWS RDS.

Este exemplo demonstra a forma artifact do fornecedor Terraform: a Recipe contém 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 fornecedor nunca executa terraform; produz o HCL que um terraform apply a jusante executa.

Ficheiros

  • aggregate.yaml — intenção do programador: um componente db do tipo core/datastore/mariadb, com um nome lógico de base de dados. Nada sobre o destino na cloud está aqui.
  • release.yaml — dimensionamento do operador: versão do motor, armazenamento e HA para a fronteira infra. A sua entrada para db associa a ranhura root_password obrigatória do Component a core/generated-secret — a Feature de credencial que diz que o motor é dono da credencial (ver abaixo) — e anexa core/backup, que define durante quanto tempo a instância conserva as suas cópias de segurança.
  • 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 cópia de segurança a terraform/backup-native.
  • .aggrega-config.yaml — nomeia o registo do hub a partir do qual as entidades do catálogo são resolvidas.

Gerar o exemplo

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example terraform-rds

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd terraform-rds

Compilação

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

--auto-pull escreve durante a compilação o ficheiro de bloqueio que falta a um clone acabado de criar. 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/, a declarar db como um bloco module que aponta para ele. O corpo começa com um bloco de proveniência de comentários # que identifica a compilação, seguido de um bloco required_providers que restringe a versão do fornecedor AWS, do recurso aws_db_instance resolvido — com os valores de armazenamento e HA substituídos a partir da Release, a retenção das cópias de segurança que o anexo core/backup define e as credenciais geridas pelo RDS através de manage_master_user_password — e de uma saída address que contém o nome de anfitrião da instância, que a Recipe publica como host na forma ${module.db.address}.

Esse bloco module não tem argumentos, e a razão é a forma deste exemplo. A Recipe escreveu o corpo, pelo que substituiu os valores da Release diretamente no recurso; o módulo não declara blocos variable e não resta 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 por declarar no corpo, pelo que 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-lhe este prompt.

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta do espaço de trabalho ainda não contiver uma pasta `terraform-rds`, chame uma vez a ferramenta `scaffold` com `example` definido como `terraform-rds` e sem `dir`: esta escreve o exemplo numa 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. Indique-me que ficheiros o build escreveu; encontram-se em `terraform-rds/dist/`.

A ranhura de credencial num destino gerido

core/datastore/mariadb declara root_password como ranhura obrigatória: uma compilação é interrompida enquanto nada a associar. Um MariaDB autoalojado precisa de uma palavra-passe associada no momento da escrita; uma instância RDS gerida não — o RDS gera e roda ele próprio a palavra-passe mestra, e manage_master_user_password nesta Recipe é o que ativa isso.

Por isso, o operador associa a ranhura na Release, na sua entrada para db, a core/generated-secret, a Feature de credencial cujo material pertence ao motor. Se o motor é dono da credencial decorre da Recipe que o Manifest escolhe, pelo que a associação cabe ao operador, e o Aggregate não diz nada sobre ela:

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

O anexo não configura nada porque não há nada a escrever, e a FeatureRecipe que o Manifest seleciona (terraform/generated-secret) é pura ligação que não renderiza nada. Assim, o main.tf renderizado é byte a byte o que seria sem qualquer anexo: a ranhura está associada, e nenhum artefacto é emitido para ela.

Note que a referência à FeatureRecipe do Manifest é qualificada pelo fornecedor (terraform/generated-secret:1.0.0). Um nome de receita não qualificado só é resolvido quando exatamente um fornecedor o tem, e a biblioteca standard inclui uma FeatureRecipe generated-secret em mais do que um — pelo que um generated-secret:1.0.0 não qualificado não é resolvido de todo, e a compilação é interrompida de forma visível em vez de escolher silenciosamente um fornecedor por si.

Cópia de segurança num destino gerido

O RDS faz ele próprio a cópia de segurança da instância, conservando cada cópia de segurança automática durante 7 dias quando nada diz o contrário. O operador altera isso anexando 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 de próprio: a cópia de segurança é uma definição da instância, pelo que a Recipe lê o anexo e escreve-o no recurso que já renderiza. A secção de cópia de segurança de aws_db_instance em main.tf:

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

Um infra.schedule como 30 2 * * * definiria também o backup_window da instância como 02:30-03:00, lido em UTC; se for omitido, como aqui, o RDS escolhe a janela. Um valor que o RDS não consegue cumprir — uma retenção acima de 35 dias, um agendamento diferente de uma hora de todos os dias — interrompe a compilação nomeando o anexo.