Snabbstart: Exportera Azure-resurser till HCL-kod med Hjälp av Azure Export for Terraform

Artikel
10/23/2023

I artikeln Exportera dina första resurser med Hjälp av Azure Export för Terraform får du lära dig hur du exporterar Azure-resurser till lokala tillståndsfiler med Hjälp av Azure Export för Terraform. I den här artikeln får du lära dig hur du genererar Terraform-konfigurationsfilerna från dina Azure-resurser.

Skapa en Azure-testresursgrupp med Hjälp av Azure CLI eller Azure PowerShell.
Skapa en virtuell Linux-testdator med Azure CLI eller Azure PowerShell.
Exportera resursgruppen och den virtuella datorn från Azure till HCL-filer.
Testa att det lokala tillståndet matchar tillståndet för resurserna i Azure.

Förutsättningar

Skapa azure-testresurserna

Skapa en virtuell Linux-dator.

Azure CLI
Azure PowerShell

Kör az group create för att skapa en Azure-resursgrupp.

az group create --name myResourceGroup --location eastus

Kör az vm create för att skapa den virtuella datorn.

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

Kör New-AzResourceGroup för att skapa en Azure-resursgrupp.

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

Kör New-AzVM för att skapa den virtuella datorn.

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

Förstå flaggan endast hcl

Azure Export for Terraform har stöd för en flagga – --hcl-only som orsakar genereringen av följande filer från de exporterade resurserna:

.tf Genererade HCL-filer.
Mappningsfil aztfexportResourceMapping.json.
Överhoppade resurser visas i aztfexportSkippedResources.txt.

Flaggan --hcl-only stöds för alla primära exportkommandon som används för export:

resource
resource-group
query
mappningsfil

Kör följande kommando för att visa tillgängliga Azure Export for Terraform-kommandon:

aztfexport --help

Flaggan --hcl-only är användbar i scenarier där du inte behöver tillståndet eller inte är säker på om du behöver generera tillståndet. Om du vill exportera all genererad konfiguration till tillstånd kör du aztfexport mapping-file.

Dricks

När du använder flaggan ska du rikta in dig på --hcl-only en tom katalog för att undvika att göra oönskade ändringar i aktuellt tillstånd under exportsteget.

Exportera en Azure-resurs

Du kan köra aztfexport verktyget i något av två lägen: interaktiv och icke-interaktiv. För den här demonstrationen använder du det icke-interaktiva läget.

Skapa en katalog där du kan testa.
Öppna en kommandotolk och gå till den nya katalogen.
Kör aztfexport resource-group för att exportera resursgruppen med namnet myResourceGroup.
```
aztfexport resource-group --non-interactive --hcl-only myResourceGroup
```

Kommentar

Det kan ta flera minuter att köra Azure Export for Terraform.

Verifiera resultatet

När verktyget har exporterat dina Azure-resurser kontrollerar du följande filer i katalogen där du körde Azure Export for Terraform:

main.tf innehåller den HCL-kod som definierar de exporterade resurserna.
aztfexportResourceMapping.json innehåller Azure/Terraform-mappningarna. Mappningsfilen innehåller följande information för varje exporterad Azure-resurs: Azure-resurs-ID, Terraform-resurstyp och Terraform-resursnamn. Innehållet i mappningsfilen speglar vad Azure Export for Terraform visar under exportprocessen.
aztfexportSkippedResources.txt innehåller listan över överhoppade resurser. Du bör inte se den här filen för det här exemplet.

Rensa resurser

Gör följande när du inte längre behöver de resurser som skapats i den här artikeln:

Navigera till katalogen som innehåller Terraform-filerna för den här artikeln.
Kör terraform destroy.
```
terraform destroy
```

Nästa steg

Så här fungerar Azure Export for Terraform

Dela via