Quickstart: Azure-resources exporteren naar HCL-code met behulp van Azure Export voor Terraform

Artikel
10/23/2023

In het artikel exporteert u uw eerste resources met behulp van Azure Export voor Terraform en leert u hoe u Azure-resources exporteert naar lokale statusbestanden met behulp van Azure Export voor Terraform. In dit artikel leert u hoe u de Terraform-configuratiebestanden genereert op basis van uw Azure-resources.

Maak een Azure-resourcegroep testen met behulp van Azure CLI of Azure PowerShell.
Maak een virtuele Linux-machine met behulp van Azure CLI of Azure PowerShell.
Exporteer de resourcegroep en virtuele machine van Azure naar HCL-bestanden.
Test of de lokale status overeenkomt met de status van de resources in Azure.

Vereisten

De Azure-test-resources maken

Maak een Virtuele Linux-machine.

Azure-CLI
Azure PowerShell

Voer az group create uit om een Azure-resourcegroep te maken.
```
az group create --name myResourceGroup --location eastus
```

Voer az vm create uit om de virtuele machine te maken.

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

Voer New-AzResourceGroup uit om een Azure-resourcegroep te maken.

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

Voer New-AzVM uit om de virtuele machine te maken.

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

Inzicht in de vlag alleen-hcl

Azure Export voor Terraform ondersteunt een vlag: --hcl-only dit zorgt ervoor dat de volgende bestanden worden gegenereerd uit de geëxporteerde resource(s):

Gegenereerde .tf HCL-bestanden.
Toewijzingsbestand aztfexportResourceMapping.json.
Overgeslagen resources worden vermeld in aztfexportSkippedResources.txt.

De --hcl-only vlag wordt ondersteund voor alle primaire exportopdrachten die worden gebruikt voor het exporteren:

resource
resource-group
query
mapping-file

Voer de volgende opdracht uit om de beschikbare Azure Export voor Terraform-opdrachten weer te geven:

aztfexport --help

De --hcl-only vlag is handig in scenario's waarin u de status niet nodig hebt of niet zeker weet of u de status moet genereren. Als u alle gegenereerde configuratie wilt exporteren naar status, voert u uit aztfexport mapping-file.

Tip

Wanneer u de --hcl-only vlag gebruikt, richt u zich op een lege map om te voorkomen dat er ongewenste wijzigingen worden aangebracht in de huidige status tijdens de exportfase.

Een Azure-resource exporteren

U kunt het aztfexport hulpprogramma uitvoeren in een van de twee modi: interactief en niet-interactief. Voor deze demo gebruikt u de niet-interactieve modus.

Maak een map waarin u wilt testen.
Open een opdrachtprompt en navigeer naar de nieuwe map.
Voer uit aztfexport resource-group om de resourcegroep met de naam myResourceGroupte exporteren.
```
aztfexport resource-group --non-interactive --hcl-only myResourceGroup
```

Notitie

Het uitvoeren van Azure Export voor Terraform kan enkele minuten duren.

De resultaten controleren

Nadat het hulpprogramma klaar is met het exporteren van uw Azure-resources, controleert u de volgende bestanden in de map waarin u Azure Export voor Terraform hebt uitgevoerd:

main.tf bevat de HCL-code waarmee de geëxporteerde resources worden gedefinieerd.
aztfexportResourceMapping.json bevat de Azure/Terraform-toewijzingen. Het toewijzingsbestand bevat de volgende informatie voor elke geëxporteerde Azure-resource: Azure-resource-id, Terraform-resourcetype en Terraform-resourcenaam. De inhoud van het toewijzingsbestand spiegelt wat Azure Export voor Terraform tijdens het exportproces weergeeft.
aztfexportSkippedResources.txt bevat de lijst met overgeslagen resources. U ziet dit bestand niet voor dit voorbeeld.

Resources opschonen

Voer de volgende stappen uit wanneer u de resources die in dit artikel zijn gemaakt niet meer nodig hebt:

Navigeer naar de map met uw Terraform-bestanden voor dit artikel.
Terraform vernietigen.
```
terraform destroy
```

Volgende stappen

Hoe Azure Export voor Terraform werkt

Delen via