Neste artigo
- O que é infraestrutura como código na prática?
- Os três comandos do fluxo básico
- O estado é a memória do Terraform
- Erros comuns de quem começa
- Do tutorial ao projeto real
- Estado remoto e trava: o ponto que separa estudo de equipe
- Terraform é gratuito?
- Preciso saber programar para usar Terraform?
- Terraform funciona com qualquer nuvem?
- O que acontece se eu perder o arquivo de estado?
- Terraform substitui o Docker?
Configurar servidor na mão funciona até a segunda vez. O Terraform resolve isso descrevendo a infraestrutura em arquivos de código: você declara a máquina, a rede e o banco que quer, e a ferramenta cria, altera e destrói recursos na nuvem seguindo exatamente o que está escrito no repositório.
Terraform é a ferramenta de infraestrutura como código que traduz arquivos .tf em recursos reais na AWS, Azure, Google Cloud e outros provedores. O fluxo básico tem três comandos: init, plan e apply. Antes de automatizar, vale entender por que a conta da nuvem estoura quando ninguém controla o que está rodando, tema do guia sobre o custo na AWS.
O que é infraestrutura como código na prática?
É escrever em arquivos de texto aquilo que você faria clicando no console do provedor. Cada recurso vira um bloco com tipo, nome e argumentos, e o conjunto forma a descrição completa do ambiente. A diferença para o clique é que o arquivo pode ser versionado no Git, revisado antes de entrar e recriado do zero em outro ambiente em minutos, sem depender da memória de quem configurou.
💡 Dica: trate o diretório do Terraform como qualquer projeto de código: um repositório próprio, commits pequenos e revisão antes de aplicar mudança em produção.
Os três comandos do fluxo básico
init baixa o provedor e prepara o diretório, e roda uma vez por projeto. plan compara o que está declarado com o que existe na nuvem e mostra o que será criado, alterado ou destruído. apply executa o plano de fato. O hábito que separa o uso seguro do acidente é ler o plan inteiro antes do apply, porque é ali que aparece o recurso que você não queria tocar.
resource "aws_instance" "app" {
ami = "ami-12345678"
instance_type = "t3.micro"
tags = {
Name = "app-producao"
}
}
Esse bloco declara uma máquina EC2. Trocar o instance_type e rodar plan mostra a mudança proposta, e apply executa. É o mesmo raciocínio de quem já usa Docker Compose para subir um ambiente com um comando, só que aqui o alvo é a nuvem, não o container local.
O estado é a memória do Terraform
O arquivo de estado guarda o que o Terraform criou e mapeia cada recurso real para cada bloco de código. Sem ele, a ferramenta não sabe o que já existe. O estado é sensível: pode conter segredos e, se duas pessoas aplicarem ao mesmo tempo, corrompe. Por isso times usam armazenamento remoto com bloqueio, como um bucket com lock, em vez do estado local de quem está estudando.
Erros comuns de quem começa
O primeiro é aplicar direto em produção sem rodar plan. O segundo é editar recurso no console do provedor e esquecer que o código diz outra coisa, o que gera diferença na próxima execução. O terceiro é commitar o estado no repositório e expor dado sensível. O quarto é tratar o Terraform como mágica: sem entender o que o plan mostra, a automação só acelera o erro.
Do tutorial ao projeto real
Um caminho concreto: suba uma máquina e uma rede na conta gratuita de um provedor, destrua e recrie o ambiente até confiar no processo. Depois, leve os arquivos para o pipeline, aplicando por CI em vez do notebook local, fluxo que o guia de pipeline com GitHub Actions detalha. Quando o ambiente inteiro nasce de um repositório, a infraestrutura ganha a mesma previsibilidade do código da aplicação.
Divida o estado cedo em módulos por domínio: rede, banco, aplicação. Na hora de revisar, o terraform plan é o documento central, e a regra é ler o plano inteiro antes de aplicar, sem exceções, porque é nele que o delete escondido aparece. Tratar o plan como um pull request de infraestrutura é o hábito que separa a infra madura da apostada em criatividade. E documente cada recurso com uma variável descritiva e um comentário curto, porque o arquivo que você entende hoje é o mesmo que alguém do time vai ler daqui a seis meses sem o contexto daquela tarde.
Estado remoto e trava: o ponto que separa estudo de equipe
No tutorial, o estado vive no seu computador. No time, ele precisa migrar para armazenamento remoto, o backend do Terraform, que guarda o estado compartilhado e trava durante a aplicação para impedir duas pessoas de alterar a mesma infraestrutura ao mesmo tempo. Sem isso, cada máquina tem uma versão diferente da realidade, e a próxima execução destrói o que a anterior criou. Configurar backend remoto e travamento é a primeira tarefa de qualquer projeto de equipe, e não um refinamento opcional.
O segundo hábito de equipe é nunca editar o estado à mão, porque o arquivo é o registro do que existe de fato, e ajuste manual desincroniza o mapa do território. Quando algo desanda, a saída é importar o recurso real para o estado ou ajustar o código e aplicar, nunca apagar o arquivo. Junto com variáveis de ambiente para credencial e separação de ambiente por diretório ou workspace, essa disciplina mantém a automação confiável justamente quando ela passa a mexer em produção.
Perguntas frequentes
Terraform é gratuito?
A ferramenta de linha de comando tem versão gratuita e cobre a maior parte dos cenários de estudo e de trabalho. Existem ofertas pagas para gestão de estado e colaboração em time, mas nenhuma delas é necessária para começar.
Preciso saber programar para usar Terraform?
Não. A linguagem do Terraform, chamada HCL, é declarativa: você descreve o resultado desejado, não o passo a passo. Quem já escreveu YAML se adapta rápido, e lógica de programação ajuda, mas não é requisito.
Terraform funciona com qualquer nuvem?
Funciona com AWS, Azure, Google Cloud e centenas de outros serviços por meio de provedores plugáveis. O mesmo fluxo de init, plan e apply vale para todos, um dos motivos da adoção ampla em times que usam mais de uma nuvem.
O que acontece se eu perder o arquivo de estado?
O Terraform perde o vínculo com o que criou e passa a enxergar a nuvem como vazia. Os recursos continuam rodando, mas deixam de ser gerenciados. Por isso o estado precisa de backup e armazenamento remoto desde o primeiro projeto sério.
Terraform substitui o Docker?
Não, eles resolvem camadas diferentes. O Docker empacota e roda a aplicação em containers, e o Terraform cria a infraestrutura que recebe esses containers: rede, máquina, cluster e banco. Em um projeto real, os dois convivem.