Men-debug Konfigurasi Terraform

Bahkan pengembang berpengalaman pun menghadapi masalah! Debugging adalah proses menemukan dan memperbaiki masalah dalam kode Anda. Dalam Terraform, ini berarti mengidentifikasi alasan infrastruktur Anda tidak diterapkan sesuai harapan atau alasan Anda melihat kesalahan.

Dalam pelajaran ini, Anda akan mempelajari teknik praktis untuk mendiagnosis dan mengatasi masalah konfigurasi Terraform yang umum, sehingga Anda menjadi engineer IaC yang lebih efektif.

Kesalahan Terraform sering kali dapat dikelompokkan ke dalam beberapa kategori:

• Kesalahan Sintaks: Kesalahan pengetikan, tanda kurung yang hilang, atau struktur HCL (HashiCorp Configuration Language) yang salah.
• Kesalahan Konfigurasi: Nilai yang tidak valid, argumen wajib yang hilang, atau referensi sumber daya yang salah.
• Kesalahan Penyedia: Masalah autentikasi, izin API, atau batas laju saat Terraform berkomunikasi dengan penyedia cloud Anda.
• Ketidakcocokan Status: Perbedaan antara konfigurasi Anda, file status Anda, dan infrastruktur sebenarnya.

Garis pertahanan pertama terhadap kesalahan adalah perintah terraform validate. Perintah ini memeriksa validitas sintaks dan konsistensi internal file konfigurasi Anda tanpa berinteraksi dengan layanan jarak jauh.

Perintah ini sangat penting untuk menemukan kesalahan sederhana bahkan sebelum Anda mencoba merencanakan atau menerapkan perubahan. Perintah ini memastikan kode HCL Anda memiliki struktur yang benar. Perhatikan } yang hilang di akhir blok tags di bawah ini. terraform validate akan langsung menandainya.

Setelah memvalidasi sintaks, terraform plan menampilkan dengan tepat perubahan yang diusulkan Terraform pada infrastruktur Anda. Ini adalah "uji coba" yang membantu Anda menemukan kesalahan logika atau modifikasi yang tidak diinginkan.

Perhatikan baik-baik sumber daya yang ditandai untuk dibuat, diubah, atau dihancurkan. Jalankan terraform plan dengan konfigurasi ini. Hasilnya akan menunjukkan bahwa satu sumber daya (aws_s3_bucket.example_bucket) akan dibuat. Output ini membantu Anda memastikan bahwa Terraform memahami maksud Anda dengan benar.

Jika validate dan plan tidak mengungkapkan informasi yang cukup, pencatatan verbos adalah pilihan terbaik Anda. Dengan menetapkan variabel lingkungan TF_LOG, Anda dapat meminta Terraform menampilkan informasi yang jauh lebih terperinci tentang operasinya.

Hal ini sangat berguna untuk men-debug interaksi penyedia yang kompleks atau masalah modul. Tingkat pencatatan berkisar dari TRACE (paling verbos) hingga ERROR (paling tidak verbos). Cobalah menjalankannya di terminal Anda. Anda akan melihat banyak informasi terperinci, termasuk panggilan API, respons, dan langkah-langkah pemrosesan internal.

Perintah terraform console menyediakan shell interaktif tempat Anda dapat mengevaluasi ekspresi, menguji fungsi, dan memeriksa nilai dari konfigurasi serta status Anda secara langsung.

Perintah ini sangat cocok untuk memverifikasi penetapan variabel, memeriksa logika kondisional, atau memahami cara ekspresi kompleks diselesaikan tanpa perlu menjalankan plan atau apply secara penuh. Setelah menyimpan ini ke dalam .tf file dan menjalankan terraform init, Anda dapat membuka konsol dan mengetikkan ekspresi seperti:

Dengan demikian, Anda dapat memeriksa dengan cepat cara nilai diproses.

File status Terraform (terraform.tfstate) sangat penting karena memetakan konfigurasi Anda ke infrastruktur dunia nyata. Jika status Anda tidak sinkron atau rusak, hal ini dapat menyebabkan perilaku yang tidak terduga.

Perintah terraform state show <resource_address> memungkinkan Anda memeriksa atribut persis suatu sumber daya sebagaimana tercatat dalam file status. Hal ini membantu memverifikasi apakah Terraform benar-benar menganggap sumber daya tersebut ada dan apa saja propertinya. Perintah ini akan menampilkan semua atribut sumber daya my_bucket dari file status Anda.

Banyak masalah berasal dari cara Terraform berinteraksi dengan penyedia cloud Anda. Kesalahan penyedia yang umum meliputi:

• Kegagalan Autentikasi: Kunci API yang salah, kredensial kedaluwarsa, atau peran yang salah dikonfigurasi.
• Izin Ditolak: Pengguna/peran IAM Anda tidak memiliki izin yang diperlukan untuk membuat atau mengubah sumber daya.
• Pembatasan Laju API: Terlalu banyak permintaan ke API penyedia dalam waktu singkat.
• Wilayah/Titik Akhir Tidak Valid: Mencoba menerapkan ke wilayah tempat suatu layanan tidak tersedia atau terdapat kesalahan pengetikan pada nama wilayah.

Ingatlah untuk menggunakan TF_LOG=TRACE guna melihat permintaan dan respons API yang sebenarnya, yang sangat berharga dalam situasi ini.

Saat menangani konfigurasi besar atau modular, proses debugging dapat menjadi rumit. Berikut beberapa strateginya:

• Isolasi: Jadikan bagian-bagian konfigurasi Anda sebagai komentar untuk mempersempit area masalah.
• Sederhanakan: Buat konfigurasi minimal yang mereproduksi bug.
• Visualisasikan: Gunakan terraform graph untuk menghasilkan representasi visual dependensi sumber daya Anda. Hal ini dapat membantu memahami urutan operasi.
• Uraikan Modul: Jika sebuah modul menyebabkan masalah, cobalah menjalankannya secara langsung sebagai modul akar untuk melakukan debugging.

Manakah dari teknik debugging Terraform berikut yang membantu Anda mengevaluasi ekspresi dan nilai variabel secara interaktif tanpa menjalankan plan secara penuh?

Anda telah mempelajari teknik-teknik penting untuk men-debug konfigurasi Terraform! Kita telah membahas penggunaan terraform validate untuk sintaks, menganalisis output terraform plan, menyelidiki secara mendalam dengan TF_LOG, dan menguji secara interaktif dengan terraform console.

Ingatlah bahwa debugging adalah proses berulang. Mulailah dengan pemeriksaan sederhana, lalu gunakan alat yang lebih terperinci secara bertahap sesuai kebutuhan. Latih teknik-teknik ini dengan konfigurasi Anda sendiri agar semakin mahir!