Dela via

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

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.

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

    az group create --name myResourceGroup --location eastus

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

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.

  1. Skapa en katalog där du kan testa.

  2. Öppna en kommandotolk och gå till den nya katalogen.

  3. 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:

  1. Navigera till katalogen som innehåller Terraform-filerna för den här artikeln.

  2. Kör terraform destroy.

    terraform destroy

Nästa steg

Så här fungerar Azure Export for Terraform