Terraform RDS (módulo incorporado)
A mesma intenção de MariaDB do exemplo terraform-rds, renderizada através da forma sourced do fornecedor Terraform: em vez de um corpo HCL inline, a Recipe aponta para um módulo Terraform local e o compilador copia-o tal como está, e depois fornece as suas variáveis de entrada a partir dos pilares do programador e do operador.
O que o compilador emite
Em dist/infra/terraform/ a compilação produz a configuração raiz da fronteira, e em dist/infra/terraform/modules/db/ os ficheiros 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. Cada fronteira terraform recebe um, e é ele que coloca os componentes de uma fronteira numa única configuração do Terraform;- os ficheiros 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 ficheiros — um ficheiro de comentários#que identifica a compilação.
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 base 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 tem nenhum valor predefinido, pelo que a Recipe o exige e a compilação é interrompida de forma visível quando falta, em vez de planear contra a rede errada. instance_class provém do mesmo pilar, mas tem um valor predefinido na Recipe, pelo que uma Release que não indica nada obtém db.t3.small.
O que quer que uma Recipe mapeie para estes argumentos, o compilador encaminha-o intacto e nunca o 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, pelo que um ponteiro escrito aí é resolvido em relação à configuração raiz no momento do plano, em vez de chegar ao módulo como cadeia literal. Continua a ter de nomear algo que essa configuração declara.
Como as entradas são indicadas na raiz, modules/db/ por si só não é uma configuração que se possa planear tal como implementada — consulte a página do fornecedor Terraform para ver o que o motor faz se tentar.
Ficheiros
aggregate.yaml— intenção do programador: um componentedbdo tipocore/datastore/mariadb.release.yaml— dimensionamento do operador para a fronteirainfra. A sua entrada paradbassocia a ranhuraroot_passwordobrigatória do Component acore/generated-secret(ver abaixo), e anexacore/backuppara conservar cada uma das cópias de segurança automáticas da instância durante 14 dias — obackup_retention_periodacima; sem anexo, a instância conserva-as durante 7.manifest.yaml— associa o tipo de componente MariaDB à Recipe do Terraformterraform/mariadb-rds-module, que obtém o seu módulo de uma origem local, o tipo de Feature de credencial aterraform/generated-secret, e o tipo de Feature de cópia de segurança aterraform/backup-native, que não renderiza nada: a Recipe lê o anexo e fornece ela própria as entradas de cópia de segurança do módulo..aggrega-config.yaml— nomeia o registo do hub a partir do qual as entidades do catálogo são resolvidas.
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. O RDS gera e roda ele próprio a palavra-passe mestra, e o módulo incorporado que esta Recipe copia define manage_master_user_password para ativar isso — pelo que a ranhura é delegada ao motor em vez de ser preenchida com um valor escrito pelo autor.
Se o motor é dono da credencial decorre da Recipe que o Manifest escolhe, pelo que é o operador quem associa a ranhura, na Release, na sua entrada para db. Associa-a a core/generated-secret, que não configura nada porque não há nada a escrever, e cuja FeatureRecipe (terraform/generated-secret) é pura ligação que não renderiza nada. O módulo incorporado e a configuração raiz saem byte a byte tal como seriam sem qualquer anexo. A referência do Manifest é qualificada pelo fornecedor porque 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 nome 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.
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:
aggrega scaffold --example terraform-rds-moduleDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd terraform-rds-moduleCompilação
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.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.
Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta da área 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`: esta escreve o exemplo numa 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. Indique-me que ficheiros a compilação escreveu; encontram-se em `terraform-rds-module/dist/`.