Proxmox : Praktikum Pabrik VM Cloud-Init (Verifikasi Identitas dan Diagnosa Clone Tanpa Jaringan)

🎯 Tujuan

Artikel pagi menjelaskan bahwa template adalah cetakan, dan cloud-init adalah surat perintah yang dibaca sekali saat VM pertama kali bangun. Sekarang kita buktikan keduanya benar-benar bekerja.

Setelah praktik ini, kamu bisa:

  • membuat template dari cloud image resmi Debian, bukan dari instalasi manual;
  • mencetak tiga VM dari satu template, masing-masing dengan nama, alamat, dan kunci sendiri;
  • membuktikan identitas VM lewat lima lapis bukti, bukan dari perasaan "sepertinya sudah benar";
  • mendiagnosa clone yang menyala tapi tidak muncul di jaringan, dalam hitungan menit.

Semua angka di artikel ini adalah keluaran nyata dari lab Proxmox VE 8.4.21, bukan perkiraan.

πŸ“ Konteks nyata

Bayangkan lab TKJ dengan 30 PC. Guru perlu 30 VM Linux untuk ujian praktik, satu VM per siswa. Kalau tiap VM diinstal manual, satu kelas butuh dua hari kerja dan hasilnya tetap tidak seragam.

Template menyelesaikan bagian "seragam". Tapi seragam saja tidak cukup: setiap VM harus punya nama sendiri, alamat sendiri, dan kunci sendiri. Di situlah cloud-init bekerja, dan di situ juga kesalahan paling mahal terjadi.

  • πŸ”₯ Kasus nyata: di lab yang kami pakai untuk artikel ini, dua clone diberi alamat yang sama. Hasilnya bukan "salah satu agak lambat", tapi delapan kali percobaan SSH ke alamat itu semuanya masuk ke VM yang sama. VM satunya lenyap dari jaringan tanpa pesan error apa pun. Di kelas, ini berarti siswa A melihat berkas siswa B dan tidak ada yang tahu sejak kapan.
  • ⚠️ Hati-hati: clone yang lupa diberi alamat tidak langsung mati. Ia menyala, lalu berhenti di layar "A start job is running for systemd-networkd-wait-online" selama lebih dari satu setengah menit, dan setelah itu tetap tidak punya alamat. Guru yang tidak tahu gejala ini akan menyimpulkan "VM-nya rusak" dan menginstal ulang.

Analogi yang paling dekat: pabrik sepatu. Cetakan boleh sama, tapi label ukuran dan nomor seri wajib berbeda. Kalau dua kotak berlabel sama, gudang tetap rapi secara tampilan, tetapi pengiriman akan salah alamat.

🧠 Konsep singkat

πŸ”Ή Tiga baris identitas

Satu VM hasil clone disebut "benar" kalau tiga hal ini cocok dengan rencanamu. Ketiganya disuntik dari luar, bukan diketik di dalam VM.

Yang menentukan Diisi lewat Kalau kosong
Nama host --name saat clone hostname tetap nama template
Alamat IP dan gateway --ipconfig0 tidak ada alamat sama sekali
Kunci SSH --sshkey tidak ada cara masuk
  • πŸ“Š Angka penting: surat perintah itu dikirim sebagai CD kecil berlabel CIDATA, dipasang di ide2. Isinya hanya beberapa kilobyte teks. Tidak ada koneksi jaringan ke hypervisor, tidak ada agen yang harus hidup lebih dulu.

πŸ”Ή Lima lapis bukti, berhenti di lapis pertama yang gagal

Ini kebiasaan yang membedakan admin rapi dari admin yang menebak. Periksa berurutan, jangan lompat.

Lapis Pertanyaan Alat bukti
1. Hidup apakah prosesnya jalan? qm status
2. Surat apakah CD cloud-init terpasang dan isinya benar? qm config, qm cloudinit dump
3. Dibaca apakah cloud-init selesai di dalam VM? cloud-init status --long
4. Menempel apakah nama, IP, dan DNS sudah benar? hostname, ip -4 addr, /etc/resolv.conf
5. Menjawab apakah VM bisa dihubungi dari luar? ping, ssh, arping -D

Kalau lapis 1 gagal, jangan periksa DNS. Kalau lapis 3 belum done, jangan menyalahkan jaringan. Satu lapis satu kesimpulan.

πŸ”Ή Kenapa boot bisa menggantung tanpa alamat

Cloud image Debian memakai systemd-networkd. Sebelum layanan lain jalan, ada unit systemd-networkd-wait-online yang menunggu semua antarmuka "selesai dikonfigurasi atau gagal".

