pve-template-vm/README.md

# Create a VM template from the latest Debian release with settings appropriate for the CCCHH Proxmox clusters

## Prerequisites

The script uses the package [`libguestfs-tools`](https://libguestfs.org)' `virt-builder` to download and customize a Debian image. and then add it as a template to Proxmox.

## Building the Template

### Configuration Options
Verify that the settings at the beginning of the script are suitable to the cluster you want to create the template from.

| Variable  | Default            | Description                                                            |
| --------- | ------------------ | ---------------------------------------------------------------------- |
| `VMID`    | 9023               | ID the template should have in Proxmox                                 |
| `STORAGE` | `local-zfs`        | Pool the disks should be created in                                    |
| `OS`      | `debian-12`        | `virt-builder` name of the OS to install                               |
| `NAME`    | `chaos-${OS}-tmpl` | name of the template                                                   |
| `BRIDGE`  | `vmbr0,tag=208`    | name of the bridge to use and any parameters needed, like the VLAN tag |

### `authorized_keys`

The script expects `authorized_keys` to be in the current directory. Copy the correct contents from the [appropriate repository](https://gitlab.hamburg.ccc.de/ccchh/infrastructure-authorized-keys).

### Run the Script

```shell
./build-proxmox-template
```

## Cloning the Template

Please use "Full Clone" when creating a VM based on this template. Using Linked Clone means that the template's disk cannot be recreated since the linked clones need it. This means that the script cannot update the template.