community.libvirt.virt_pool – Управление хранилищами libvirt

Примечание

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

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

Для использования в плейбуке укажите: community.libvirt.virt_pool

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

Описание

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

Требования

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

python >= 2.6
python-libvirt
python-lxml

Параметры

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

Примеры

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

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

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

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

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

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

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

# 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'
- community.libvirt.virt_pool:
    command: facts

# 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

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

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

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

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

Авторы

Maciej Delmanowski (@drybjed)

© 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/libvirt/virt_pool_module.html