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

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

Обзор
- Требования
Параметры
Примеры
Статус
- Автор

Обзор

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

Требования

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

python >= 2.6
python-libvirt
python-lxml

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
autostart	Варианты: yes no	Указывает, должен ли заданный пул хранилищ запускаться автоматически при загрузке системы.
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	URI подключения 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

Статус

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

Автор

Maciej Delmanowski (@drybjed)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

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