Perintah Terraform State Move
Perintah terraform state mv
adalah alat dalam ekosistem Terraform yang dirancang untuk mengelola status resource Anda. Perintah ini digunakan terutama untuk memperbarui atau memanipulasi status Terraform, menyelarasinya dengan perubahan yang dilakukan pada file konfigurasi.
Perintah ini umumnya digunakan ketika struktur logis infrastruktur Anda dalam file-file Terraform telah diperbarui. Misalnya, Anda mungkin ingin mengubah nama atau membangun kembali resource atau modul Anda, memindahkan resource dari satu modul ke modul lain, atau bahkan memindahkan resource antara status Terraform yang berbeda. Dalam kasus-kasus seperti ini, menjalankan terraform apply
biasa bisa berakhir dengan penghapusan dan pembuatan ulang resource, yang dapat merusak dan umumnya tidak diinginkan. Perintah terraform state mv
hadir untuk membantu dalam skenario ini, memungkinkan Anda memindahkan item status dengan aman tanpa memengaruhi resource nyata yang mereka wakili.
Syntax Terraform State Move
Perintah terraform state mv
memiliki sintaks yang sederhana. Perintah ini membutuhkan setidaknya dua argumen: alamat sumber dan alamat tujuan. Berikut adalah struktur dasar perintah:
$ terraform state mv [options] SOURCE DESTINATION
Baik SOURCE
maupun DESTINATION
mengacu pada alamat item dalam status Terraform Anda. Alamat ini dapat merujuk ke resource atau modul. Misalnya, jika Anda memiliki resource aws_instance
yang diberi nama example
, alamatnya dapat menjadi aws_instance.example
.
Perhatikan contoh ini di mana kita memindahkan resource dalam modul yang sama:
$ terraform state mv aws_instance.old aws_instance.new
Dalam perintah ini, kita mengubah nama aws_instance.old
menjadi aws_instance.new
.
Berikut adalah contoh lain di mana kita memindahkan resource dari satu modul ke modul lain:
$ terraform state mv module.old_module.aws_instance.example module.new_module.aws_instance.example
Dalam perintah ini, module.old_module.aws_instance.example
adalah alamat instansi saat ini, dan module.new_module.aws_instance.example
adalah alamat di mana instansi harus berada setelah perintah dijalankan.