Files
proxmox-create-template/README.md
T

74 lines
3.4 KiB
Markdown

# Proxmox Create Template
Script to create a Proxmox template VM using the newest Ubuntu Cloud Image, with a cloud-init drive.
## What it does
1. Looks up the newest Ubuntu release on `cloud-images.ubuntu.com` (newest LTS by default).
2. Downloads the cloud image and verifies its SHA256 checksum.
3. Optionally bakes `qemu-guest-agent` into the image with `virt-customize` (installs `libguestfs-tools` if missing).
4. Creates the VM (virtio NIC, virtio-scsi-single, `cpu host`, guest agent enabled, serial console).
5. Imports the image as `scsi0` (discard, ssd, iothread) and resizes it to `DISK_SIZE`.
6. Adds a cloud-init drive with user, SSH keys, optional password and DHCP networking.
7. 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
```bash
./create-template.sh
```
Override any setting via environment variables:
```bash
VMID=9001 STORAGE=local-zfs CHANNEL=latest ./create-template.sh
```
Then clone the template:
```bash
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.:
```bash
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.