Importar Infraestrutura como Código (Azure -> Terraform com AVM)

Converta a infraestrutura Azure existente em código Terraform de fácil manutenção usando dados de descoberta e Módulos Verificados do Azure.

Quando Usar Esta Habilidade

Use esta habilidade quando o usuário pedir para:

• Importar recursos Azure existentes para o Terraform
• Gerar IaC a partir de ambientes Azure ativos
• Lidar com qualquer tipo de recurso Azure suportado pelo AVM (e documentar fallbacks justificados que não são AVM)
• Recriar infraestrutura a partir de uma assinatura ou grupo de recursos
• Mapear dependências entre recursos Azure descobertos
• Usar módulos AVM em vez de recursos escritos manualmente azurerm_*

Pré-requisitos

• Azure CLI instalado e autenticado (az login)
• Acesso à assinatura ou grupo de recursos de destino
• Terraform CLI instalado
• Acesso à rede para o Terraform Registry e fontes de índice AVM

Entradas

Pelo menos um de subscription-id, resource-group-name ou resource-id é necessário.

Fluxos de Trabalho Passo a Passo

1) Coletar Escopo Necessário (Obrigatório)

Solicite um destes escopos antes de executar os comandos de descoberta:

• Escopo de assinatura: <subscription-id>
• Escopo de grupo de recursos: <resource-group-name>
• Escopo de recursos específicos: um ou mais valores de <resource-id>

Regras de tratamento de escopo:

• Trate IDs de recursos ARM do Azure (por exemplo, /subscriptions/.../providers/...) como identificadores de recursos na nuvem, não como caminhos de sistema de arquivos locais.
• Use IDs de recursos apenas com argumentos --ids da Azure CLI (por exemplo, az resource show --ids <resource-id>).
• Nunca passe IDs de recursos para comandos de leitura de arquivos (cat, ls, read_file, pesquisas globais), a menos que o usuário diga explicitamente que são caminhos de arquivo locais.
• Se o usuário já forneceu um escopo válido, não solicite entradas de escopo adicionais, a menos que sejam necessárias por um comando com falha.
• Não faça perguntas de acompanhamento que possam ser respondidas com os valores de escopo já fornecidos.

Se o escopo estiver faltando, solicite-o explicitamente e pare.

2) Autenticar e Definir Contexto

Execute apenas os comandos necessários para o escopo selecionado.

Para escopo de assinatura:

az login
az account set --subscription <subscription-id>
az account show --query "{subscriptionId:id, name:name, tenantId:tenantId}" -o json

Saída esperada: Objeto JSON com subscriptionId, name e tenantId.

Para escopo de grupo de recursos ou recursos específicos, az login ainda é necessário, mas az account set é opcional se o contexto ativo já estiver correto.

Ao usar o escopo de recursos específicos, prefira comandos diretos baseados em --ids primeiro e evite prompts de descoberta extras para assinatura ou grupo de recursos, a menos que necessário para um comando concreto.

3) Executar Comandos de Descoberta

Descubra recursos usando os escopos selecionados. Certifique-se de buscar todas as informações necessárias para uma geração precisa do Terraform.

# Subscription scope
az resource list --subscription <subscription-id> -o json

# Resource group scope
az resource list --resource-group <resource-group-name> -o json

# Specific resource scope
az resource show --ids <resource-id-1> <resource-id-2> ... -o json

Saída esperada: Objeto JSON ou array contendo metadados de recursos do Azure (id, type, name, location, tags, properties).

4) Resolver Dependências Antes da Geração de Código

Analise o JSON exportado e mapeie:

• Relacionamentos pai-filho (por exemplo: NIC -> Subnet -> VNet)
• Referências cruzadas em properties
• Ordenação para criação do Terraform

IMPORTANTE: Gere a seguinte documentação e salve-a em uma pasta docs na raiz do projeto.

• exported-resources.json com todos os recursos descobertos e seus metadados, incluindo dependências e referências.
• Arquivo EXPORTED-ARCHITECTURE.MD com uma visão geral da arquitetura legível por humanos com base nos recursos descobertos e seus relacionamentos.

5) Selecionar Módulos Verificados do Azure (Obrigatório)

Use a versão AVM mais recente para cada tipo de recurso.

Terraform Registry

• Pesquise por "avm" + nome do recurso
• Filtre por tag "Partner" para encontrar módulos AVM oficiais
• Exemplo: Pesquise "avm storage account" → filtre por Partner

Índice Oficial AVM

…