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

Artigo
10/23/2023

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 Linux.

CLI do Azure
Azure PowerShell

Execute az group create para criar um grupo de recursos do Azure.
```
az group create --name myResourceGroup --location eastus
```

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

Execute New-AzResourceGroup para criar um grupo de recursos do Azure.
```
New-AzResourceGroup -Name 'myResourceGroup' -Location 'EastUS'
```

Execute New-AzVM para criar a máquina virtual.

New-AzVm `
    -ResourceGroupName 'myResourceGroup' `
    -Name 'myVM' `
    -Location 'East US' `
    -Image Debian11 `
    -size Standard_B2s `
    -PublicIpAddressName myPubIP `
    -OpenPorts 80 `
    -GenerateSshKey `
    -SshKeyName mySSHKey

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.

Crie um diretório no qual testar.
Abra um prompt de comando e navegue até o novo diretório.
Executar aztfexport resource-group para exportar o grupo de recursos chamado myResourceGroup.
```
aztfexport resource-group myResourceGroup
```
Depois que a ferramenta é inicializada, uma lista dos recursos a serem 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é a parte inferior e verifique se os recursos esperados do Azure estão mapeados corretamente para seus respetivos tipos de recursos Terraform.
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.

Nota

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

Verificar 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.

Execute terraform init.
```
terraform init --upgrade
```
Executar plano de terraforme.
```
terraform plan
```

Se as saídas do terminal Não são necessárias alterações, então parabéns!

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

Clean up resources (Limpar recursos)

Quando não precisar mais dos recursos criados neste artigo, execute as seguintes etapas:

Navegue até o diretório que contém seus arquivos Terraform para este artigo.
Correr terraform destruir.
```
terraform destroy
```

Próximos passos

Exportar recursos para o código HCL usando o Azure Export for Terraform