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

Примечание

Этот плагин входит в коллекцию community.libvirt (версия 1.0.0).

Для его установки используйте: ansible-galaxy collection install community.libvirt.

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

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

Обзор

Управление сетями 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
- community.libvirt.virt_net:
    command: define
    name: br_nat
    xml: '{{ lookup("template", "network/bridge.xml.j2") }}'

# Start a network
- community.libvirt.virt_net:
    command: create
    name: br_nat

# List available networks
- community.libvirt.virt_net:
    command: list_nets

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

# Stop a network
- community.libvirt.virt_net:
    command: destroy
    name: br_nat

# Undefine a network
- community.libvirt.virt_net:
    command: undefine
    name: br_nat

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

# Gather information about network managed by 'libvirt' remotely using uri
- community.libvirt.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)
- community.libvirt.virt_net:
    state: active
    name: br_nat

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

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

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

# Add a new host in the dhcp pool
- community.libvirt.virt_net:
    name: br_nat
    command: modify
    xml: "<host mac='FC:C2:33:00:6c:3c' name='my_vm' ip='192.168.122.30'/>"

Авторы

Maciej Delmanowski (@drybjed)

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