Share via


Guia de início rápido: exporte seus primeiros recursos usando o Azure Export for Terraform

Este artigo mostra como exportar recursos do Azure para arquivos de estado local usando o Azure Export for Terraform.

  • Crie um grupo de recursos do Azure de teste 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 aztfexport ferramenta em um dos dois modos: interativo e não interativo. Para esta demonstração, você usa o modo interativo.

  1. Crie um diretório no qual testar.

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

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

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

    Screenshot showing the Azure resources that would be exported based on the command and resource specified when you run the Azure Export for Terraform tool.

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

    Pontos principais:

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

Observação

A execução da 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 seguintes comandos no mesmo diretório que contém os arquivos gerados.

  1. Execute terraform init.

    terraform init --upgrade
    
  2. Executar plano de terraforma.

    terraform plan
    

Se as saídas do terminal não precisam de alterações, então 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 seguintes etapas:

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

  2. Executar terraform destruir.

    terraform destroy
    

Próximas etapas