Mulai cepat: Mengekspor sumber daya Azure ke dalam kode HCL menggunakan Azure Export for Terraform

  • Artikel

Dalam artikel, Ekspor sumber daya pertama Anda menggunakan Azure Export for Terraform, Anda mempelajari cara mengekspor sumber daya Azure ke file status lokal menggunakan Azure Export for Terraform. Dalam artikel ini, Anda mempelajari cara membuat file konfigurasi Terraform dari sumber daya Azure Anda.

  • Buat grup sumber daya Azure pengujian menggunakan Azure CLI atau Azure PowerShell.
  • Buat komputer virtual Linux pengujian menggunakan Azure CLI atau Azure PowerShell.
  • Ekspor grup sumber daya dan komputer virtual dari Azure ke file HCL.
  • Uji bahwa status lokal cocok dengan status sumber daya di Azure.

Prasyarat

Membuat sumber daya Azure pengujian

Buat VM Linux.

  1. Jalankan az group create untuk membuat grup sumber daya Azure.

    az group create --name myResourceGroup --location eastus

  2. Jalankan az vm create untuk membuat komputer virtual.

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

Memahami bendera khusus hcl

Azure Export for Terraform mendukung bendera - --hcl-only - yang menyebabkan pembuatan file berikut dari sumber daya yang diekspor:

  • File HCL yang dihasilkan .tf .
  • File pemetaan aztfexportResourceMapping.json.
  • Sumber daya yang dilewati tercantum dalam aztfexportSkippedResources.txt.

Bendera --hcl-only didukung untuk semua perintah ekspor utama yang digunakan untuk mengekspor:

  • sumber daya
  • grup sumber daya
  • pertanyaan
  • file pemetaan

Untuk melihat perintah Azure Export for Terraform yang tersedia, jalankan perintah berikut:

aztfexport --help

Bendera --hcl-only berguna dalam skenario di mana Anda tidak memerlukan status atau tidak yakin apakah Anda perlu membuat status. Untuk mengekspor semua konfigurasi yang dihasilkan ke status, jalankan aztfexport mapping-file.

Tip

Saat menggunakan --hcl-only bendera, targetkan direktori kosong untuk menghindari perubahan yang tidak diinginkan pada status saat ini selama tahap ekspor.

Mengekspor sumber daya Azure

Anda dapat menjalankan alat dalam aztfexport salah satu dari dua mode: interaktif dan non-interaktif. Untuk demo ini, Anda menggunakan mode non-interaktif.

  1. Buat direktori untuk diuji.

  2. Buka prompt perintah dan navigasikan ke direktori baru.

  3. Jalankan aztfexport resource-group untuk mengekspor grup sumber daya bernama myResourceGroup.

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

Catatan

Menjalankan Azure Export for Terraform dapat memakan waktu beberapa menit untuk diselesaikan.

Memverifikasi hasil

Setelah alat selesai mengekspor sumber daya Azure Anda, verifikasi file berikut di direktori tempat Anda menjalankan Azure Export for Terraform:

  • main.tf berisi kode HCL yang menentukan sumber daya yang diekspor.
  • aztfexportResourceMapping.json berisi pemetaan Azure/Terraform. File pemetaan mencakup informasi berikut untuk setiap sumber daya Azure yang diekspor: ID sumber daya Azure, jenis sumber daya Terraform, dan nama sumber daya Terraform. Konten file pemetaan mencerminkan apa yang ditampilkan Azure Export for Terraform selama proses ekspor.
  • aztfexportSkippedResources.txt berisi daftar sumber daya yang dilewati. Anda tidak akan melihat file ini untuk contoh ini.

Membersihkan sumber daya

Saat Anda tidak lagi memerlukan sumber daya yang dibuat dalam artikel ini, lakukan langkah-langkah berikut:

  1. Navigasi ke direktori yang berisi file Terraform Anda untuk artikel ini.

  2. Jalankan pemusnahan terraform.

    terraform destroy

Langkah berikutnya

Cara kerja Azure Export for Terraform