virt_net — Управление конфигурацией сети libvirt

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

Краткое описание
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
- Статус

Краткое описание

Управление сетями libvirt.

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
python-libvirt
python-lxml

Параметры

Параметр	Обязательно	Значение по умолчанию	Возможные значения	Комментарии
autostart	нет		да нет	Указывает, должен ли данный хранилище пул запускаться автоматически при загрузке системы.
command	нет		определить создать запустить остановить удалить разопределить получить_xml список_сетей факты информация статус изменить	В дополнение к управлению состоянием доступны различные неидемпотентные команды. Смотрите примеры. Изменить был добавлен в версии 2.1
name	да			Имя управляемой сети. Обратите внимание, что сеть должна быть предварительно определена с помощью xml. псевдонимы: сеть
state	нет		активный неактивный настоящий отсутствующий	Указывает желаемое состояние сети. Если 'активный', сеть будет запущена. Если 'настоящий', убедиться, что сеть присутствует, но не изменять ее состояние; если ее нет, необходимо указать аргумент xml. Если 'неактивный', сеть будет остановлена. Если 'неопределённый' или 'отсутствующий', сеть будет удалена из конфигурации libvirt.
uri	нет	qemu:///system		URI подключения к libvirt.
xml	нет			XML-документ, используемый с командой define.

Примеры

# Define a new network
- virt_net:
    command: define
    name: br_nat
    xml: '{{ lookup("template", "network/bridge.xml.j2") }}'

# Start a network
- virt_net:
    command: create
    name: br_nat

# List available networks
- virt_net:
    command: list_nets

# Get XML data of a specified network
- virt_net:
    command: get_xml
    name: br_nat

# Stop a network
- virt_net:
    command: destroy
    name: br_nat

# Undefine a network
- virt_net:
    command: undefine
    name: br_nat

# Gather facts about networks
# Facts will be available as 'ansible_libvirt_networks'
- virt_net:
    command: facts

# Gather information about network managed by 'libvirt' remotely using uri
- virt_net:
    command: info
    uri: '{{ item }}'
  with_items: '{{ libvirt_uris }}'
  register: networks

# Ensure that a network is active (needs to be defined and built first)
- virt_net:
    state: active
    name: br_nat

# Ensure that a network is inactive
- virt_net:
    state: inactive
    name: br_nat

# Ensure that a given network will be started at boot
- virt_net:
    autostart: yes
    name: br_nat

# Disable autostart for a given network
- virt_net:
    autostart: no
    name: br_nat

Статус

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

Для получения помощи в разработке модулей, если у вас возникнет желание, прочитайте Информацию о сообществе и вклад, Тестирование Ansible и Разработка модулей.

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