Link yang tidak punya konfigurasi bukan "gagal" β€” ia hanya belum selesai. Jadi unit itu menunggu, dan menunggu, tanpa batas.

  • πŸ§ͺ Uji cepat: di dalam VM yang sehat, jalankan systemctl show systemd-networkd-wait-online -p TimeoutStartUSec --value. Di image Debian 12 hasilnya infinity. Artinya: kalau tidak ada yang memberi alamat, boot tidak akan pernah lanjut sendiri.

🧩 Istilah penting

  • Cloud image β€” berkas disk siap pakai dari pembuat distro, sudah berisi cloud-init. Ukurannya jauh lebih kecil dari ISO installer karena tanpa paket desktop.
  • Seed / CIDATA β€” CD kecil berisi user-data dan meta-data. Cloud-init membacanya lewat datasource NoCloud.
  • NoCloud β€” datasource yang mencari konfigurasi di CD berlabel CIDATA atau di URL seedfrom, tanpa perlu layanan metadata seperti di cloud publik.
  • dsmode β€” mode NoCloud. Nilai net berarti sumbernya bukan jaringan, melainkan media lokal.
  • instance-id β€” nomor identitas satu instance. Cloud-init memakai ini untuk memutuskan "ini boot pertama atau bukan".
  • ipconfig0 β€” properti Proxmox untuk alamat IP dan gateway NIC pertama pada surat cloud-init.
  • ciuser β€” nama user awal yang dibuat cloud-init saat boot pertama.
  • ciupgrade β€” izin cloud-init menjalankan pembaruan paket saat boot. Nilai 0 mematikannya.
  • Full clone β€” salinan disk utuh; mandiri, tapi makan ruang.
  • Linked clone β€” salinan yang menumpang pada disk template; cepat dan hemat, tapi bergantung pada template.
  • Thin pool β€” kumpulan ruang disk yang dialokasikan sesuai pemakaian. Bisa "menjanjikan" lebih besar dari kapasitas nyata.
  • ARP β€” protokol yang menerjemahkan alamat IP ke alamat MAC di satu jaringan lokal.
  • DAD β€” duplicate address detection, pemeriksaan apakah sebuah alamat IP sudah dipakai pihak lain.
  • Guest agent β€” layanan kecil di dalam VM untuk komunikasi dengan hypervisor. Tidak semua image membawanya.

πŸ”§ Praktik: pabrik tiga VM beridentitas

Praktik ini memakai VM uji 9020 sampai 9024 dan satu jembatan vmbr0. Jangan jalankan pada host produksi tanpa snapshot dan tanpa jadwal.

πŸ”Ή Langkah 1 β€” Siapkan image dan peta alamat

Unduh cloud image resmi, catat sidiknya, lalu pastikan alamat yang akan kamu pakai memang kosong.

cd /var/lib/vz/template/iso
curl -sLO https://cloud.debian.org/images/cloud/bookworm/latest/debian-12-genericcloud-amd64.qcow2
sha256sum debian-12-genericcloud-amd64.qcow2

for i in 231 232 233; do
  ping -c1 -W1 192.168.100.$i >/dev/null 2>&1 \
    && echo ".$i TERPAKAI" || echo ".$i bebas"
done

Keluaran lab:

335M debian-12-genericcloud-amd64.qcow2
b94ebc662796cbd4fd1f5053ce63b59ebc56e034f8f550689713c0cae493310e
.231 bebas
.232 bebas
.233 bebas
  • πŸ’‘ Tips: simpan hasil sha256sum di lembar kerja. Enam bulan lagi kamu akan lupa image mana yang dipakai template, dan sidik ini jawabannya.

πŸ”Ή Langkah 2 β€” Buat cangkang, impor disk, lebarkan

Cloud image Debian hanya 3 GiB. Terlalu sempit untuk aplikasi, dan aplikasi akan penuh di tengah ujian.

qm create 9020 --name tpl-debian12 --memory 1024 --cores 1 \
  --net0 virtio,bridge=vmbr0 --scsihw virtio-scsi-pci --ostype l26

time qm set 9020 --scsi0 local-lvm:0,import-from=/var/lib/vz/template/iso/debian-12-genericcloud-amd64.qcow2
qm resize 9020 scsi0 8G

