aztfexport

Ekspor Microsoft Azure untuk Terraform

Alat untuk membawa sumber daya Azure Anda yang ada di bawah pengelolaan Terraform.

Video (v0.12.0)

Sasaran

Azure Ekspor untuk Terraform mengekspor sumber daya yang didukung ke status Terraform dan menghasilkan konfigurasi Terraform yang sesuai. Status dan konfigurasi Terraform diharapkan konsisten dengan status jarak jauh sumber daya, yaitu terraform plan tidak menunjukkan perbedaan. Pengguna kemudian dapat menggunakan Terraform untuk mengelola sumber daya ini.

Ini mendukung penyedia Terraform AzureRM dan penyedia Terraform AzAPI.

Bukan Tujuan

Konfigurasi Terraform yang dihasilkan oleh aztfexport tidak dimaksudkan untuk komprehensif dan tidak memastikan bahwa infrastruktur dapat sepenuhnya direproduksi dari konfigurasi yang dihasilkan tersebut. Untuk detailnya, silakan lihat batasan).

Memasang

Dari Rilis

Biner yang telah dikompilasi dan Window MSI tersedia di Rilis.

Dari rantai alat Go

go install github.com/Azure/aztfexport@latest

Dari Manajer Paket

jendela

winget install aztfexport

Minuman rumahan (Linux/macOS)

brew install aztfexport

dnf (Linux)

Versi yang didukung:

• RHEL 8 (amd64, lengan64)
• RHEL 9 (amd64, lengan64)

1. Impor kunci repositori Microsoft:

    rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

2. Tambahkan repositori packages-microsoft-com-prod :

    ver=8 # or 9
   dnf install -y https://packages.microsoft.com/config/rhel/${ver}/packages-microsoft-prod.rpm
   

3. Memasang:

    dnf install aztfexport
   

tepat (Linux)

Versi yang didukung:

• Ubuntu 20.04 (amd64, arm64)
• Ubuntu 22.04 (amd64, arm64)

1. Impor kunci repositori Microsoft:

    curl -sSL https://packages.microsoft.com/keys/microsoft.asc > /etc/apt/trusted.gpg.d/microsoft.asc
   

2. Tambahkan repositori packages-microsoft-com-prod :

    ver=20.04 # or 22.04
   apt-add-repository https://packages.microsoft.com/ubuntu/${ver}/prod
   

3. Memasang:

    apt-get install aztfexport
   

AUR (Linux)

yay -S aztfexport

Prasyarat

aztfexport memerlukan terraform executable yang diinstal di $PATH dengan versi >= v0.12 .

Cara Kerjanya

aztfexport memanfaatkan aztft untuk mengidentifikasi jenis sumber daya Terraform yang sesuai dengan ID sumber daya Azure. Kemudian ia menjalankan terraform import untuk mengimpor setiap sumber daya. Setelah itu, tfadd dijalankan untuk menghasilkan kode Terraform HCL untuk setiap sumber daya yang diimpor.

Penggunaan

Baca dokumentasi Azure Ekspor yang mencakup skenario dan penggunaan.

Konfigurasi

aztfexport akan membuat file konfigurasi di $HOME/.aztfexport/config.json . File ini bertujuan untuk dikelola dengan perintah aztfexport config [subcommand] , yang mencakup subperintah berikut:

• get : Dapatkan item konfigurasi
• set : Menyetel item konfigurasi
• show : Menampilkan konfigurasi lengkap

Saat ini, item konfigurasi berikut didukung:

• installation_id : UUID yang dibuat saat pertama kali dijalankan. Jika ada Azure CLI atau Azure Powershell yang diinstal pada mesin saat ini, UUID akan memiliki nilai yang sama di antara alat-alat ini. Jika tidak, yang baru akan dibuat. Ini digunakan sebagai pengidentifikasi dalam jejak telemetri.
• telemetry_enabled : Mengaktifkan telemetri. Kami menggunakan telemetri untuk mengidentifikasi masalah dan area yang perlu ditingkatkan, guna mengoptimalkan alat ini untuk kinerja, keandalan, dan pengalaman pengguna yang lebih baik. Jika Anda ingin menonaktifkan telemetri kami, setel ini ke false.

Keterbatasan

Kunjungi halaman ini di dokumentasi Azure Ekspor untuk Terraform yang membahas batasan alat yang diketahui saat ini.

Sumber Daya Tambahan

• Halaman Github aztfexport: Segala sesuatu tentang aztfexport, termasuk perbandingan dengan solusi impor lain yang ada.
• aztft: Program dan pustaka Go untuk mengidentifikasi jenis sumber daya penyedia Terraform AzureRM yang benar pada id sumber daya Azure.
• tfadd: Program dan pustaka Go untuk menghasilkan konfigurasi Terraform dari status Terraform.