Infraestrutura como código: tutorial passo a passo com Terraform

16/11/2026  ·  Devskin

Infraestrutura como código: tutorial passo a passo com Terraform

Adotar infraestrutura como código significa descrever redes, instâncias, buckets e permissões em arquivos versionados, revisáveis e reproduzíveis, em vez de depender de cliques no console. Neste tutorial, mostro um fluxo enxuto com Terraform que um time de TI pode aplicar em poucos dias: estrutura de projeto, state remoto, módulos, validação no pipeline e controle de drift.

O objetivo não é cobrir todos os recursos de um provedor, e sim montar uma base sólida que você consiga expandir sem retrabalho.

Por que infraestrutura como código muda a operação

Com infraestrutura como código, qualquer alteração passa por pull request, revisão e histórico no Git. Isso traz auditoria, ambientes reproduzíveis (dev, staging e produção a partir da mesma definição) e menos dependência de conhecimento tácito de uma única pessoa.

Há ressalvas importantes: o Git permite voltar o código, mas não desfaz automaticamente a destruição de um banco de dados ou de um volume. Rollback de infraestrutura exige backups e planejamento, não apenas git revert.

Passo a passo para implementar infraestrutura como código

Passo 1: organize o repositório

Separe o que é reutilizável do que é específico de cada ambiente. Uma estrutura simples e comum:

infra/
 modules/
 network/
 app/
 envs/
 staging/
 main.tf
 production/
 main.tf

Cada pasta em envs/ tem seu próprio state, o que reduz o raio de impacto de um erro: um apply em staging nunca toca produção.

Passo 2: configure o state remoto

O state é o mapa entre o código e os recursos reais. Ele pode conter dados sensíveis em texto claro, então nunca o versione no Git. Use um backend remoto com criptografia, controle de acesso e bloqueio (lock) para evitar dois apply simultâneos. Exemplo com backend S3-compatível:

terraform {
 backend "s3" {
 bucket = "meu-time-tfstate"
 key = "staging/terraform.tfstate"
 region = "us-east-1"
 encrypt = true
 }
}

O mecanismo de lock depende do backend e da versão do Terraform ou OpenTofu que você usa; confirme na documentação oficial qual opção se aplica ao seu caso.

Passo 3: crie um módulo reutilizável

Módulos evitam copiar e colar blocos entre ambientes. Defina entradas claras (variable) e saídas explícitas (output):

variable "environment" {
 type = string
}

variable "instance_count" {
 type = number
 default = 1
}

output "app_endpoint" {
 value = module.app.endpoint
}

Mantenha módulos pequenos e com uma responsabilidade. Módulos que tentam resolver tudo viram abstrações difíceis de testar e de evoluir.

Passo 4: rode o plan no pipeline

O ganho real da infraestrutura como código aparece quando o pipeline valida cada mudança. Um fluxo mínimo para pull requests:

  • Formatação: terraform fmt -check
  • Validação: terraform init -backend=false seguido de terraform validate
  • Plano: terraform plan -out=tfplan, publicado como comentário no PR
  • Aprovação: revisão humana obrigatória para produção
  • Aplicação: terraform apply tfplan apenas após o merge, usando o plano revisado

Use credenciais de curta duração (por exemplo, federação OIDC entre o CI e o provedor) em vez de chaves estáticas guardadas como secrets. Isso reduz o impacto de vazamentos.

Passo 5: monitore drift

Drift é a diferença entre o que o código descreve e o que existe de fato, geralmente causada por alterações manuais de emergência. Agende um terraform plan -detailed-exitcode periódico: o código de saída 2 indica diferenças pendentes e pode disparar um alerta. Se você já mantém uma stack de métricas, conecte esse sinal a ela; o review técnico de Prometheus e Grafana mostra como estruturar alertas de forma confiável.

Trade-offs e erros comuns em infraestrutura como código

  • State único e gigante: aumenta o tempo de plan e o risco. Divida por ambiente e por domínio (rede, dados, aplicação).
  • Segredos no código: use um gerenciador de segredos e referencie valores, sem gravá-los em .tf ou .tfvars versionados.
  • Versões soltas: fixe a versão do provider e do binário com required_providers e required_version para builds reproduzíveis.
  • Import tardio: adotar a prática em infraestrutura já existente exige terraform import ou blocos import, e isso consome tempo. Comece por recursos novos e migre o legado por etapas.
  • Ferramenta como fim: Terraform, OpenTofu, Pulumi e Ansible resolvem problemas diferentes. Escolha pela necessidade do time (declarativo versus linguagem de programação, provisionamento versus configuração), não por moda.

Outro ponto prático: a infraestrutura como código também tem custo de manutenção. Revise módulos periodicamente, remova recursos órfãos e documente decisões no próprio repositório.

Conclusão

Começar com infraestrutura como código não exige uma grande migração: um repositório organizado, state remoto protegido, um módulo bem definido e um pipeline com plan revisado já elevam muito o nível de controle e previsibilidade. O próximo passo é ampliar a cobertura por etapas e medir o que importa para o seu time, como tempo de provisionamento e número de alterações manuais. Se quiser aplicar a mesma lógica de automação em processos de negócio, veja também 5 processos para automatizar hoje com IA.

Contact

Send a message

Get in touch