Keluaran lab: impor selesai dalam real 0m2.577s untuk disk virtual 3 GiB, lalu qm resize mengubahnya dari 3,00 GiB menjadi 8,00 GiB.

  • ⚠️ Hati-hati: qm resize hanya membesarkan disk dari sisi hypervisor. Partisi dan filesystem di dalam image tetap 3 GiB sampai kamu menjalankan growpart dan resize2fs. Periksa dengan df -h /, jangan dengan qm config.

πŸ”Ή Langkah 3 β€” Pasang CD cloud-init dan konsol serial

qm set 9020 --ide2 local-lvm:cloudinit --serial0 socket --vga serial0 \
  --boot order=scsi0 --agent enabled=1

qm config 9020 | grep -E "^(ide2|serial0|vga|boot)"

--boot order=scsi0 membuat BIOS langsung boot dari disk, tidak sempat menguji CD. --vga serial0 memakai konsol teks sebagai layar, karena cloud image biasanya tidak membawa driver grafis lengkap.

πŸ”Ή Langkah 4 β€” Isi identitas dasar di template

Template sebaiknya lahir tanpa alamat. Isi hanya yang aman untuk semua salinan.

ssh-keygen -t ed25519 -N "" -C "tpl-lab-debian12" -f /root/.ssh/tpl-lab

qm set 9020 --ciuser praktikan --sshkey /root/.ssh/tpl-lab.pub --ciupgrade 0

qm cloudinit dump 9020 network

Keluaran nyata sebelum ipconfig0 diisi:

version: 1
config:
    - type: nameserver
      address:
      - '8.8.8.8'
      search:
      - 'novysan.local'

Perhatikan: tidak ada satu pun alamat IP di situ. Yang muncul justru DNS dan domain pencarian milik host. Artinya sederhana dan penting: kalau kamu tidak menentukan, host yang menentukan.

  • πŸ“Š Angka penting: 8.8.8.8 dan novysan.local bukan diketik di artikel ini. Itu nilai bawaan host lab yang ikut tersuntik. Di jaringan sekolah, DNS seperti ini bisa membuat VM tidak bisa menghubungi server nilai yang ada di LAN.

πŸ”Ή Langkah 5 β€” Jadikan template

qm template 9020
qm config 9020 | grep -E "^(template|scsi0)"

Keluaran lab: disk berganti nama dari vm-9020-disk-0 menjadi base-9020-disk-0, dan muncul template: 1. Sejak detik itu template tidak bisa dinyalakan β€” itu tanda berhasil.

πŸ”Ή Langkah 6 β€” Cetak clone, beri identitas masing-masing

Satu perintah clone, satu perintah identitas. Jangan pernah menyalakan clone sebelum kedua perintah ini selesai.

qm clone 9020 9021 --name siswa-a --full
qm set 9021 --ipconfig0 ip=192.168.100.231/24,gw=192.168.100.1 --nameserver 192.168.100.1

qm clone 9020 9022 --name siswa-b --full
qm set 9022 --ipconfig0 ip=192.168.100.232/24,gw=192.168.100.1 --nameserver 192.168.100.1

Clone penuh 8 GiB selesai dalam real 0m4.014s di lab ini. Bandingkan dengan dua hari instalasi manual per kelas.

  • πŸ’‘ Tips: tulis daftar clone di satu berkas teks lebih dulu (nomor VM, nama, IP), lalu jalankan baris demi baris. Pabrik yang baik selalu punya daftar produksi, bukan ingatan.

πŸ”Ή Langkah 7 β€” Bukti lapis 1 sampai 3

qm start 9021; qm start 9022
sleep 30
qm list | grep -E "9021|9022"
ping -c2 192.168.100.231
ssh -i /root/.ssh/tpl-lab praktikan@192.168.100.231 hostname

Keluaran lab: kedua VM running, ping 0% loss dengan waktu sekitar 0,3 ms, dan SSH mengembalikan siswa-a. Lapis 1 sampai 3 lolos.

πŸ”Ή Langkah 8 β€” Bukti lapis 4 dan 5, dari dalam VM

ssh -i /root/.ssh/tpl-lab praktikan@192.168.100.232 "
  hostname -f
  ip -4 -br addr show
  ip route | head -2
  cat /etc/resolv.conf | grep -v '^#'
  cloud-init status --long
"

Keluaran nyata dari siswa-b:

siswa-b
eth0    UP    192.168.100.232/24
default via 192.168.100.1 dev eth0 proto static
nameserver 192.168.100.1
search novysan.local
status: done
DataSourceNoCloud [seed=/dev/sr0][dsmode=net]

