Compartilhar via


Início Rápido: exportar seus primeiros recursos usando a Exportação do Azure para Terraform

Este artigo mostra como exportar recursos do Azure para arquivos de estado local usando a Exportação do Azure para Terraform.

  • Crie um grupo de recursos de teste do Azure usando a CLI do Azure ou o Azure PowerShell.
  • Crie uma máquina virtual Linux de teste usando a CLI do Azure ou o Azure PowerShell.
  • Exporte o estado do grupo de recursos e da máquina virtual do Azure para o arquivo de estado local.
  • Teste se o estado local corresponde ao estado dos recursos no Azure.

Pré-requisitos

Criar os recursos de teste do Azure

Crie uma VM do Linux.

  1. Execute az group create para criar um grupo de recursos do Azure.

    az group create --name myResourceGroup --location eastus
    
  2. Execute az vm create para criar a máquina virtual.

    az vm create \
      --resource-group myResourceGroup \
      --name myVM \
      --image Debian11 \
      --admin-username azureadmin \
      --generate-ssh-keys \
      --public-ip-sku Standard
    

Exportar um recurso do Azure

Você pode executar a ferramenta aztfexport em dois modos diferentes: interativo e não interativo. Para esta demonstração, você usa o modo interativo.

  1. Crie um diretório onde o teste será realizado.

  2. Abra um prompt de comando e navegue até o diretório novo.

  3. Execute aztfexport resource-group para exportar grupo de recursos chamado myResourceGroup.

    aztfexport resource-group myResourceGroup
    
  4. Após a inicialização da ferramenta, uma lista dos recursos que serão exportados é exibida. Cada linha tem um resourceID do Azure correspondente ao tipo de recurso AzureRM correspondente. A lista de comandos disponíveis é exibida na parte inferior da tela. Usando um dos comandos, role até o fim e verifique se os recursos esperados do Azure estão devidamente mapeados para seus respectivos tipos de recurso do Terraform.

  5. Pressione w para executar a exportação.

    Pontos principais:

    • Para um recurso não interativo, adicione o sinalizador --non-interactive: aztfexport rg --non-interactive myResourceGroup.

Observação

A execução do Exportação do Azure para Terraform pode levar vários minutos para ser concluída.

Verifique os resultados

Depois que a ferramenta terminar de exportar seus recursos do Azure, execute os comandos a seguir no mesmo diretório que contém os arquivos gerados.

  1. Execute terraform init.

    terraform init --upgrade
    
  2. Execute terraform plan.

    terraform plan
    

Se o terminal exibir Nenhuma alteração necessária, parabéns!

Sua infraestrutura e seu estado correspondente foram exportados com sucesso para o Terraform.

Limpar os recursos

Quando você não precisar mais dos recursos criados neste artigo, execute as etapas a seguir:

  1. Navegue até o diretório que contém seus arquivos do Terraform para este artigo.

  2. Execute terraform destroy.

    terraform destroy
    

Próximas etapas