Belajar OpenTofu - OpenTofu State Manipulation & Import Workflows

#Pendahuluan

Di episode 8 sebelumnya kita membahas advanced expressions, built-in functions, dan loops — bagaimana count, for_each, depends_on, lifecycle, serta for expressions dan ternary membuat HCL kalian dinamis dan ringkas. Tapi ada satu asumsi yang selama ini kita pegang diam-diam: semua infrastruktur dimulai dari nol oleh OpenTofu itu sendiri.

Realitas di lapangan hampir selalu berbeda. Ketika kalian bergabung dengan sebuah tim, sebagian besar infrastruktur sudah lebih dulu ada — dibangun lewat konsol AWS, dibuat oleh orang yang sudah pindah, atau bahkan hasil tooling lama. Mendeklarasikan ulang semua resource itu di HCL tidak cukup: OpenTofu akan melihat "dua versi" dan ingin menciptakan ulang semuanya. Mengerikan.

Di episode ini kita akan membahas state manipulation & import workflows — cara membawa infrastruktur eksisting masuk ke dalam state OpenTofu tanpa merusaknya, lalu melakukan refactoring kode tanpa destroy memakai moved block dan perintah tofu state. Dengan bekal ini, kalian bisa mengadopsi IaC untuk sistem yang sudah berjalan puluhan bulan.

#Pembahasan Utama

#Mengimpor Infrastruktur Eksisting

Mengimpor artinya memberi tahu OpenTofu: "resource ini sudah ada di cloud dengan ID tertentu, jangan buat baru — catat saja ke state". Setelah itu, tofu plan memperlakukan resource sebagai bagian dari konfigurasi dan menghitung perbedaan menuju kondisi yang dideklarasikan.

Ada dua cara: CLI imperatif dan block deklaratif. Cara CLI langsung dan satu perintah:

tofu import aws_s3_bucket.data produksi-data-bucket

Cara deklaratif lebih disukai untuk produksi karena tercatat di kode dan bisa di-review di pull request:

import {
  to = aws_s3_bucket.data
  id = "produksi-data-bucket"
}

Setelah block import ditulis, jalankan tofu plan untuk melihat perubahan yang akan terjadi, lalu tofu apply untuk merekam resource ke state. Idempoten dan dapat diulang — inilah keunggulan pendekatan deklaratif dibanding mengetik perintah CLI di terminal.

#Refactoring Tanpa Destroy: Block moved

Setelah infrastruktur diadopsi, kebutuhan refactoring hampir pasti datang: mengganti nama resource, memindahkan resource ke dalam modul, atau menata ulang struktur. Jika kalian hanya mengubah nama di kode, OpenTofu akan menawarkan destroy lalu create — mematikan resource lama dan membuat yang baru. Untuk resource tanpa data, mungkin oke; untuk database dan instance produksi, itu bencana.

Block moved menyelesaikannya dengan memberi tahu OpenTofu bahwa alamat baru hanyalah hasil perubahan penamaan, bukan resource baru:

moved {
  from = aws_instance.web
  to   = aws_instance.web_server
}
 
moved {
  from = aws_instance.web_server
  to   = module.web.aws_instance.web
}

Contoh pertama memindahkan alamat antar nama resource; contoh kedua menunjukkan pemindahan resource ke dalam modul. Setelah block moved ditambahkan, tofu plan tidak lagi menampilkan destroy — yang muncul hanyalah baris yang memberitahu bahwa state dipindahkan.

#Manipulasi State Langsung: tofu state

Untuk perubahan state yang bersifat satu kali atau diagnostik, OpenTofu menyediakan subcommand tofu state. Empat yang paling sering dipakai:

tofu state list
tofu state show aws_instance.web_server
tofu state mv aws_instance.web_server aws_instance.web
tofu state rm aws_instance.bekas

• tofu state list menampilkan semua alamat resource yang tercatat.
• tofu state show memerinci atribut satu resource — berguna saat memverifikasi hasil import.
• tofu state mv memindahkan entri state — alternatif cepat untuk moved block saat perubahan bersifat ad-hoc.
• tofu state rm menghapus entri dari state.

Perbedaan mendasar moved block vs tofu state mv: moved adalah bagian dari konfigurasi, terekam di Git, dan diproses otomatis setiap kali kalian menjalankan tofu plan atau tofu apply; tofu state mv adalah operasi sekali jalan di mesin yang menjalankannya — anggota tim lain harus melakukannya juga atau menerima moved di kemudian hari.

#Alur Praktis Adopsi & Refactor

Berikut urutan yang aman untuk mengadopsi infrastruktur warisan:

1. Tulis definisi resource di main.tf dengan atribut yang sesuai kondisi nyata.
2. Tambahkan block import di import.tf untuk setiap resource.
3. Jalankan tofu init bila ada provider atau backend baru, lalu tofu plan.
4. Setelah rencana terlihat benar, jalankan tofu apply untuk merekam state.
5. Untuk penataan ulang, tambahkan block moved dan biarkan beberapa siklus sebelum membersihkannya.
6. Verifikasi dengan tofu state list bahwa setiap resource berada di alamat yang diharapkan.

#Penutup

Pada episode 9 ini kita menguasai pengelolaan state dan alur import:

• import block (deklaratif) dan tofu import (CLI) membawa infrastruktur eksisting masuk ke state tanpa destroy.
• Block moved melakukan refactoring penamaan dan pemindahan ke modul tanpa recreate.
• tofu state list, show, mv, dan rm untuk diagnostik dan manipulasi state satu kali.
• Alur adopsi bertahap — definisikan, import, plan, apply, refactor, verifikasi.

Kemampuan ini membuat OpenTofu aman diterapkan pada sistem produksi yang sudah berjalan lama. Di episode 10 selanjutnya kita akan membahas Reusable Modules & OpenTofu Registry — membungkus infrastruktur menjadi modul yang bisa dipakai ulang dengan struktur main.tf, variables.tf, dan outputs.tf, lalu mengkonsumsinya dari registry, Git, atau local path. Sampai jumpa!