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 (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.tf na raiz da fronteira — a configuração raiz, que declara db como um bloco module cujo source é ./modules/db e 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.tf ao 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 componente db do tipo core/datastore/mariadb.
  • release.yaml — dimensionamento do operador para a fronteira infra. A sua entrada para db associa a ranhura root_password obrigatória do Component a core/generated-secret (ver abaixo), e anexa core/backup para conservar cada uma das cópias de segurança automáticas da instância durante 14 dias — o backup_retention_period acima; sem anexo, a instância conserva-as durante 7.
  • manifest.yaml — associa o tipo de componente MariaDB à Recipe do Terraform terraform/mariadb-rds-module, que obtém o seu módulo de uma origem local, 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, 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:

Terminal window
aggrega scaffold --example terraform-rds-module

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

Terminal window
cd terraform-rds-module

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.

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/`.