Como resolver um "Failed to Download Module" do Terraform / OpenTofu

Se você já trabalhou com Terraform ou OpenTofu, provavelmente já se deparou com o erro "Failed to Download Module". Este problema pode ser frustrante, mas tem soluções relativamente simples.

O que causa este erro?

O erro "Failed to Download Module" geralmente ocorre por alguns motivos principais:

1. Problemas de conectividade de rede
2. Configuração incorreta de proxy
3. Problemas de autenticação com repositórios privados
4. Cache corrompido do Terraform

Soluções

1. Limpar o cache do Terraform

O primeiro passo é sempre limpar o cache:

rm -rf .terraform
terraform init

2. Verificar conectividade

Teste se você consegue acessar o repositório do módulo:

curl -I https://github.com/seu-usuario/seu-modulo

3. Configurar proxy (se necessário)

Se você está atrás de um proxy corporativo:

export HTTP_PROXY=http://proxy.empresa.com:8080
export HTTPS_PROXY=http://proxy.empresa.com:8080
terraform init

4. Autenticação para repositórios privados

Para repositórios privados, configure suas credenciais:

git config --global credential.helper store

5. Usar fonte alternativa

Se o problema persistir, tente especificar uma fonte alternativa:

module "exemplo" {
  source = "git::https://github.com/usuario/modulo.git?ref=v1.0.0"
}

Prevenção

Para evitar esses problemas no futuro:

• Sempre especifique versões dos módulos
• Use repositórios confiáveis
• Mantenha o Terraform atualizado
• Configure adequadamente seu ambiente de rede

Conclusão

O erro "Failed to Download Module" é comum mas solucionável. Na maioria dos casos, limpar o cache e verificar a conectividade resolve o problema.