Rychlý start: Export prostředků Azure do kódu HCL pomocí Azure Exportu pro Terraform

Článek
10/23/2023

V článku exportujte první prostředky pomocí Azure Exportu pro Terraform, kde se dozvíte, jak exportovat prostředky Azure do místních stavových souborů pomocí Azure Exportu pro Terraform. V tomto článku se dozvíte, jak vygenerovat konfigurační soubory Terraformu z prostředků Azure.

Vytvořte testovací skupinu prostředků Azure pomocí Azure CLI nebo Azure PowerShellu.
Vytvořte testovací virtuální počítač s Linuxem pomocí Azure CLI nebo Azure PowerShellu.
Exportujte skupinu prostředků a virtuální počítač z Azure do souborů HCL.
Otestujte, že místní stav odpovídá stavu prostředků v Azure.

Požadavky

Vytvoření testovacích prostředků Azure

Vytvořte virtuální počítač s Linuxem.

Azure CLI
Azure PowerShell

Spuštěním příkazu az group create vytvořte skupinu prostředků Azure.
```
az group create --name myResourceGroup --location eastus
```

Spuštěním příkazu az vm create vytvořte virtuální počítač.

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

Spuštěním rutiny New-AzResourceGroup vytvořte skupinu prostředků Azure.
```
New-AzResourceGroup -Name 'myResourceGroup' -Location 'EastUS'
```

Spuštěním rutiny New-AzVM vytvořte virtuální počítač.

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

Vysvětlení příznaku hcl-only

Azure Export for Terraform podporuje příznak , --hcl-only který způsobuje generování následujících souborů z exportovaných prostředků:

Vygenerované .tf soubory HCL
aztfexportResourceMapping.jsonSoubor mapování .
Vynechané prostředky jsou uvedeny v aztfexportSkippedResources.txtseznamu .

Příznak --hcl-only je podporovaný pro všechny primární příkazy exportu používané k exportu:

resource
resource-group
query
mapování souboru

Pokud chcete zobrazit dostupné příkazy Azure Exportu pro Terraform, spusťte následující příkaz:

aztfexport --help

Příznak --hcl-only je užitečný ve scénářích, kdy nepotřebujete stav nebo si nejste jistí, jestli potřebujete vygenerovat stav. Pokud chcete exportovat veškerou vygenerovanou konfiguraci do stavu, spusťte aztfexport mapping-filepříkaz .

Tip

Pokud používáte --hcl-only příznak, zaměřte se na prázdný adresář, abyste se vyhnuli nežádoucím změnám v libovolném aktuálním stavu během fáze exportu.

Export prostředku Azure

Nástroj můžete spustit aztfexport v jednom ze dvou režimů: interaktivní a neinteraktivní. Pro tuto ukázku použijete neinteraktivní režim.

Vytvořte adresář, ve kterém se má testovat.
Otevřete příkazový řádek a přejděte do nového adresáře.
Spuštěním aztfexport resource-group exportu skupiny prostředků s názvem myResourceGroup.
```
aztfexport resource-group --non-interactive --hcl-only myResourceGroup
```

Poznámka:

Dokončení spuštění služby Azure Export pro Terraform může trvat několik minut.

Ověření výsledků

Po dokončení exportu prostředků Azure v adresáři, ve kterém jste spustili Azure Export pro Terraform, ověřte následující soubory:

main.tf obsahuje kód HCL, který definuje exportované prostředky.
aztfexportResourceMapping.json obsahuje mapování Azure/Terraformu. Soubor mapování obsahuje následující informace pro každý exportovaný prostředek Azure: ID prostředku Azure, typ prostředku Terraform a název prostředku Terraform. Obsah souboru mapování zrcadlí, co Azure Export for Terraform zobrazuje během procesu exportu.
aztfexportSkippedResources.txt obsahuje seznam přeskočených prostředků. V tomto příkladu byste tento soubor neměli vidět.

Vyčištění prostředků

Pokud už prostředky vytvořené v tomto článku nepotřebujete, proveďte následující kroky:

Přejděte do adresáře obsahujícího soubory Terraformu pro tento článek.
Spusťte terraform destroy.
```
terraform destroy
```

Další kroky

Jak funguje Azure Export pro Terraform