Proxmox : Template VM dan Cloud-Init (Dari Instalasi Manual ke VM Siap Pakai)
π― Tujuan
Setelah membaca halaman ini, kamu bisa:
- Mengubah satu VM yang sudah beres dikonfigurasi menjadi template β cetakan yang tidak bisa dinyalakan, tapi bisa melahirkan VM baru tanpa installer.
- Memakai cloud-init supaya setiap salinan lahir dengan nama, kunci SSH, dan IP-nya sendiri.
- Membuktikan hasilnya dengan angka: berapa detik satu VM baru siap, dan apa yang gagal kalau kamu lupa satu langkah.
Ini bukan tutorial "klik clone lalu selesai". Ini soal tahu apa yang disuntikkan ke dalam VM saat pertama kali ia bangun, karena di situ 90% kesalahan terjadi.
π Konteks nyata
Bayangkan kamu punya cetakan kue. Adonan tetap perlu dibuat sekali, tapi 30 kue berikutnya cukup dicetak, dipanggang, selesai. Yang mahal itu bikin adonan, bukan mencetak.
VM juga begitu. Instalasi Ubuntu dari ISO butuh 20β30 menit: pilih bahasa, partisi, buat user, tunggu reboot, pasang paket. Kalau lab sekolah butuh 32 VM untuk praktikum, cara manual berarti 16 jam kerja untuk pekerjaan yang isinya sama persis.
Template memindahkan pekerjaan itu ke depan, sekali saja. Setelah cetakannya ada, satu VM baru lahir dalam hitungan detik. Yang tersisa cuma tiga hal yang memang harus beda per VM: namanya, kuncinya, dan alamat IP-nya. Itulah tugas cloud-init.
- π₯ Kasus nyata: di sebuah SMK, guru produktif TKJ menyiapkan 32 VM Ubuntu untuk ujian praktik. Ia memasang satu per satu dari ISO karena "biar seragam". Hari pertama 11 VM selesai, hari kedua 14, hari ketiga 7 VM terakhir β dan dua VM di antaranya salah partisi. Ujian mundur satu hari. Setelah memakai template, kelas berikutnya siap dalam 40 menit, termasuk waktu menyalin daftar IP ke lembar kerja siswa.
π§ Konsep singkat
πΉ Template bukan VM yang dimatikan
VM biasa yang kamu matikan masih bisa dinyalakan. Template tidak. Begitu diubah, Proxmox menandainya dengan flag khusus, ikonnya berubah, dan perintah menyalakannya langsung ditolak.
you can't start a vm if it's a template
Kalimat di atas bukan error yang perlu diperbaiki β itu memang aturan mainnya. Template adalah cetakan, bukan mesin. Kalau kamu ingin mengubah isi cetakan, buat clone penuh, ubah clone itu, lalu jadikan template baru.
πΉ Cloud-init: surat perintah saat pertama bangun
Cloud-init adalah layanan kecil di dalam VM yang membaca "surat" dari hypervisor pada boot pertama. Surat itu berisi nama host, kunci SSH, dan konfigurasi jaringan.
Proxmox tidak menulis surat di dalam disk. Ia membuat CD kecil (di lab kita 4 MB) berisi dua berkas: metadata dan user-data. VM membacanya, menerapkan isinya, lalu menandai dirinya sudah pernah diinisialisasi. Boot kedua dan seterusnya, surat itu diabaikan.
- π‘ Tips: karena mekanismenya berkas, kamu bisa melihat isi surat sebelum VM dinyalakan:
qm cloudinit dump <vmid> user. Ini cara termurah menemukan kesalahan β jauh lebih murah daripada menyalakan VM lalu bingung kenapa tidak bisa login.
- β οΈ Hati-hati: cloud-init hanya bekerja kalau image-nya memang punya cloud-init di dalam. ISO installer biasa tidak. Ubuntu Server ISO β Ubuntu Cloud Image. Ini kesalahan nomor satu pemula: mereka impor ISO live-server, pasang cloudinit drive, lalu heran kenapa tidak ada yang terjadi.
πΉ Empat jenis salinan yang perlu kamu bedakan
| Jenis | Isi dan sifat | Kapan dipakai |
|---|---|---|
| VM biasa | Disk sendiri, bisa diubah kapan saja | VM kerja sehari-hari |
| Template | Disk dasar, tidak bisa dinyalakan | Cetakan, disimpan jangka panjang |
| Linked clone | Hanya mencatat perubahan, bergantung pada template | Lab cepat, uji coba, hemat ruang |
| Full clone | Salinan penuh, mandiri | VM produksi, siswa, pelanggan |
Bedanya bukan sekadar ukuran. Linked clone berbagi disk dasar dengan template β kalau template dihapus, semua anaknya kehilangan pijakan. Full clone memakan ruang sebesar aslinya, tapi bisa hidup sendiri walau template lenyap.
- π Angka penting: di lab kami (Proxmox VE 8.4.21), clone penuh disk 1 GiB selesai 1,45 detik; linked clone disk yang sama 0,98 detik. Selisihnya kecil karena disk ujinya kosong. Untuk image OS 10 GiB, linked clone tetap di kisaran satu detik, sedangkan full clone ikut membesar sesuai data yang benar-benar terpakai.
πΉ Alur lima tahap
- Siapkan bahan β image cloud (misalnya Ubuntu cloud image) dan kunci SSH.
- Buat VM cangkang β mesin virtual kosong dengan nama sementara.
- Impor disk dan pasang cloud-init drive β disk image masuk sebagai
scsi0, CD cloud-init sebagaiide2. - Isi identitas dasar, lalu jadikan template β satu perintah
qm template. - Clone per kebutuhan, ganti identitas, nyalakan β di sini kamu menuai hasilnya.
Urutannya tidak boleh dibalik. Menjadikan template sebelum cloud-init drive terpasang berarti kamu punya cetakan yang tidak bisa disuntik apa pun, dan harus mengulang dari langkah dua.
π§© Istilah penting
- Template β VM yang dikunci sebagai cetakan; tidak bisa start, hanya bisa di-clone.
- Clone β salinan dari template atau VM lain.
- Linked clone β salinan tipis yang membaca disk dasar template; hemat ruang, tapi bergantung.
- Full clone β salinan mandiri; butuh ruang sebesar aslinya.
- Cloud image β berkas disk (umumnya
.imgatau.qcow2) yang sudah berisi sistem jadi dan cloud-init. - Cloud-init drive β CD kecil buatan Proxmox berisi surat perintah untuk VM.
- Configdrive / cidata β nama format isi CD tersebut; beda tipe untuk Windows (
configdrive2). - Snippet β berkas konfigurasi cloud-init buatan sendiri, disimpan di storage khusus.
- Thin provisioning β disk dialokasikan "setipis" pemakaian nyata, bukan sebesar ukuran yang ditulis.
- Base disk β nama disk template; setelah
qm template, disk berubah darivm-9001-disk-0menjadibase-9001-disk-0. - ciupgrade β opsi apakah VM menjalankan pembaruan paket saat boot pertama.
π§ Praktik: dari image kosong ke template cloud-init
Praktik ini memakai VM uji dengan nomor 9001 dan ruang 1 GiB, supaya tidak mengganggu VM yang sedang melayani. Semua angka di bawah adalah keluaran nyata dari lab Proxmox VE 8.4.21, bukan perkiraan.
πΉ Langkah 1 β Siapkan bahan dan kunci
- Buat kunci SSH khusus template. Jangan pakai kunci pribadi harianmu.
- Unduh cloud image resmi distro. Untuk Ubuntu:
https://cloud-images.ubuntu.com. - Simpan image di storage yang mengizinkan
isoatauimport.
ssh-keygen -t ed25519 -C "template-tkj" -f ~/.ssh/template-tkj
ls -lh ~/.ssh/template-tkj.pub
- π‘ Tips: satu kunci untuk satu tujuan. Kalau nanti kunci template bocor, kamu cukup mencabut satu kunci itu, bukan mengganti akses seluruh server.
πΉ Langkah 2 β Buat VM cangkang dan impor disk
qm create 9001 --name tpl-ubuntu --memory 2048 --cores 2 \
--net0 virtio,bridge=vmbr0 --scsihw virtio-scsi-pci --ostype l26
qm set 9001 --scsi0 local-lvm:0,import-from=/var/lib/vz/template/iso/ubuntu-cloud.img
Dua perintah itu sudah cukup untuk mendapat VM dengan disk hasil impor. Perhatikan --scsihw virtio-scsi-pci: banyak cloud image Ubuntu menolak boot kalau controller disk-nya bukan virtio SCSI.
- β οΈ Hati-hati: perintah
qm setdenganimport-frommenyalin image ke storage VM. Kalau storage tujuan hampir penuh, prosesnya berhenti di tengah dan menyisakan disk setengah jadi. Cek dulu denganpvesm status.
πΉ Langkah 3 β Pasang cloud-init drive dan konsol serial
qm set 9001 --ide2 local-lvm:cloudinit \
--serial0 socket --vga serial0 \
--boot order=scsi0
Tiga hal yang baru saja kamu lakukan:
ide2 ...cloudinitβ memasang CD surat perintah.serial0+vga serial0β memakai konsol teks sebagai layar. Banyak cloud image tidak punya driver grafis lengkap.boot order=scsi0β BIOS langsung boot dari disk, tidak sempat menguji CD.
- π§ͺ Uji cepat: setelah langkah ini, jalankan
qm config 9001 | grep ide2. Kalau keluarannya masih kosong, cloud-init drive belum terpasang dan seluruh praktik di bawah akan sia-sia.
πΉ Langkah 4 β Tulis identitas dasar di template
Template sebaiknya lahir tanpa identitas spesifik. Isi hanya nilai yang aman untuk semua salinan: user awal, kunci SSH, dan pilihan upgrade.
qm set 9001 --ciuser siswa \
--sshkey ~/.ssh/template-tkj.pub \
--ciupgrade 0
--ciupgrade 0 mematikan pembaruan paket otomatis saat boot pertama. Tanpa ini, 32 VM yang lahir bersamaan akan berebut bandwidth ke repo yang sama, dan "VM siap dalam 2 menit" berubah jadi 15 menit.
- β οΈ Hati-hati: kalau kamu memakai
--cipassword, Proxmox menyimpan versi terenkripsi di konfigurasi VM. Itu masih terbaca oleh siapa pun yang punya akses ke/etc/pve. Kunci SSH lebih aman, dan lebih mudah dicabut.
πΉ Langkah 5 β Periksa surat sebelum dikirim
Ini langkah yang paling sering dilewati, padahal paling murah. Kamu bisa membaca isi surat tanpa menyalakan VM:
qm cloudinit dump 9001 user
Keluaran nyata dari lab:
#cloud-config
hostname: ci-lab-test
manage_etc_hosts: true
fqdn: ci-lab-test
user: siswa
chpasswd:
expire: False
users:
- default
Perhatikan: tidak ada IP di situ. Konfigurasi jaringan disimpan terpisah, dan bisa kamu lihat dengan qm cloudinit dump 9001 network. Setelah IP diisi, keluarannya seperti ini:
version: 1
config:
- type: physical
name: eth0
mac_address: 'bc:24:11:07:d0:10'
subnets:
- type: static
address: '192.168.100.250'
netmask: '255.255.255.0'
gateway: '192.168.100.1'
- type: nameserver
address:
- '8.8.8.8'
search:
- 'novysan.local'
- π Angka penting: alamat DNS dan domain pencarian di atas bukan diketik di artikel ini β itu nilai bawaan host/datacenter yang ikut tersuntik karena kita tidak pernah mengatur
nameserversendiri. Artinya: kalau kamu tidak menentukan, host yang menentukan. Di lab sekolah, DNS 8.8.8.8 sering membuat VM tidak bisa menjangkau server lokal.
πΉ Langkah 6 β Ubah jadi template
qm template 9001
qm config 9001 | grep -E "^(template|scsi0)"
Keluaran nyata:
Renamed "vm-9001-disk-0" to "base-9001-disk-0" in volume group "pve"
Logical volume pve/base-9001-disk-0 changed.
template: 1
Sejak detik itu, qm start 9001 akan menolak dengan kalimat yang sudah kita lihat di bagian konsep. Itu tanda berhasil, bukan tanda rusak.
πΉ Langkah 7 β Clone per siswa, lalu ganti identitas
qm clone 9001 9011 --name siswa-web-01 --full
qm set 9011 --ipconfig0 ip=192.168.100.11/24,gw=192.168.100.1
qm start 9011
Untuk percobaan cepat yang tidak butuh kemandirian, buang --full:
qm clone 9001 9012 --name siswa-web-02
- π₯ Kasus nyata (dari lab ini sendiri): setelah clone penuh,
qm config 9011masih menampilkanipconfig0 ip=192.168.100.250/24β IP milik template. Proxmox tidak mengosongkannya. Kalau kamu menyalakan dua clone tanpa mengganti IP, dua VM itu berebut satu alamat dan salah satunya tampak "tidak bisa jaringan" padahal kabel virtualnya baik-baik saja. Keluaran ini bukan teori; itu yang kami baca langsung dariqm configsetelah clone.
πΉ Langkah 8 β Nyalakan dan buktikan
qm start 9011
qm status 9011
qm config 9011 | grep -E "^(name|ciuser|ipconfig0)"
Kalau semuanya benar, VM menyala dalam hitungan detik, hostname-nya mengikuti nama clone, dan kamu bisa masuk dengan kunci SSH β tanpa pernah menyentuh installer.
- π‘ Tips: beri nama clone dengan pola yang mengandung peran dan nomor, misalnya
siswa-web-01. Hostname cloud-init mengambil nama itu, jadi kamu mendapat dokumentasi gratis di dalam sistem.
πΉ Langkah 9 β Bereskan barang uji
qm destroy 9011 --purge
qm destroy 9012 --purge
qm destroy 9001 --purge
Kebiasaan ini yang membedakan lab rapi dari lab yang penuh VM "sementara" berumur dua tahun. Setelah dibersihkan, daftar VM kembali seperti semula β di lab kami tersisa 5 VM yang memang berjalan.
π Dipakai di dunia kerja
- Sekolah dan lab praktikum: satu template Ubuntu dan satu template Debian cukup untuk seluruh kelas. Guru tidak lagi jadi tukang instal; waktunya pindah ke mendampingi siswa.
- Kantor dan UMKM: setiap cabang butuh server kecil untuk aplikasi kasir atau absensi. Template memastikan semua cabang memakai versi sistem yang sama, sehingga troubleshooting tidak bergantung pada ingatan siapa yang menginstal.
- Hosting dan penyedia VPS: pelanggan baru dilayani dalam hitungan detik. Inilah alasan penyedia cloud bisa menjual "VPS 30 detik jadi" β bukan karena mesinnya ajaib, tapi karena cetakannya sudah lama disiapkan.
- Klinik dan puskesmas: aplikasi rekam medis dipasang di banyak titik. Template memisahkan "sistem dasar" dari "data pasien", sehingga titik baru tidak pernah mewarisi data lama.
- Industri dan OT: lingkungan uji harus bisa dibuat ulang persis seperti produksi. Template adalah cara mendokumentasikan konfigurasi yang selama ini hanya ada di kepala satu orang.
- Tim developer: setiap anggota tim butuh lingkungan sama untuk mereproduksi bug. Template menghapus kalimat "di komputerku jalan kok".
β Verifikasi
| Yang diperiksa | Perintah | Bukti lulus |
|---|---|---|
| Template terkunci | qm start 9001 | ditolak: "can't start a vm if it's a template" |
| Disk dasar berganti nama | grep scsi0 | base-9001-disk-0, bukan vm-9001-disk-0 |
| Cloud-init drive ada | grep ide2 | local-lvm:vm-9011-cloudinit,media=cdrom |
| Isi surat benar | qm cloudinit dump 9011 user | user, hostname, ssh_authorized_keys sesuai |
| Jaringan tersuntik | qm cloudinit dump 9011 network | IP, gateway, netmask sesuai keinginan |
| Identitas tidak menular | grep ipconfig0 | IP berbeda dari template |
- π§ͺ Uji cepat: bandingkan
qm config 9001 | grep ipconfig0denganqm config 9011 | grep ipconfig0. Kalau isinya identik, clone kamu akan bentrok IP saat dinyalakan berbarengan.
β οΈ Kesalahan umum & troubleshooting
| Gejala | Sebab | Perbaikan |
|---|---|---|
| VM clone tidak bisa jaringan | ipconfig0 ikut terbawa dari template | set ipconfig0 baru per clone |
| qm start ditolak | VM sudah jadi template | clone dulu, jalankan clone-nya |
| VM boot lalu diam | image bukan cloud image | pakai image cloud resmi distro |
| Tidak bisa login SSH | kunci salah atau user salah | cek dump user, pastikan ciuser cocok |
| Layar hitam di konsol | driver grafis tidak ada | pakai serial0 + vga serial0 |
| Boot pertama 15 menit | ciupgrade aktif, semua VM unduh paket | set --ciupgrade 0 |
| Clone lambat sekali | storage penuh atau disk besar | cek pvesm status, pilih linked clone |
| Semua anak mati mendadak | template dihapus | jangan hapus template yang punya anak |
| DNS di VM salah | nameserver ikut setelan host | atur nameserver eksplisit |
| qm template gagal | VM masih menyala | matikan dulu, baru jadikan template |
- β οΈ Hati-hati: pesan
WARNING: Sum of all thin volume sizes exceeds the size of thin poolbukan hiasan. Itu tanda kamu menjual ruang yang belum tentu ada. Di lab kami, angka tulisannya 971 GiB di atas pool 952 GiB β masih aman karena disk tidak terisi penuh, tapi kalau semua VM tiba-tiba menulis data, pool penuh dan VM bisa membeku.
Empat mitos yang perlu dibuang:
- "Template lebih cepat karena RAM-nya kecil." Tidak ada hubungan. Yang membuat cepat adalah lompatan instalasi, bukan ukuran RAM.
- "Linked clone selalu lebih baik karena hemat." Hemat sampai template hilang atau sampai kamu perlu memindahkan satu VM sendirian.
- "Cloud-init sama dengan cloud." Ini hanya mekanisme konfigurasi awal, jalan sepenuhnya di server lokalmu.
- "Template harus dibuat dari ISO." Bisa, tapi mengimpor image cloud jauh lebih cepat dan lebih sedikit langkahnya.
π Catatan keamanan & etika
- Template harus bersih. Jangan pernah menjadikan VM yang pernah dipakai sebagai template: hapus kunci SSH lama, riwayat perintah, berkas uji, dan
/etc/machine-id. - Pakai kunci, bukan kata sandi. Kata sandi cloud-init tersimpan (terenkripsi) di konfigurasi VM; kunci SSH tidak.
- Batasi siapa yang bisa clone. Kemampuan clone berarti kemampuan membuat salinan sistem beserta konfigurasinya. Di sekolah, ini wewenang guru, bukan siswa.
- Data siswa bukan bahan template. Kalau VM uji pernah memuat daftar nilai atau data pribadi, ia bukan kandidat template β dan data itu masuk kategori data pribadi menurut UU 27/2022.
- Jangan bagikan image sembarangan. Image dari sumber tidak resmi bisa berisi backdoor yang ikut tersalin ke 32 VM sekaligus.
- Catat asal image. Tulis URL dan tanggal unduh di deskripsi template. Enam bulan lagi, tidak ada yang ingat itu image versi apa.
π Kesimpulan
Template adalah cara mengubah pekerjaan berulang menjadi pekerjaan sekali. Kuncinya cuma tiga: image harus cloud image, cloud-init drive harus terpasang, dan identitas harus diganti per clone. Sisanya soal disiplin β terutama pada satu hal yang paling mudah dilupakan: IP tidak ikut berubah sendiri.
Kalau kamu baru mulai, buat satu template Ubuntu untuk lab, clone lima VM, dan catat waktu totalnya. Bandingkan dengan cara manual yang biasa kamu pakai; selisih itulah alasan topik ini ada di kurikulum industri.
π Materi terkait
- Proxmox: Bulk Snapshot & Roll Back VM β setelah VM banyak, snapshot massal jadi masalah baru.
- PNET: Membuat File qcow2 dari VirtualBox β memahami format disk sebelum impor image.
- Linux : SSH Hardening Lanjutan (Lima Lapis Kunci Akses) β mengamankan akses ke VM hasil clone.
- Linux : Backup Otomatis dengan rsync, tar, dan cron β template bukan pengganti backup.
- Linux : Instalasi dan Setup Nginx Produksi β langkah berikutnya setelah VM lahir.
- Instalasi Debian Server β jalur manual, untuk membandingkan biaya waktunya.
π Referensi
- Proxmox VE Wiki β VM Templates and Clones: https://pve.proxmox.com/wiki/VM_Templates_and_Clones
- Proxmox VE Wiki β Cloud-Init Support: https://pve.proxmox.com/wiki/Cloud-Init_Support
- Proxmox VE Admin Guide β qm (QEMU/KVM VM manager), termasuk opsi
clone,template, dancloudinit dump: https://pve.proxmox.com/pve-docs/qm.1.html - Proxmox VE Admin Guide β pvesm (manajemen storage): https://pve.proxmox.com/pve-docs/pvesm.1.html
- Cloud-init documentation: https://cloudinit.readthedocs.io/
- Ubuntu Cloud Images: https://cloud-images.ubuntu.com/
- Debian Cloud Images: https://cloud.debian.org/images/cloud/