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?Link para esta seção

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çõesLink para esta seção

1. Limpar o cache do TerraformLink para esta seção

O primeiro passo é sempre limpar o cache:

rm -rf .terraform
terraform init

2. Verificar conectividadeLink para esta seção

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)Link para esta seção

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 privadosLink para esta seção

Para repositórios privados, configure suas credenciais:

git config --global credential.helper store

5. Usar fonte alternativaLink para esta seção

Se o problema persistir, tente especificar uma fonte alternativa:

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

PrevençãoLink para esta seçã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ãoLink para esta seçã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.