Terraform para diagrama

Como funciona

1. 01

   Cole ou solte seu Terraform

   Um arquivo .tf, vários arquivos do mesmo módulo ou o JSON que terraform show -json imprime para um plano salvo ou para o seu state. Não é preciso rodar terraform init.

2. 02

   Veja a arquitetura

   Cada recurso vira um cartão do seu tipo, como computação, banco de dados ou fila. Redes, sub-redes e grupos de recursos viram molduras em volta dos recursos que ficam dentro deles.

3. 03

   Abra no Archboard

   Salve como um novo diagrama para reorganizar os cartões, adicionar notas, compartilhar um link ou exportar em SVG e PNG. Para se cadastrar basta uma conta Google ou GitHub.

O que é desenhado a partir do código Terraform

O diagrama é montado a partir destes blocos e argumentos da sua configuração:

• resourcedata

  Os recursos, como cartões do seu tipo. Recursos de ligação como aws_lb_target_group_attachment viram conexões, recursos de configuração como aws_s3_bucket_versioning ficam recolhidos no bucket, e data sources são ignorados, a menos que haja recursos dentro deles.

• depends_on

  Uma conexão para cada referência de um recurso a outro, como aws_iam_role.app.arn, inclusive dentro de strings, heredocs e locals. depends_on adiciona uma conexão tracejada, a menos que uma referência já ligue os dois recursos ou que o destino seja um auxiliar oculto como time_sleep.

• vpc_idsubnet_id

  O posicionamento por vpc_id e subnet_id: um recurso em uma única sub-rede fica dentro dela, um recurso espalhado por várias sub-redes de uma VPC fica na moldura da VPC, e os recursos do Azure ficam no seu grupo de recursos.

• modulesource

  Cada bloco module como um cartão. Módulos conhecidos do registry, como terraform-aws-modules/vpc/aws, eks e rds, viram a moldura de rede, o cluster ou o banco de dados que criam, e os recursos que usam as sub-redes do módulo de VPC ficam dentro dessa moldura.

• resource_changes

  Com o plano em JSON, cada cartão de recurso mostra o que o plano vai fazer com ele: + criar, ~ atualizar, − excluir ou ± substituir. Recursos que o plano não altera ficam sem marca, assim como molduras como VPCs e sub-redes e configurações recolhidas em um cartão.

• awsazurermgoogle

  Recursos da AWS, do Azure e do Google Cloud, juntos em um diagrama quando você usa vários provedores. Tipos sem um cartão próprio aparecem como cartões genéricos que mostram o tipo do recurso.

Visualizador de plano do Terraform

O plano em JSON gera o diagrama mais completo: count e for_each viram números reais de instâncias, os módulos mostram seus recursos e os cartões de recursos ficam marcados com a mudança planejada. Rode estes dois comandos onde você costuma rodar terraform plan e depois cole o JSON:

1. Cria um plano e o salva em plan.out sem aplicar nada.

   terraform plan -out plan.out

2. Imprime o plano salvo como JSON. Cole a saída ou redirecione-a para plan.json e solte esse arquivo aqui.

   terraform show -json plan.out

O que um diagrama do Terraform deixa de fora

• Valores de variáveis e locals, arquivos .tfvars, tags, user_data e outros valores de atributos. Os cartões usam nomes literais como bucket ou function_name ou, na falta deles, o nome do recurso no seu código.
• A expansão de count e for_each nos arquivos .tf: a configuração não é avaliada, então um recurso com count = 3 é um único cartão marcado ×3, e um com for_each é marcado ×N. Cole o plano em JSON para ver os números reais de instâncias.
• O conteúdo de módulos remotos: módulos do registry e do Git não são baixados. Um módulo que não está entre os conhecidos fica como um único cartão, e o plano em JSON mostra os recursos dentro dele.
• O estado real da nuvem, drift, custos ou quais serviços chamam uns aos outros em tempo de execução. O diagrama mostra como a sua configuração liga os recursos, não o tráfego.