A infraestrutura como código deixou de ser diferencial e virou requisito para qualquer time que opera SaaS em nuvem. Neste review técnico, analiso o Terraform: como ele funciona por baixo, onde entrega valor, onde cobra um preço operacional e em quais cenários vale a adoção.
Como o Terraform implementa infraestrutura como código
O Terraform é uma ferramenta declarativa. Você descreve o estado desejado em HCL (HashiCorp Configuration Language) e o motor calcula a diferença entre esse estado e o que existe de fato no provedor. Esse é o núcleo de uma boa prática de infraestrutura como código: o repositório vira a fonte de verdade, e a infraestrutura passa a ser revisável, versionável e reproduzível.
Providers, state e grafo de dependências
O funcionamento se apoia em três peças:
- Providers: plugins que traduzem recursos HCL em chamadas de API (AWS, Azure, GCP, Cloudflare, Kubernetes, entre muitos outros). O Terraform em si não conhece nuvem nenhuma.
- State: um arquivo que mapeia cada recurso declarado ao objeto real no provedor, com seus atributos. É ele que permite o
plancalcular o diff sem consultar tudo do zero. - Grafo de dependências: o Terraform monta um DAG a partir das referências entre recursos e paraleliza o que não depende entre si.
O ciclo básico é init, plan e apply. O plan é o grande ativo: ele mostra o que será criado, alterado ou destruído antes de qualquer mudança, e pode ser salvo como artefato para ser aplicado exatamente como foi revisado.
Prós e contras reais da ferramenta
O que funciona bem
- Ecossistema de providers: a cobertura é muito ampla, o que permite gerenciar nuvem, DNS, monitoramento e SaaS de terceiros com a mesma linguagem.
- Plan revisável: encaixa bem em pull requests e em fluxos de aprovação.
- Módulos: permitem padronizar redes, clusters e bancos, reduzindo divergência entre ambientes.
- Portabilidade de conhecimento: o mesmo fluxo vale para provedores diferentes, embora os recursos em si não sejam portáveis.
Onde dói
- Gestão do state: é o ponto crítico. Ele pode conter dados sensíveis, precisa de backend remoto com lock e backup, e corrupção ou concorrência de applies gera incidentes sérios.
- Drift: alterações manuais no console fazem o state divergir da realidade. O Terraform detecta no plan, mas não impede que aconteça.
- Limites do HCL: é declarativo, então lógica complexa com
for_each,counte expressões condicionais vira código difícil de ler. - Blast radius: um state monolítico torna cada apply arriscado e lento. É preciso dividir em stacks menores.
- Licença: a HashiCorp mudou a licença do Terraform para BSL em 2023, e a comunidade respondeu com o fork OpenTofu, mantido sob a Linux Foundation. Vale avaliar a política de licenciamento da sua empresa antes de padronizar.
Padrões de uso em SaaS e times pequenos
Em times enxutos, a infraestrutura como código só se paga se vier acompanhada de disciplina. Alguns padrões que funcionam bem:
- Backend remoto com lock de state e criptografia, nunca state local em máquina de desenvolvedor.
- Um state por ambiente e por domínio (rede, dados, aplicação), para limitar o impacto de erros.
- Versões de providers e do próprio Terraform fixadas, para evitar mudanças inesperadas entre execuções.
- Plan automático em pull request e apply somente após aprovação, via pipeline de CI/CD.
- Segredos fora do código, vindos de um cofre ou de variáveis protegidas do pipeline.
Um exemplo mínimo de configuração com versões fixadas e backend remoto:
terraform {
required_version = ">= 1.5"
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 5.0"
}
}
backend "s3" {
bucket = "meu-bucket-de-state"
key = "prod/rede/terraform.tfstate"
region = "us-east-1"
}
}
resource "aws_s3_bucket" "logs" {
bucket = "minha-empresa-logs-prod"
}Esse esqueleto é só o ponto de partida. Em produção, adicione lock de state, criptografia, políticas de acesso mínimas e módulos reutilizáveis.
Integração com observabilidade e custo
Declarar também alertas, dashboards e regras de monitoramento no mesmo repositório evita que a observabilidade fique para depois. Se você usa essa stack, vale conferir o review técnico de Prometheus e Grafana. Para quem automatiza processos do negócio além da infra, o artigo sobre automação com IA para donos de empresa complementa a visão.
Quando adotar e quais alternativas avaliar
O Terraform faz sentido quando você tem mais de um ambiente, mais de uma pessoa mexendo na infra ou exigência de auditoria. Para um projeto único e simples, o custo de manter state, pipeline e módulos pode superar o benefício.
Entre as alternativas, o OpenTofu mantém compatibilidade com a sintaxe e é a opção natural para quem quer evitar a licença BSL. O Pulumi permite usar linguagens como TypeScript e Python, o que ajuda em lógica complexa, mas exige mais disciplina de engenharia. Ferramentas nativas, como CloudFormation e Bicep, integram melhor com um único provedor, ao custo de prender você a ele. Ansible continua útil para configuração de servidores, mas não é a melhor escolha para provisionar recursos de nuvem.
A escolha depende de quanto multi-cloud você espera, do perfil do time e da tolerância a lock-in. Sempre teste a ferramenta em um ambiente não crítico antes de padronizar, e documente as decisões de arquitetura, comunicando mudanças relevantes como sugere o guia sobre como comunicar lançamentos e updates de SaaS.
Conclusão
O Terraform é hoje uma das opções mais maduras para infraestrutura como código, com um ecossistema amplo e um fluxo de plan e apply que dá previsibilidade. O preço é operacional: state bem gerenciado, módulos organizados, versões fixas e pipeline com revisão. Com esses cuidados, ele reduz drift, acelera a criação de ambientes e deixa a infraestrutura auditável. Sem eles, vira só mais uma fonte de incidentes.