Модуль community.libvirt.virt_net — управление конфигурацией сети libvirt

Примечание

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

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

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

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

Краткое описание
Требования
Параметры
Примеры

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

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

Требования

Следующие требования необходимо выполнить на узле, где выполняется этот модуль.

привязки Python для libvirt
lxml
python >= 2.6
python-lxml

Параметры

Параметр	Комментарии
autostart логическое значение	Указывает, следует ли автоматически запускать данную сеть при загрузке системы. Возможные значения: `false` `true`
command строка	Помимо управления состоянием доступны различные неидемпотентные команды. См. примеры. Команда Modify появилась в Ansible версии 2.1. Возможные значения: `"define"` `"create"` `"start"` `"stop"` `"destroy"` `"undefine"` `"get_xml"` `"list_nets"` `"facts"` `"info"` `"status"` `"modify"`
name псевдонимы: network строка	Имя управляемой сети. Обратите внимание: сеть должна быть предварительно определена с помощью xml.
state строка	Указывает требуемое состояние сети. Если указано «active», сеть будет запущена. Если указано «present», модуль проверит наличие сети, не изменяя её состояние; если сеть отсутствует, необходимо указать аргумент xml. Если указано «inactive», сеть будет остановлена. Если указано «undefined» или «absent», сеть будет удалена из конфигурации libvirt. Возможные значения: `"active"` `"inactive"` `"present"` `"absent"`
uri строка	URI для подключения к libvirt. По умолчанию: `"qemu:///system"`
xml строка	XML-документ, используемый с командой define. Должно быть указано необработанное содержимое XML с использованием `lookup`. Вместо XML нельзя указывать ссылку на файл.

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

- name: 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/libvirt/virt_net_module.html