Модуль community.libvirt.virt_pool — управление пулами хранения libvirt

Примечание

Этот модуль входит в коллекцию community.libvirt (версия 2.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.libvirt. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.libvirt.virt_pool.

Краткое описание
Требования
Параметры
Примеры

Краткое описание

Управление пулами хранения libvirt.

Требования

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

привязки Python для libvirt
lxml
python >= 2.6
python-lxml

Параметры

Параметр	Комментарии
autostart boolean	Указывает, следует ли автоматически запускать указанный пул хранения при загрузке системы. Варианты: `false` `true`
command string	Помимо управления состоянием доступны различные неидемпотентные команды. См. примеры. Варианты: `"define"` `"build"` `"create"` `"start"` `"stop"` `"destroy"` `"delete"` `"undefine"` `"get_xml"` `"list_pools"` `"facts"` `"info"` `"status"` `"refresh"`
mode string	Передаёт дополнительные параметры командам «build» или «delete». Варианты: `"new"` `"repair"` `"resize"` `"no_overwrite"` `"overwrite"` `"normal"` `"zeroed"`
name псевдонимы: pool string	Имя управляемого пула хранения. Обратите внимание: пул должен быть предварительно определён с помощью xml.
state string	Указывает, в каком состоянии должен находиться пул хранения. Если задано значение «active», пул будет запущен. Если задано значение «present», пул должен существовать, но его состояние не будет изменено; если пул отсутствует, необходимо указать аргумент xml. Если задано значение «inactive», пул будет остановлен. Если задано значение «undefined» или «absent», пул будет удалён из конфигурации libvirt. Если задано значение «deleted», содержимое пула будет удалено, после чего пул будет исключён из конфигурации. Варианты: `"active"` `"inactive"` `"present"` `"absent"` `"undefined"` `"deleted"`
uri string	URI подключения к libvirt. По умолчанию: `"qemu:///system"`
xml string	XML-документ, используемый командой define. Должно быть указано необработанное содержимое XML с использованием `lookup`. Нельзя указать путь к файлу XML.

Примеры

- name: Define a new storage pool
  community.libvirt.virt_pool:
    command: define
    name: vms
    xml: '{{ lookup("template", "pool/dir.xml.j2") }}'

- name: Build a storage pool if it does not exist
  community.libvirt.virt_pool:
    command: build
    name: vms

- name: Start a storage pool
  community.libvirt.virt_pool:
    command: create
    name: vms

- name: List available pools
  community.libvirt.virt_pool:
    command: list_pools

- name: Get XML data of a specified pool
  community.libvirt.virt_pool:
    command: get_xml
    name: vms

- name: Stop a storage pool
  community.libvirt.virt_pool:
    command: destroy
    name: vms

- name: Delete a storage pool (destroys contents)
  community.libvirt.virt_pool:
    command: delete
    name: vms

- name: Undefine a storage pool
  community.libvirt.virt_pool:
    command: undefine
    name: vms

# Gather facts about storage pools
# Facts will be available as 'ansible_libvirt_pools'
- name: Gather facts about storage pools
  community.libvirt.virt_pool:
    command: facts

- name: Gather information about pools managed by 'libvirt' remotely using uri
  community.libvirt.virt_pool:
    command: info
    uri: '{{ item }}'
  with_items: '{{ libvirt_uris }}'
  register: storage_pools

- name: Ensure that a pool is active (needs to be defined and built first)
  community.libvirt.virt_pool:
    state: active
    name: vms

- name: Ensure that a pool is inactive
  community.libvirt.virt_pool:
    state: inactive
    name: vms

- name: Ensure that a given pool will be started at boot
  community.libvirt.virt_pool:
    autostart: true
    name: vms

- name: Disable autostart for a given pool
  community.libvirt.virt_pool:
    autostart: false
    name: vms

Авторы

Maciej Delmanowski (@drybjed)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/libvirt/virt_pool_module.html