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 string	Варианты: define build create start stop destroy delete undefine get_xml list_pools facts info status refresh	В дополнение к управлению состоянием доступны различные неидемпотентные команды. См. примеры.
mode string	Варианты: new repair resize no_overwrite overwrite normal zeroed	Передать дополнительные параметры к командам 'build' или 'delete'.
name string		Имя управляемого пула хранилищ. Обратите внимание, что пул должен быть предварительно определен с помощью xml. псевдонимы: pool
state string	Варианты: active inactive present absent undefined deleted	Указать желаемое состояние пула хранилищ. Если 'active', пул будет запущен. Если 'present', убедитесь, что пул присутствует, но не изменяйте его состояние; если его нет, необходимо указать аргумент xml. Если 'inactive', пул будет остановлен. Если 'undefined' или 'absent', пул будет удален из конфигурации libvirt. Если 'deleted', содержимое пула будет удалено, а затем пул будет объявлен неопределённым.
uri string	Значение по умолчанию: "qemu:///system"	Адрес подключения libvirt.
xml string		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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/libvirt/virt_pool_module.html