Baris terakhir itu bukti paling kuat: cloud-init benar-benar membaca CD di /dev/sr0, bukan menebak, bukan mengambil dari jaringan. Lapis 4 dan 5 lolos tanpa satu pun perintah di dalam VM.

  • πŸ§ͺ Uji cepat: cloud-init status --long yang menjawab status: done berarti tidak ada modul yang gagal. Kalau muncul status: error, jangan lanjut ke DNS β€” baca /var/log/cloud-init.log dulu.

πŸ”Ή Langkah 9 β€” Sengaja rusak: dua kegagalan yang paling sering terjadi

Praktik yang baik menyertakan cara gagal. Dua eksperimen berikut kami jalankan di lab yang sama.

Eksperimen A β€” clone tanpa alamat.

qm clone 9020 9023 --name siswa-c --full
qm start 9023

qm config 9023 tidak menampilkan ipconfig0 sama sekali, dan qm cloudinit dump 9023 network hanya berisi blok nameserver. Di konsol serial, VM berhenti di:

Job systemd-networkd-wait-online.se...tart running (1min 33s / no limit)

Sesudah lebih dari dua menit: tetap tidak ada alamat, guest agent tidak menjawab, dan tabel MAC di bridge kosong. tcpdump selama 25 detik menangkap nol paket dari VM itu. VM hidup, tapi tidak ada di jaringan.

Eksperimen B β€” dua clone satu alamat.

qm clone 9020 9024 --name siswa-d --full
qm set 9024 --ipconfig0 ip=192.168.100.231/24,gw=192.168.100.1
qm start 9024
sleep 35

for i in $(seq 8); do
  ssh -i /root/.ssh/tpl-lab -o ConnectTimeout=4 praktikan@192.168.100.231 hostname
done
arping -D -c 4 -I vmbr0 192.168.100.231; echo "exit=$?"

Keluaran lab: delapan dari delapan percobaan menjawab siswa-d, bukan siswa-a. arping -D keluar dengan exit=1, tanda alamat itu dipakai lebih dari satu MAC.

Dari sudut pandang siswa-b, alamat 192.168.100.231 kini menunjuk MAC bc:24:11:70:27:0d milik siswa-d. siswa-a tidak error, tidak mati, hanya tidak pernah dipilih lagi.

  • πŸ”₯ Kasus nyata: pola ini yang membuat satu siswa bisa masuk ke VM siswa lain tanpa sadar. Keduanya memakai kunci yang sama dari template, jadi login berhasil dan tidak ada peringatan. Yang akhirnya terlihat hanya "tugas saya berubah sendiri".

πŸ”Ή Langkah 10 β€” Bersihkan barang uji

for v in 9021 9022 9023 9024 9020; do
  qm stop $v --skiplock 2>/dev/null
  qm destroy $v --purge 2>/dev/null
done
qm list

Kebiasaan ini yang membedakan lab rapi dari lab berisi VM "sementara" berumur dua tahun. Di lab kami, daftar VM kembali seperti semula: lima VM yang memang berjalan.

🏭 Dipakai di dunia kerja

  • Sekolah dan lab praktikum: satu template per mata pelajaran, clone per siswa. Guru berhenti menjadi tukang instal dan mulai mendampingi; yang perlu dijaga hanya peta alamat, bukan 30 installer.
  • Kantor dan UMKM: server kecil untuk kasir, absensi, atau pencatatan stok di tiap cabang. Template memastikan semua cabang memakai versi sistem yang sama, sehingga masalah tidak bergantung pada ingatan siapa yang menginstal.
  • Hosting dan penyedia VPS: pelanggan baru dilayani dalam hitungan detik. Yang dijual bukan keajaiban, melainkan cetakan yang sudah diuji dan surat perintah yang sudah benar.
  • Klinik dan puskesmas: aplikasi rekam medis dipasang di banyak titik. Template memisahkan "sistem dasar" dari "data pasien", asalkan alamat dan kunci tiap titik berbeda β€” dan itu justru bagian yang paling sering lupa.
  • Industri dan OT: lingkungan uji harus bisa dibuat ulang persis seperti produksi. Template menjadi dokumentasi konfigurasi yang biasanya hanya ada di kepala satu orang.
  • Tim platform internal: mesin build, runner CI, dan lingkungan review dibuat dari template yang sama. Kalau satu runner bermasalah, cukup dibuang dan dicetak ulang, bukan diperbaiki berjam-jam.

βœ… Verifikasi

Jalankan berurutan. Berhenti di baris pertama yang tidak sesuai.

