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

Примечание

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

Для его установки используйте: 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 булево	Варианты: нет ← да	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах, использующих самозаверенные сертификаты.

Примечания

Примечание

Требуются модули 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

Авторы

Sergei Antipov (@UnderGreen)

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