Модуль community.libvirt.virt_pool – Управление хранилищами libvirt

Примечание

Этот модуль является частью коллекции community.libvirt (версия 1.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.libvirt. Для использования этого модуля требуются дополнительные зависимости. Подробности см. в разделе Требования.

Чтобы использовать его в книге задач, укажите: community.libvirt.virt_pool.

Обзор
Требования
Параметры
Примеры

Обзор

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

Требования

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

Модули Python для работы с libvirt
python >= 2.6
python-lxml

Параметры

Параметр	Комментарии
autostart boolean	Указывает, должен ли заданный пул хранилищ запускаться автоматически при загрузке системы. Варианты: `false` `true`
command string	Помимо управления состоянием, доступны различные неидемпотентные команды. См. примеры. Варианты: `"define"` `"build"` `"create"` `"start"` `"stop"` `"destroy"` `"delete"` `"undefine"` `"get_xml"` `"list_pools"` `"facts"` `"info"` `"status"` `"refresh"`
mode string	Передайте дополнительные параметры к командам ‘build’ или ‘delete’. Варианты: `"new"` `"repair"` `"resize"` `"no_overwrite"` `"overwrite"` `"normal"` `"zeroed"`
name aliases: pool string	Имя хранилища, подлежащего управлению. Обратите внимание, что пул должен быть предварительно определён с помощью xml.
state string	Укажите нужное состояние пула хранилищ. Если ‘active’, пул будет запущен. Если ‘present’, убедитесь, что пул присутствует, но не изменяйте его состояние; если его нет, необходимо указать аргумент xml. Если ‘inactive’, пул будет остановлен. Если ‘undefined’ или ‘absent’, пул будет удалён из конфигурации libvirt. Если ‘deleted’, содержимое пула будет удалено, а затем пул будет определён как отсутствующий. Варианты: `"active"` `"inactive"` `"present"` `"absent"` `"undefined"` `"deleted"`
uri string	URI подключения к libvirt. Значение по умолчанию: `"qemu:///system"`
xml string	XML-документ, используемый с командой define. Должен содержать исходный XML-контент, используя `lookup`. XML не может ссылаться на файл.

Примеры

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

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

- name: Start a storage pool
  community.libvirt.virt_pool:
    command: create
    name: vms

- name: List available pools
  community.libvirt.virt_pool:
    command: list_pools

- name: Get XML data of a specified pool
  community.libvirt.virt_pool:
    command: get_xml
    name: vms

- name: Stop a storage pool
  community.libvirt.virt_pool:
    command: destroy
    name: vms

- name: Delete a storage pool (destroys contents)
  community.libvirt.virt_pool:
    command: delete
    name: vms

- name: 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'
- name: Gather facts about storage pools
  community.libvirt.virt_pool:
    command: facts

- name: 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

- name: Ensure that a pool is active (needs to be defined and built first)
  community.libvirt.virt_pool:
    state: active
    name: vms

- name: Ensure that a pool is inactive
  community.libvirt.virt_pool:
    state: inactive
    name: vms

- name: Ensure that a given pool will be started at boot
  community.libvirt.virt_pool:
    autostart: true
    name: vms

- name: Disable autostart for a given pool
  community.libvirt.virt_pool:
    autostart: false
    name: vms

Авторы

Maciej Delmanowski (@drybjed)

Ссылки на коллекцию

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