Yang diperiksa Perintah Hasil yang benar
Template terkunci qm config 9020 ada template: 1
Surat terpasang qm config 9021 ada ide2 dan ipconfig0
Isi surat qm cloudinit dump 9021 user hostname, user, kunci SSH
Alamat di surat qm cloudinit dump 9021 network IP, netmask, gateway, DNS
VM hidup qm status 9021 status: running
cloud-init selesai cloud-init status --long status: done
Identitas menempel hostname; ip -4 -br addr nama dan IP sesuai rencana
DNS benar grep nameserver /etc/resolv.conf DNS yang kamu tentukan
Tidak bentrok arping -D -c 4 -I vmbr0 192.168.100.231 exit=0
  • πŸ“Š Angka penting: arping -D mengembalikan 1 saat mendeteksi alamat ganda, dan 0 saat alamat benar-benar tunggal. Ini pemeriksaan termurah yang mencegah insiden paling mahal di lab clone.

⚠️ Kesalahan umum & troubleshooting

Gejala Penyebab Tindakan
Boot berhenti di wait-online lebih dari 90 detik clone tanpa ipconfig0 isi IP, nyalakan ulang
qm agent gagal padahal VM sehat image tanpa qemu-guest-agent pakai ping dan SSH sebagai bukti
SSH masuk ke VM yang salah dua clone satu alamat arping -D, perbaiki IP
Hostname masih nama template --name tidak dipakai set ulang lalu boot ulang
DNS menunjuk 8.8.8.8 --nameserver kosong isi DNS lokal
Perubahan IP tidak berlaku VM masih memakai surat lama qm cloudinit update lalu reboot
Linked clone error setelah template dihapus disk dasar hilang pakai full clone atau simpan template
clone gagal di tengah thin pool penuh cek pvesm status, hapus VM uji
Disk penuh di dalam VM resize belum diikuti growpart growpart + resize2fs
Konsol serial kosong qm terminal butuh TTY pakai SSH, atau terminal interaktif

πŸ”Ή Empat mitos yang perlu dibuang

  • "Clone berarti aman, karena otomatis terpisah." Tidak. Yang otomatis hanya disknya. Nama, alamat, dan kunci tetap tugasmu.
  • "Cloud-init selalu jalan setiap boot." Ia hanya mengulang tahap yang memang dirancang berulang. Perubahan user-data butuh instance-id baru atau cloud-init clean.
  • "Guest agent wajib hidup." Di image Debian cloud bawaan, paket itu bahkan tidak terpasang. VM tetap sehat; yang salah adalah asumsi kita.
  • "IP cukup diatur di dalam VM." Boleh, tapi hasilnya tidak bisa dicetak ulang. Pabrik yang baik menaruh identitas di luar, satu tempat, satu daftar.

πŸ” Catatan keamanan & etika

  • Kunci SSH template adalah kunci produksi. Simpan di tempat berizin 600, jangan dibagikan lewat chat, dan cabut saat tidak dipakai lagi.
  • Jangan memakai --cipassword untuk kenyamanan. Proxmox menyimpan versi terenkripsinya di konfigurasi VM, dan siapa pun dengan akses ke sana bisa membacanya.
  • Peta alamat VM adalah dokumen internal. Ia memberi tahu orang luar mesin mana yang menjalankan apa.
  • VM siswa berisi tugas dan data pribadi. Perlakukan sebagai data pribadi sesuai UU 27/2022: akses minimum, retensi jelas, hapus saat kelas selesai.
  • Uji clone hanya di host latihan, dengan snapshot. Jangan pernah mengkloning VM produksi untuk "coba-coba" tanpa memisahkan jaringannya.
  • Hapus VM uji. VM yatim yang lupa dihapus adalah jalan masuk yang tidak tercatat di inventaris siapa pun.

πŸ“Œ Kesimpulan

Template menjawab pertanyaan "bagaimana membuat semuanya sama". Cloud-init menjawab pertanyaan yang lebih sulit: "bagaimana membuat masing-masing berbeda tanpa menyentuhnya satu per satu".

Kalau hanya satu hal yang kamu bawa pulang: periksa lima lapis berurutan, dan jangan pernah menyalakan clone sebelum alamatnya diisi. Satu baris --ipconfig0 yang terlupa bisa berubah menjadi dua VM yang berebut identitas.

Langkah berikutnya: buka topik container LXC, dan bandingkan berapa banyak dari pekerjaan di artikel ini yang hilang saat kamu tidak lagi memelihara sistem operasi sendiri.

πŸ”— Materi terkait

πŸ“š Referensi