community.general.proxmox_template – управление шаблонами ОС в кластере Proxmox VE

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.proxmox_template.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

позволяет загружать/удалять шаблоны в кластере Proxmox VE

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

proxmoxer
requests

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_host строка / обязательно		хост кластера Proxmox VE
api_password строка		пароль для аутентификации можно использовать переменную окружения PROXMOX_PASSWORD
api_token_id строка добавлен в 1.3.0 community.general		Укажите идентификатор токена.
api_token_secret строка добавлен в 1.3.0 community.general		Укажите секрет токена.
api_user строка / обязательно		пользователь для аутентификации
content_type строка	Варианты: vztmpl ← iso	тип контента необязательно только для `state=present`
force булево	Варианты: нет ← да	можно использовать только с `state=present`, существующий шаблон будет перезаписан
node строка		узел Proxmox VE, при работе с шаблоном
src путь		путь к загружаемому файлу необходимо только для `state=present`
state строка	Варианты: present ← absent	Указывает желаемое состояние шаблона
storage строка	Значение по умолчанию: "local"	целевой хранилище
template строка		имя шаблона Требуется для состояния `absent` для удаления шаблона. Требуется для состояния `present` для загрузки контейнерного шаблона прибора (pveam).
timeout целое число	Значение по умолчанию: 30	тайм-аут для операций
validate_certs булево	Варианты: нет ← да	включить/выключить проверку сертификата https

Примечания

Примечание

Требуются модули proxmoxer и requests на хосте. Эти модули можно установить с помощью pip.

Примеры

- 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: yes

- 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

Авторы

Сергей Антипов (@UnderGreen)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/proxmox_template_module.html