Skip to content

Membuat template VM Ubuntu dengan cloud-init di Proxmox

Cara membuat template VM dari cloud image Ubuntu agar VM baru siap pakai dalam hitungan detik, lengkap dengan user, kunci SSH, IP statis, resize disk, dan QEMU guest agent.

published
reading time
3 min

Menginstal Ubuntu dari ISO untuk setiap VM baru memakan waktu 10 sampai 15 menit: memilih bahasa, layout keyboard, partisi, username, menunggu instalasi, lalu reboot. Kalau Anda membuat VM baru setiap minggu, waktu itu terbuang percuma.

Cara yang lebih efisien adalah memakai cloud image dan cloud-init, yaitu metode yang sama yang dipakai penyedia cloud seperti AWS dan DigitalOcean. Anda membuat satu template sekali, lalu setiap VM baru cukup di-clone dan diberi parameter seperti username, kunci SSH, dan alamat IP. VM siap dipakai dalam waktu kurang dari satu menit.

Apa itu cloud image dan cloud-init

Cloud image adalah image disk sistem operasi yang sudah terpasang, berukuran kecil (sekitar 600 MB untuk Ubuntu), tanpa user default dan tanpa password. Image ini dirancang untuk dikonfigurasi saat boot pertama.

cloud-init adalah program di dalam image tersebut yang membaca konfigurasi saat boot pertama: membuat user, memasang kunci SSH, mengatur jaringan, memperbesar partisi, dan menjalankan perintah tambahan. Proxmox menyediakan konfigurasi ini melalui disk virtual kecil yang disebut cloud-init drive.

Langkah 1: unduh cloud image

Jalankan di node Proxmox:

cd /var/lib/vz/template/iso
wget https://cloud-images.ubuntu.com/noble/current/noble-server-cloudimg-amd64.img

noble adalah Ubuntu 24.04 LTS. Untuk Debian, gunakan image genericcloud dari cloud.debian.org.

Langkah 2: buat VM kosong

Gunakan ID yang mudah dikenali sebagai template, misalnya 9000:

qm create 9000 \
  --name ubuntu-2404-template \
  --memory 2048 --cores 2 \
  --cpu host \
  --net0 virtio,bridge=vmbr0 \
  --scsihw virtio-scsi-single \
  --ostype l26

--cpu host memberi performa terbaik, tapi membuat live migration hanya mulus antar node dengan CPU sejenis. Untuk cluster dengan CPU campuran, gunakan x86-64-v2-AES atau model CPU yang lebih umum.

Langkah 3: impor disk

qm set 9000 --scsi0 local-lvm:0,import-from=/var/lib/vz/template/iso/noble-server-cloudimg-amd64.img,discard=on,ssd=1

Parameter import-from menyalin isi cloud image ke disk baru di storage local-lvm. Ganti local-lvm dengan nama storage Anda, misalnya local-zfs. Opsi discard=on mengizinkan TRIM, sehingga ruang yang dihapus di dalam VM juga dikembalikan ke storage thin-provisioned.

Langkah 4: tambahkan cloud-init drive dan atur boot

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

Penjelasan singkat:

  • ide2 ...:cloudinit membuat drive kecil berisi konfigurasi cloud-init.
  • boot order=scsi0 memastikan VM boot langsung dari disk.
  • serial0 dan vga serial0 diperlukan karena banyak cloud image mengharapkan konsol serial. Tanpa ini, layar konsol di Proxmox bisa kosong.
  • agent enabled=1 mengaktifkan dukungan QEMU guest agent di sisi Proxmox.

Langkah 5: pasang QEMU guest agent otomatis

Cloud image Ubuntu tidak menyertakan qemu-guest-agent. Tanpa agent, Proxmox tidak bisa menampilkan alamat IP VM atau melakukan shutdown dengan rapi. Cara paling praktis adalah memakai snippet cloud-init.

Aktifkan tipe konten snippets di storage local:

pvesm set local --content iso,vztmpl,backup,snippets

Buat file snippet:

/var/lib/vz/snippets/vendor-agent.yaml
#cloud-config
package_update: true
packages:
  - qemu-guest-agent
runcmd:
  - systemctl enable --now qemu-guest-agent

Pasang ke template:

qm set 9000 --cicustom "vendor=local:snippets/vendor-agent.yaml"

Snippet tipe vendor digabung dengan pengaturan user, SSH key, dan jaringan yang Anda isi di Proxmox, jadi pengaturan tersebut tetap berlaku.

Langkah 6: ubah menjadi template

qm template 9000

Setelah menjadi template, VM 9000 tidak bisa dinyalakan, hanya bisa di-clone. Ini justru yang diinginkan, karena template harus tetap bersih.

Membuat VM baru dari template

qm clone 9000 121 --name web01 --full
qm set 121 \
  --ciuser rafli \
  --sshkeys ~/.ssh/id_ed25519.pub \
  --ipconfig0 ip=10.10.10.121/24,gw=10.10.10.1 \
  --nameserver 10.10.10.1
qm resize 121 scsi0 +28G
qm start 121

Opsi --full membuat salinan disk independen. Tanpa opsi ini, Proxmox membuat linked clone yang lebih cepat dan hemat ruang, tapi bergantung pada disk template. Untuk server produksi, full clone lebih aman.

Perintah qm resize memperbesar disk virtual. cloud-init di dalam Ubuntu otomatis memperbesar partisi dan filesystem saat boot pertama, jadi tidak perlu growpart manual.

Untuk IP dinamis, gunakan --ipconfig0 ip=dhcp.

Sekitar 30 sampai 60 detik kemudian, VM siap diakses:

ssh [email protected]

Mengubah konfigurasi setelah VM dibuat

cloud-init hanya menerapkan sebagian besar konfigurasi pada boot pertama. Jika Anda mengubah IP atau kunci SSH di tab Cloud-Init Proxmox setelah VM pernah boot, klik Regenerate Image lalu reboot. Untuk perubahan jaringan, beberapa distro menerapkannya ulang, beberapa tidak. Untuk perubahan besar, lebih bersih membuat VM baru dari template.

Memperbarui template

Cloud image di-update secara berkala oleh Canonical. Template yang dibuat enam bulan lalu akan menjalankan banyak update pada boot pertama. Ada dua pendekatan:

  1. Buat ulang template setiap beberapa bulan dengan image terbaru. Simpan perintah di atas sebagai script agar prosesnya berulang dengan hasil yang sama.
  2. Biarkan package_update: true dan package_upgrade: true di snippet, dengan konsekuensi boot pertama lebih lama.

Saya memilih pendekatan pertama, dengan script yang dijalankan sebulan sekali dan menamai template berdasarkan tanggal.

Penutup

Template cloud-init adalah investasi satu jam yang menghemat waktu setiap kali Anda membutuhkan server baru. Lebih penting lagi, semua VM dimulai dari kondisi yang sama dan terdokumentasi, bukan dari instalasi manual yang sedikit berbeda setiap kali. Ini juga langkah awal yang baik sebelum beralih ke alat seperti Terraform atau Ansible untuk otomatisasi infrastruktur yang lebih lengkap.

Membuat template VM Ubuntu dengan cloud-init di Proxmox · Rafli Anggoro