Quickstart: Export a virtual machine in the Azure portal

Applies to: ✔️ Any management plane resources from the AzureRM or AzAPI provider.

Existing Azure resources can be exported to Terraform through the Azure portal. This quickstart shows you how to use the Azure portal to export a resource group.

• Create a test Azure resource group using Azure CLI or Azure PowerShell.
• Create a test Linux virtual machine using Azure CLIor Azure PowerShell.
• Export the state for the resource group and virtual machine from Azure to Terraform.
• Test that the local state matches the state of the resources in Azure.

Prerequisites

• Set up an Azure account
• Install and configure Terraform

Sign in to Azure

Sign in to the Azure portal.

Create the test Azure resources

Azure CLI or Azure PowerShell

Create a Linux VM.

Azure CLI

1. Run az group create to create an Azure resource group.

   az group create --name myResourceGroup --location eastus
   

2. Run az vm create to create the virtual machine.

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

Azure PowerShell

1. Run New-AzResourceGroup to create an Azure resource group.

   New-AzResourceGroup -Name 'myResourceGroup' -Location 'EastUS'
   

2. Run New-AzVM to create the virtual machine.

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

Azure portal

1. Under Azure Services, select Virtual machines. If you don't see Virtual machines, search for it in the search bar.
2. In the Virtual machines page, select Create, to see a dropdown. Select Azure virtual machine.
3. Under Virtual Machine Name, type in myVM.
4. Under Resource Group Name, select Create new, and type in myResourceGroup.
5. Leave everything else as default. Select Review + create.
6. Verify everything is configured properly, then select Create.

Export resource group

Export the existing resource group to Terraform.

1. On the overview page for your resource group, expand the Automation tab, and select Export Template.

2. In the Export Template page, select Terraform.

3. Select either the AzureRM or AzAPI provider. Code can also be generated for both providers at once for side by side comparison.

4. Review the generated code.

5. Use the copy template button to paste directly into your code editor. Alternatively, use the download button to get a ZIP folder with the terraform configuration file.

Clean up resources

Delete resources

When no longer needed, you can delete the resource group, virtual machine, and all related resources.

1. At the top of the page for the resource group, select Delete resource group.
2. A page opens warning you that you're about to delete resources. Type the name of the resource group and select Delete to finish deleting the resources and the resource group.

Auto-shutdown

If the VM is still needed, Azure provides an Auto-shutdown feature for virtual machines to help manage costs and ensure you're not billed for unused resources.

1. On the Operations section for the VM, select the Auto-shutdown option.
2. A page opens where you can configure the auto-shutdown time. Select the On option to enable and then set a time that works for you.
3. Once you set the time, select Save at the top to enable your Auto-shutdown configuration.

Note

Remember to configure the time zone correctly to match your requirements, as (UTC) Coordinated Universal Time is the default setting in the Time zone dropdown.

For more information, see Auto-shutdown.

Next steps

In this quickstart, you deployed a simple virtual machine and exported the configuration to Terraform code.

Learn more about Terraform on Azure