Aracılığıyla paylaş


Hızlı Başlangıç: Terraform için Azure Export'ı kullanarak Azure kaynaklarını HCL koduna aktarma

Terraform için Azure Dışarı Aktarma'yı kullanarak ilk kaynaklarınızı dışarı aktarma makalesinde, Terraform için Azure Dışarı Aktarma'yı kullanarak Azure kaynaklarını yerel durum dosyalarına aktarmayı öğreneceksiniz. Bu makalede, Azure kaynaklarınızdan Terraform yapılandırma dosyalarını oluşturmayı öğreneceksiniz.

  • Azure CLI veya Azure PowerShell kullanarak test azure kaynak grubu oluşturun.
  • Azure CLI veya Azure PowerShell kullanarak bir test Linux sanal makinesi oluşturun.
  • Kaynak grubunu ve sanal makineyi Azure'dan HCL dosyalarına aktarın.
  • Yerel durumun Azure'daki kaynakların durumuyla eşleşerek eşleşmediğini test edin.

Önkoşullar

Test Azure kaynaklarını oluşturma

Linux VM oluşturun.

  1. Azure kaynak grubu oluşturmak için az group create komutunu çalıştırın.

    az group create --name myResourceGroup --location eastus
    
  2. Az vm create komutunu çalıştırarak sanal makineyi oluşturun.

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

Yalnızca hcl bayrağını anlama

Terraform için Azure Dışarı Aktarma, dışarı aktarılan kaynaklardan aşağıdaki dosyaların oluşturulmasına neden olan bir bayrağı --hcl-only destekler:

  • Oluşturulan .tf HCL dosyaları.
  • Eşleme dosyası aztfexportResourceMapping.json.
  • Atlanan kaynaklar içinde aztfexportSkippedResources.txtlistelenir.

Bayrağı --hcl-only , dışarı aktarma için kullanılan tüm birincil dışarı aktarma komutları için desteklenir:

  • kaynak
  • resource-group
  • query
  • eşleme dosyası

Terraform için Azure Dışarı Aktarma komutlarını görüntülemek için aşağıdaki komutu çalıştırın:

aztfexport --help

Bayrağı --hcl-only , duruma ihtiyacınız olmayan veya durumu oluşturmanız gerekip gerekmediğini bilmediğiniz senaryolarda kullanışlıdır. Oluşturulan tüm yapılandırmayı durumuna aktarmak için komutunu çalıştırın aztfexport mapping-file.

Bahşiş

bayrağını --hcl-only kullanırken, dışarı aktarma aşamasında herhangi bir geçerli durumda istenmeyen değişiklikler yapmaktan kaçınmak için boş bir dizini hedefle.

Azure kaynağını dışarı aktarma

Aracı iki moddan birinde çalıştırabilirsiniz aztfexport : etkileşimli ve etkileşimli olmayan. Bu tanıtım için etkileşimli olmayan modu kullanırsınız.

  1. Test etmek için bir dizin oluşturun.

  2. Bir komut istemi açın ve yeni dizine gidin.

  3. adlı myResourceGroupkaynak grubunu dışarı aktarmak için komutunu çalıştırınaztfexport resource-group.

    aztfexport resource-group --non-interactive --hcl-only myResourceGroup
    

Dekont

Terraform için Azure Dışarı Aktarma'nın çalıştırılması birkaç dakika sürebilir.

Sonuçları doğrulama

Araç Azure kaynaklarınızı dışarı aktarmayı tamamladıktan sonra Terraform için Azure Dışarı Aktarma'yı çalıştırdığınız dizinde aşağıdaki dosyaları doğrulayın:

  • main.tf dışarı aktarılan kaynakları tanımlayan HCL kodunu içerir.
  • aztfexportResourceMapping.json Azure/Terraform eşlemelerini içerir. Eşleme dosyası dışarı aktarılan her Azure kaynağı için aşağıdaki bilgileri içerir: Azure kaynak kimliği, Terraform kaynak türü ve Terraform kaynak adı. Eşleme dosyasının içeriği, dışarı aktarma işlemi sırasında Terraform için Azure Dışarı Aktarma'nın görüntülediği değeri yansıtır.
  • aztfexportSkippedResources.txt atlanan kaynakların listesini içerir. Bu örnekte bu dosyayı görmemeniz gerekir.

Kaynakları temizleme

Bu makalede oluşturulan kaynaklara artık ihtiyacınız kalmadığında aşağıdaki adımları uygulayın:

  1. Bu makale için Terraform dosyalarınızı içeren dizine gidin.

  2. Terraform destroy'u çalıştırın.

    terraform destroy
    

Sonraki adımlar