packer-proxmox-templates

📦 Packer templates for building Proxmox KVM images from ISO

use the latest tagged version which has been tested more thoroughly than 'master'

Debian v10 (buster) Packer Template using Packer Proxmox Builder to build a Proxmox VM image template

Ubuntu 18.04 (bionic) Packer Template using Packer Proxmox Builder to build a Proxmox VM image template

Ubuntu 20.04 (focal) Packer Template using Packer Proxmox Builder to build a Proxmox VM image template

OpenBSD 6 Packer Template using Packer Proxmox Builder to build a Proxmox VM image template

Alpine Linux Packer Template using Packer Proxmox Builder to build a Proxmox VM image template

Alpine Linux Packer Template using QEMU Builder to build a KVM image usable in Openstack or Proxmox

Proxmox KVM image templates

downloads the ISO and places it in Proxmox
creates a Proxmox VM
builds the image with Packer using automated installs
configures the image with Packer using Ansible
stores it as a Proxmox Template
see specific README.md for details about each template

Check Prerequisites

The build script which will run the packer template is can be run on the ProxMox server, or from a standalone administration system. Thus the following pre-requisites should be installed:

Ensure that Proxmox 6 is installed on a system that the templates will live on.
Set up a DHCP server that is accessable from the Proxmox network interface, for example isc-dhcp-server (see section DHCP in the Proxmox Ansible role).
Install Packer on the Proxmox server or your administration system

apt -y install unzip
packer_ver=1.7.0
wget https://releases.hashicorp.com/packer/${packer_ver}/packer_${packer_ver}_linux_amd64.zip
sudo unzip packer_${packer_ver}_linux_amd64.zip -d /usr/local/bin
packer --version

Install Ansible on the Proxmox server or your administration system

apt -y install python3-pip
pip3 install ansible==2.9.7
pip3 install py-bcrypt

Install j2cli on the Proxmox server or your administration system

pip3 install j2cli[yaml]

Download the latest tagged release of packer-proxmox-templates onto the Proxmox server or your administration system

wget https://github.com/chriswayg/packer-proxmox-templates/archive/v1.7.zip && unzip v1.7.zip && cd packer-proxmox-templates-*

Usage

On the Proxmox Server or administration system with Packer installed:

cd OSname-xy-amd64-proxmox

# for example
cd debian-10-amd64-proxmox
cd ubuntu-18.04-amd64-proxmox
cd openbsd-6-amd64-proxmox

copy build.conf.org to build.conf, then edit it, including the default user and especially the Proxmox URL and the ISO download links for the latest distro version
copy playbook/server-template-vars.yml.org to playbook/server-template-vars.yml, then edit it, especially the SSH Key & regional repositories
copy playbook/custom_playbook.yml.org to playbook/custom_playbook.yml, then edit it, this can be used to run custom Ansible roles or task

../build.sh proxmox

The template creation can be observed in the Proxmox GUI
Login via SSH using the default username as set in build.conf, or login as root via console (if not disabled)

Build Options

../build.sh (proxmox|debug [new_VM_ID])

proxmox    - Build and create a Proxmox VM template
debug      - Debug Mode: Build and create a Proxmox VM template

VM_ID     - VM ID for new VM template (or use default from build.conf)

Enter Passwords when prompted or provide them via ENV variables:
(use a space in front of ' export' to keep passwords out of bash_history)
 export proxmox_password=MyLoginPassword
 export ssh_password=MyPasswordInVM

Build environment

The Packer templates have been tested with the following versions of Packer and Ansible. If you use different versions, some details may need to be updated.

printf  "$(lsb_release -d) $(cat /etc/debian_version)\n" && \
  printf  "Proxmox $(pveversion)\n" &&
  packer version && \
  ansible --version |  sed -n '1p' && \
  ansible --version |  sed -n '6p' && \
  j2 --version

        Description:    Ubuntu 18.04.5 LTS buster/sid
        pveversion: command not found
        Proxmox
        Packer v1.7.0
        ansible 2.9.7
          python version = 3.6.9 (default, Jan 26 2021, 15:33:00) [GCC 8.4.0]
        j2cli 0.3.10, Jinja2 2.11.1

NOTE: For security reasons it would be preferable to build the Proxmox template images on a local Proxmox staging server (for example in a VM) and then to transfer the Proxmox templates using migration onto the live server(s).

xfrankbx/packer-proxmox-templates