community.general.proxmox_template module – Management of OS templates in Proxmox VE cluster
Note
This module is part of the community.general collection (version 5.8.3).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: community.general.proxmox_template
.
Synopsis
allows you to upload/delete templates in Proxmox VE cluster
Requirements
The below requirements are needed on the host that executes this module.
proxmoxer
requests
Parameters
Parameter |
Comments |
---|---|
Specify the target host of the Proxmox VE cluster. |
|
Specify the password to authenticate with. You can use |
|
Specify the token ID. |
|
Specify the token secret. |
|
Specify the user to authenticate with. |
|
Content type. Required only for state=present. Choices:
|
|
It can only be used with state=present, existing template will be overwritten. Choices:
|
|
Proxmox VE node on which to operate. |
|
Path to uploaded file. Required only for state=present. |
|
Indicate desired state of the template. Choices:
|
|
Target storage. Default: |
|
The template name. Required for state=absent to delete a template. Required for state=present to download an appliance container template (pveam). |
|
Timeout for operations. Default: |
|
If This should only be used on personally controlled sites using self-signed certificates. Choices:
|
Notes
Note
Requires
proxmoxer
andrequests
modules on host. This modules can be installed with ansible.builtin.pip.
Examples
- name: Upload new openvz template with minimal options
community.general.proxmox_template:
node: uk-mc02
api_user: root@pam
api_password: 1q2w3e
api_host: node1
src: ~/ubuntu-14.04-x86_64.tar.gz
- name: >
Upload new openvz template with minimal options use environment
PROXMOX_PASSWORD variable(you should export it before)
community.general.proxmox_template:
node: uk-mc02
api_user: root@pam
api_host: node1
src: ~/ubuntu-14.04-x86_64.tar.gz
- name: Upload new openvz template with all options and force overwrite
community.general.proxmox_template:
node: uk-mc02
api_user: root@pam
api_password: 1q2w3e
api_host: node1
storage: local
content_type: vztmpl
src: ~/ubuntu-14.04-x86_64.tar.gz
force: true
- name: Delete template with minimal options
community.general.proxmox_template:
node: uk-mc02
api_user: root@pam
api_password: 1q2w3e
api_host: node1
template: ubuntu-14.04-x86_64.tar.gz
state: absent
- name: Download proxmox appliance container template
community.general.proxmox_template:
node: uk-mc02
api_user: root@pam
api_password: 1q2w3e
api_host: node1
storage: local
content_type: vztmpl
template: ubuntu-20.04-standard_20.04-1_amd64.tar.gz
Collection links
Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication