Habilidade Terraform para Claude

Orientação abrangente sobre Terraform e OpenTofu, cobrindo testes, módulos, CI/CD e padrões de produção. Baseado em terraform-best-practices.com e experiência corporativa.

Guia Detalhado

Leia o guia detalhado antes de executar esta habilidade. Ele retém o procedimento completo e o material de referência. Trate seus requisitos de segurança, pré-requisitos e validação como obrigatórios. Para trabalho focado, carregue as seções relevantes; para trabalho de ponta a ponta, leia o guia completamente.

Quando Usar Esta Habilidade

Ative esta habilidade quando:

• Criar novas configurações ou módulos Terraform ou OpenTofu
• Configurar infraestrutura de testes para código IaC
• Decidir entre abordagens de teste (validar, planejar, frameworks)
• Estruturar implantações multi-ambiente
• Implementar CI/CD para infraestrutura como código
• Revisar ou refatorar projetos Terraform/OpenTofu existentes
• Escolher entre padrões de módulos ou abordagens de gerenciamento de estado

Não use esta habilidade para:

• Perguntas básicas de sintaxe Terraform/OpenTofu (Claude já sabe disso)
• Referência de API específica do provedor (link para a documentação em vez disso)
• Perguntas sobre plataforma de nuvem não relacionadas a Terraform/OpenTofu

Count vs For_Each: Quando Usar Cada Um

Guia Rápido de Decisão

Padrões Comuns

Condições booleanas:

# ✅ GOOD - Boolean condition
resource "aws_nat_gateway" "this" {
  count = var.create_nat_gateway ? 1 : 0
  # ...
}

Endereçamento estável com for_each:

# ✅ GOOD - Removing "us-east-1b" only affects that subnet
resource "aws_subnet" "private" {
  for_each = toset(var.availability_zones)

  availability_zone = each.key
  # ...
}

# ❌ BAD - Removing middle AZ recreates all subsequent subnets
resource "aws_subnet" "private" {
  count = length(var.availability_zones)

  availability_zone = var.availability_zones[count.index]
  # ...
}

Para guias de migração e exemplos detalhados, veja: Padrões de Código: Count vs For_Each

Segurança e Conformidade

Verificações Essenciais de Segurança

# Static security scanning
trivy config .
checkov -d .

Problemas Comuns a Evitar

❌ Não:

• Armazenar segredos em variáveis
• Usar VPC padrão
• Ignorar criptografia
• Abrir grupos de segurança para 0.0.0.0/0

✅ Sim:

• Usar AWS Secrets Manager / Parameter Store
• Criar VPCs dedicadas
• Habilitar criptografia em repouso
• Usar grupos de segurança de menor privilégio

Para orientação detalhada de segurança, veja:

• Guia de Segurança e Conformidade - Integração Trivy/Checkov, gerenciamento de segredos, segurança de arquivos de estado, testes de conformidade

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.