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

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

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

Описание

Управление хранилищами 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	Помимо управления состоянием, доступны различные неидемпотентные команды. См. примеры.
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. [community]

Авторы

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