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

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

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

Обзор

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

Требования

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

python >= 2.6
python-libvirt
python-lxml

Параметры

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

Статус

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

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Более подробная информация содержится в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

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.6/modules/virt_pool_module.html