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

Новое в версии 2.0.

Описание
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
- Статус

Описание

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

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
python-libvirt
python-lxml

Параметры

параметр	обязательный	по умолчанию	значения	комментарии
autostart	нет		да нет	Указывает, должен ли данный пул хранилищ запускаться автоматически при загрузке системы.
command	нет		define build create start stop destroy delete undefine get_xml list_pools facts info status	Помимо управления состоянием, доступны различные неидемпотентные команды. См. примеры.
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		адрес подключения libvirt.
xml	нет			XML-документ, используемый с командой define.

Примеры

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

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

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

# List available pools
- virt_pool:
    command: list_pools

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

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

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

# Undefine a storage pool
- virt_pool:
    command: undefine
    name: vms

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

# Gather information about pools managed by 'libvirt' remotely using uri
- 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)
- virt_pool:
    state: active
    name: vms

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

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

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

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Для помощи в разработке модулей, если вам это интересно, пожалуйста, прочитайте Информацию о сообществе и сотрудничестве, Тестирование Ansible и Разработка модулей.

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