fleeting-plugin-proxmox

README

Fleeting plugin for Proxmox Virtual Environment

This is a fleeting plugin for Proxmox Virtual Environment.

Installation

See Releases for available versions and installation instructions.

Configuration

Plugin settings

Parameter	Type	Default value	Description
url	string	N/A (required)	Proxmox VE URL.
insecure_skip_tls_verify	bool	false	If true then TLS certificate verification is disabled.
credentials_file_path	string	N/A (required)	Path to Proxmox VE credentials file.
pool	string	N/A (required)	Name of the Proxmox VE pool to use.
storage	string	N/A (required if template_id is a VM)	Name of the Proxmox VE storage to use. Leave unset or empty if template_id refers to a template to perform linked clones. If a value is set and template_id is a template, full clones will be performed instead. If template_id is another VM, full clones are always performed and this setting is required.
template_id	int	N/A (required)	ID of the Proxmox VE VM to create instances from.
max_instances	int	N/A (required)	Maximum instances than can be deployed.
instance_network_interface	string	ens18	Network interface to read instance's IPv4 address from.
instance_network_protocol	any or ipv4 or ipv6	ipv4	Network protocol to look for when discovering instance's IP address. any prioritizes IPv6.
instance_name_creating	string	fleeting-creating	Name to set for instances during creation.
instance_name_running	string	fleeting-running	Name to set for running instances.
instance_name_removing	string	fleeting-removing	Name to set for instances during removal.
instance_tags_creating	string	None ("")	Tags to set for instances during creation. Separate multiple tags with semicolons (;). This will remove any manually applied tags.
instance_tags_running	string	None ("")	Tags to set for running instances. Separate multiple tags with semicolons (;). This will remove any manually applied tags.
instance_tags_removing	string	None ("")	Tags to set for instances during removal. Separate multiple tags with semicolons (;). This will remove any manually applied tags.
instance_autoresize_disk	string	(None - disabled)	Name of disk to autoresize after cloning
instance_autoresize_size	string	(None - disabled)	Absolute or increment size to autoresize after cloning. Examples: 10G, +5.5G
proxmox_task_wait_interval	int	10	How often to check for Proxmox task completion

Credentials file

Parameter	Type	Description
realm	string	Authentication Realm
username	string	User name
password	string	User password
otp	string	One-time password for 2FA

Template VM configuration

The template must be a bootable VM with enabled DHCP and QEMU guest agent installed. See Proxmox documentation for more details.

Proxmox configuration

You MUST create a DEDICATED user, pool and storage for usage with this plugin. Any other configuration is untested and unsupported.

After creating a DEDICATED user, pool and storage follow procedure below to add required permissions:

1. Add template VM as a member to the pool.
2. Add storage as a member to the pool.
3. Add following roles for the user to the pool:
   • PVEVMAdmin,
   • PVEPoolUser,
   • PVEDatastoreUser.
4. Add following role for the user to the network that you will use for deployed VMs:
   • PVESDNAdmin.
5. Add following role for the user to the node with the storage, network, template etc.:
   • PVEAuditor without propagation.

Development

Integration tests

1. Create and fill out credentials.json file in project root (see Credentials file for details)

   cp credentials.example.json credentials.json
   

2. Create and fill out config.json file in project root (see Plugin settings for details)

   cp config.example.json config.json
   

3. Run integration tests:

   make integration-test