cl_bridge - Настройка порта моста на Cumulus Linux

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

УСТАНОВЛЕНО
Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Автор

УСТАНОВЛЕНО

Удалино в Ansible:
	версия: 2.5
Почему:	Модуль nclu разработан для простоты использования пользователями, незнакомыми с Cumulus Linux, путем предоставления интерфейса NCLU в автоматизируемом формате.
Альтернатива:	Используйте 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	Значение по умолчанию: ["/etc/network/interfaces.d"]	Расположение каталога интерфейса.
mstpctl_treeprio		Установить приоритет корня дерева построения связности. Должно быть кратно 4096.
mtu		Установить MTU. Настройте Jumbo Frame, установив MTU в 9000.
name обязательно		Имя интерфейса.
ports обязательно		Список членов моста.
pvid		В режиме осознания VLAN определяет VLAN, который является VLAN без тегов.
stp	Варианты: да ← нет	Включает протокол построения связности. Начиная с Cumulus Linux 2.5, по умолчанию используется режим моста, поддерживаются только RSTP или 802.1d на уровне VLAN. Для режима осознания VLAN поддерживается только общий STP.
vids		В режиме осознания VLAN перечисляет VLAN, определенные в интерфейсе.
virtual_ip		Определите виртуальный IPv4-адрес, используемый функцией VRR Cumulus Linux.
virtual_mac		Определите Ethernet-MAC, связанный с функцией VRR Cumulus Linux.
vlan_aware	Варианты: да нет	Включает режим осознания VLAN.

Примечания

Примечание

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

Примеры

# 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 bool	изменено	были ли изменены интерфейс Пример: True
msg строка	всегда	читаемое сообщение об успехе или неудаче Пример: интерфейс bond0 конфигурация обновлена

Статус

Этот модуль помечен как устаревший и будет удален в версии 2.5. Дополнительную информацию см. в разделе УСТАНОВЛЕНО.

Автор

Cumulus Networks (@CumulusNetworks)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/cl_bridge_module.html