Estado, travas e desvios
Entenda o estado do Terraform, compartilhe-o com segurança usando backends remotos e travas, e detecte e resolva desvios entre o código e a realidade.
- Explicar para que serve o estado do Terraform e como guardá-lo e protegê-lo
- Explicar por que travar o estado importa quando várias pessoas ou pipelines aplicam mudanças
- Detectar desvios e decidir se vai revertê-los, codificá-los ou ignorá-los
Como o Terraform sabe que o aws_instance.web do seu arquivo é o servidor i-0a1b2c3d na nuvem? Pelo estado (state): um arquivo JSON que liga o endereço de cada recurso ao ID do objeto real e aos últimos atributos conhecidos. Os planos comparam três coisas - a configuração, o estado e (depois de um refresh) o mundo real.
Regras para o estado:
- Guarde-o num backend remoto (um bucket S3, Azure Storage, Google Cloud Storage, HCP Terraform...) para que toda a equipe e o CI compartilhem uma única cópia - e não num notebook.
- Trave-o durante as operações, para que dois applies não rodem ao mesmo tempo e o corrompam.
- Trate-o como sensível: ele pode conter senhas e chaves. Criptografe-o e restrinja o acesso.
- Nunca o edite à mão. Use
terraform importpara adotar recursos existentes,terraform state mv(ou blocosmoved) ao renomear eterraform state rmpara deixar de gerenciar algo.
1terraform {
2 backend "s3" {
3 bucket = "byte-bakery-terraform-state"
4 key = "staging/web.tfstate"
5 region = "eu-west-1"
6 encrypt = true
7 use_lockfile = true # take a lock in the bucket while plan or apply runs
8 }
9}Desvio
Um desvio (drift) é qualquer diferença entre o código e a realidade, normalmente causada por mudanças feitas fora do Terraform: alguém redimensionou um servidor no console durante um incidente, ou abriu uma porta “só por um minuto”. Detecte-o rodando terraform plan -refresh-only (ou um plano normal) de forma agendada, e resolva cada diferença de propósito:
- Reverta - aplique o código de novo - quando a mudança manual foi um erro ou um risco de segurança.
- Codifique - atualize o código para combinar - quando a mudança deve ficar.
- Ignore com
lifecycle { ignore_changes = [...] }quando outra coisa gerencia legitimamente aquele atributo, como um autoscaler.
Experimente
Até 15 XPO que deve acontecer com este desvio?
A verificação noturna de desvios da Byte Bakery encontrou estas diferenças. Decida como resolver cada uma.
“Alguém abriu o SSH (porta 22) para a internet inteira enquanto depurava”
“Durante um incidente, o plantão dobrou o tamanho do banco de dados, e a equipe decidiu manter”
“O autoscaler fica mudando a capacidade desejada do grupo”
“A criptografia foi desligada no bucket de pedidos”
“A ferramenta de custos do financeiro acrescenta uma tag `cost-center` em tudo”
1state = {"instance_type": "t3.small", "port_22_open": "false", "desired_capacity": "2"}
2real = {"instance_type": "t3.large", "port_22_open": "false", "desired_capacity": "5"}
3ignored = {"desired_capacity"}
4
5for key in state:
6 if key not in ignored and state[key] != real[key]:
7 print(f"drift: {key} is {real[key]}, code says {state[key]}")drift: instance_type is t3.large, code says t3.small
Principais conclusões
O estado liga a configuração aos recursos reais; mantenha-o remoto, travado, criptografado e com acesso controlado.
Nunca edite o estado à mão: use import, blocos moved e os comandos de state.
Procure desvios de forma agendada, e resolva-os revertendo, codificando ou ignorando.
Menos mudanças manuais significam menos desvios: faça do código o caminho mais fácil.
Quiz da aula
7 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: automatize tarefas de DevOps com Python
Escreva as pequenas ferramentas em Python que times de DevOps realmente criam, como executores de pipeline, verificadores de plano, calculadoras de métricas e scanners, e execute-as com entradas de exemplo. Elas rodam localmente no navegador; não é preciso ter servidores nem contas na nuvem.
Simule a trava do estado
A primeira linha da entrada é o timeout da trava em minutos. Cada linha seguinte é um pedido de apply, em ordem de tempo: start_minute person duration. Só um apply pode segurar a trava. Se a trava estiver livre no início do pedido, o apply roda na hora; se ela for ficar livre dentro do timeout, ele espera e roda assim que os applies anteriores terminarem (em ordem); caso contrário, ele falha.
Imprima alice: applied 0-5, bob: waited 2 min, applied 5-9 ou carol: lock timeout after 3 min (held by bob) - em que quem segura é quem está com a trava no momento em que a espera acaba.
- Manhã movimentada
- Fila paciente
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Relate os desvios
A entrada tem três seções separadas por ---: o estado (o que o Terraform registrou por último), os recursos reais da nuvem e as regras de ignorar. As linhas do estado e das reais são address key=value ...; as linhas de ignorar são address key.
Para cada recurso, na ordem do estado, imprima aws_instance.web: drifted (instance_type t3.small -> t3.large) (o valor do estado e depois o valor real, com os atributos diferentes na ordem do estado, separados por vírgulas e pulando os ignorados), aws_s3_bucket.logs: deleted outside Terraform ou aws_iam_role.app: in sync. Depois, para os recursos reais que não estão no estado, na ordem real: aws_instance.debug: not managed by Terraform (import or delete it). Termine com drifted: 1, deleted: 1, unmanaged: 1.
- Verificação noturna
- Tudo limpo
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…