3.4 KiB
3.4 KiB
Proxmox Create Template
Script to create a Proxmox template VM using the newest Ubuntu Cloud Image, with a cloud-init drive.
What it does
- Looks up the newest Ubuntu release on
cloud-images.ubuntu.com(newest LTS by default). - Downloads the cloud image and verifies its SHA256 checksum.
- Optionally bakes
qemu-guest-agentinto the image withvirt-customize(installslibguestfs-toolsif missing). - Creates the VM (virtio NIC, virtio-scsi-single,
cpu host, guest agent enabled, serial console). - Imports the image as
scsi0(discard, ssd, iothread) and resizes it toDISK_SIZE. - Adds a cloud-init drive with user, SSH keys, optional password and DHCP networking.
- Converts the VM to a template.
Requirements
- Run on the Proxmox host as root
curl- Internet access (for the image and, if needed,
libguestfs-tools)
Usage
./create-template.sh
Override any setting via environment variables:
VMID=9001 STORAGE=local-zfs CHANNEL=latest ./create-template.sh
Then clone the template:
qm clone 9000 <newid> --name <name> --full && qm start <newid>
Configuration
| Variable | Default | Description |
|---|---|---|
VMID |
9000 |
ID of the template VM (must not exist yet) |
STORAGE |
local-lvm |
Storage for the disk and cloud-init drive |
BRIDGE |
vmbr0 |
Network bridge |
CORES |
2 |
CPU cores |
MEMORY |
2048 |
Memory in MiB |
DISK_SIZE |
20G |
Final root disk size (must be larger than the image, ~3.5G) |
ARCH |
amd64 |
amd64 or arm64 |
CHANNEL |
lts |
lts = newest LTS, latest = newest release incl. interim |
CI_USER |
niklas |
Cloud-init default user |
CI_PASSWORD |
(empty) | Optional password; leave empty to rely on SSH keys only |
SSH_KEY_FILE |
$HOME/.ssh/authorized_keys |
Public keys injected via cloud-init |
INSTALL_QGA |
1 |
Bake qemu-guest-agent into the image (0 to skip) |
SNIPPET_STORAGE |
local |
Storage for the cloud-init snippet used by the QGA fallback |
QEMU guest agent fallback
If virt-customize can't install qemu-guest-agent (usually no network/DNS inside the libguestfs appliance), the script falls back to a cloud-init vendor snippet (qga-vendor.yaml) on SNIPPET_STORAGE. Clones then install the agent on first boot, which requires internet access on the clone. The vendor data only adds to Proxmox's generated user data, so ciuser/sshkeys still apply.
The snippet storage must allow the snippets content type. Enable it by adding snippets to the existing content list, e.g.:
pvesm set local --content iso,vztmpl,backup,snippets
Otherwise, just run apt install qemu-guest-agent inside each clone.
Notes
- If neither an SSH key file nor a password is set, you can't log in until you set one in the VM's Cloud-Init tab.
- The script aborts if the VMID already exists or the storage doesn't exist.
- Downloads happen in a temp directory that is removed on exit.