cl_bridge — Настройка мостового порта на Cumulus Linux

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

УСТЕРЕГЛО
Описание
Требования (для хоста, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
Примечания

УСТЕРЕГЛО

Устарело в версии 2.3. Используйте nclu вместо этого.

Описание

Настраивает мостовой интерфейс на Cumulus Linux Для настройки канала связи используйте модуль cl_bond. Для настройки любого другого типа интерфейса используйте модуль cl_interface. Следуйте рекомендациям по настройке мостов, приведенным в руководстве пользователя Cumulus на http://docs.cumulusnetworks.com

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

Альтернативный менеджер сетевых интерфейсов Debian ifupdown2 @ github.com/CumulusNetworks/ifupdown2

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
addr_method	нет		dhcp	Настраивает порт для использования DHCP. Чтобы включить эту функцию, используйте параметр dhcp.
alias_name	нет			Описание порта.
ipv4	нет			Список IPv4-адресов для настройки на интерфейсе. В формате X.X.X.X/YY.
ipv6	нет			Список IPv6-адресов для настройки на интерфейсе. В формате X:X:X::X/YYY.
location	нет	[u'/etc/network/interfaces.d']		Расположение каталога интерфейса.
mstpctl_treeprio	нет			Установить приоритет корневого дерева spanning tree. Должно быть кратно 4096.
mtu	нет			Установить MTU. Настроить Jumbo Frame, установив MTU в 9000.
name	да			Имя интерфейса.
ports	да			Список членов моста.
pvid	нет			В режиме с поддержкой VLAN определяет VLAN, который является неупакованным VLAN.
stp	нет	да	да нет	Включает протокол spanning tree. Начиная с Cumulus Linux 2.5, режим мостового соединения по умолчанию, поддерживаются только RSTP или 802.1d на VLAN. Для режима с поддержкой VLAN поддерживается только общий экземпляр STP.
vids	нет			В режиме с поддержкой VLAN перечисляет VLAN, определенные в интерфейсе.
virtual_ip	нет			Определяет виртуальный IPv4-адрес, используемый функцией Cumulus Linux VRR.
virtual_mac	нет			Определяет Ethernet mac, связанный с функцией Cumulus Linux VRR.
vlan_aware	нет		да нет	Включает режим с поддержкой VLAN.

Примеры

# Options ['virtual_mac', 'virtual_ip'] are required together
# configure a bridge vlan aware bridge.
- cl_bridge:
    name: br0
    ports: 'swp1-12'
    vlan_aware: 'yes'
  notify: reload networking

# configure bridge interface to define a default set of vlans
- cl_bridge:
    name: bridge
    ports: 'swp1-12'
    vlan_aware: 'yes'
    vids: '1-100'
  notify: reload networking

# define cl_bridge once in tasks file
# then write interface config in variables file
# with just the options you want.
- cl_bridge:
    name: "{{ item.key }}"
    ports: "{{ item.value.ports }}"
    vlan_aware: "{{ item.value.vlan_aware|default(omit) }}"
    ipv4:  "{{ item.value.ipv4|default(omit) }}"
    ipv6: "{{ item.value.ipv6|default(omit) }}"
    alias_name: "{{ item.value.alias_name|default(omit) }}"
    addr_method: "{{ item.value.addr_method|default(omit) }}"
    mtu: "{{ item.value.mtu|default(omit) }}"
    vids: "{{ item.value.vids|default(omit) }}"
    virtual_ip: "{{ item.value.virtual_ip|default(omit) }}"
    virtual_mac: "{{ item.value.virtual_mac|default(omit) }}"
    mstpctl_treeprio: "{{ item.value.mstpctl_treeprio|default(omit) }}"
  with_dict: "{{ cl_bridges }}"
  notify: reload networking

# In vars file
# ============
---
cl_bridge:
  br0:
    alias_name: 'vlan aware bridge'
    ports: ['swp1', 'swp3']
    vlan_aware: true
    vids: ['1-100']

Возвращаемые значения

Общие возвращаемые значения документированы здесь Возвращаемые значения, следующие поля уникальны для данного модуля:

имя	описание	возвращается	тип	пример
changed	было ли изменено состояние интерфейса	changed	bool	True
msg	человекопонятное сообщение об успехе или ошибке	всегда	строка	обновлён конфигурации интерфейса bond0

Примечания

Примечание

Поскольку этот модуль записывает расположение каталога интерфейса, убедитесь, что /etc/network/interfaces содержит ‘source /etc/network/interfaces.d/*’ или любой указанный в атрибуте location путь.
Для активации конфигурации, т. е. её загрузки в ядро, необходимо выполнить «service networking reload». См. раздел ПРИМЕРЫ.

Для помощи в разработке модулей, если вы этого желаете, прочитайте Информация о сообществе и участие, Тестирование 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/cl_bridge_module.html