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

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

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

Обзор

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

Требования

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

python >= 2.6
python-libvirt
python-lxml

Параметры

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

Список других модулей, также поддерживаемых сообществом 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_net_module.html