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 hasilnyainfinity. 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-datadanmeta-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
netberarti 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
sha256sumdi 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 resizehanya membesarkan disk dari sisi hypervisor. Partisi dan filesystem di dalam image tetap 3 GiB sampai kamu menjalankangrowpartdanresize2fs. Periksa dengandf -h /, jangan denganqm 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.8dannovysan.localbukan 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 --longyang menjawabstatus: doneberarti tidak ada modul yang gagal. Kalau munculstatus: error, jangan lanjut ke DNS β baca/var/log/cloud-init.logdulu.
πΉ 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 -Dmengembalikan 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-idbaru ataucloud-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
--cipassworduntuk 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
- Proxmox : Template VM dan Cloud-Init β artikel konsep pagi ini; baca dulu kalau istilah cetakan dan surat perintah masih terasa asing.
- Proxmox: Bulk Snapshot dan Roll Back VM β menyelamatkan VM sebelum eksperimen clone.
- Linux : SSH Hardening Lanjutan β mengelola kunci yang dipakai cloud-init.
- Linux : Monitoring Server Dasar β memantau VM hasil cetakan setelah dipakai.
- PNET: Membuat File qcow2 dari VirtualBox β konteks format disk yang dipakai cloud image.
π Referensi
- Proxmox VE Wiki β Cloud-Init Support. Diakses 19 November 2026.
- Proxmox VE Wiki β VM Templates and Clones. Diakses 19 November 2026.
- Proxmox VE Documentation β qm(1) manual. Opsi
--ipconfig0,--ciuser,--sshkey,--ciupgrade. - cloud-init Documentation β NoCloud datasource. Media berlabel CIDATA,
instance-id,dsmode. - systemd Documentation β systemd-networkd-wait-online.service. Perilaku menunggu antarmuka.
- Debian Cloud Images β image Debian 12 genericcloud. Diakses 19 November 2026.