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. |
| alias_name | Описание порта. | |
| ipv4 | Список IPv4-адресов для настройки на интерфейсе. В формате X.X.X.X/YY. | |
| ipv6 | Список IPv6-адресов для настройки на интерфейсе. В формате X:X:X::X/YYY. | |
| location | Значение по умолчанию: [u'/etc/network/interfaces.d'] | Расположение каталога интерфейса. |
| mstpctl_treeprio | Установить приоритет корневого дерева STP. Должно быть кратно 4096. | |
| mtu | Установить MTU. Настройте Jumbo Frame, установив MTU на 9000. | |
| name обязательно | Имя интерфейса. | |
| ports обязательно | Список членов моста. | |
| pvid | В режиме vlan-aware определяет vlan, который является untagged vlan. | |
| stp |
| Включает протокол STP. Начиная с Cumulus Linux 2.5, режим мостового соединения по умолчанию, поддерживаются только RSTP или 802.1d на каждый vlan. Для режима vlan aware поддерживается только STP общего экземпляра. |
| vids | В режиме vlan-aware перечисляет VLAN, определенные в интерфейсе. | |
| virtual_ip | Определите IPv4 виртуальный IP-адрес, используемый функцией Cumulus Linux VRR. | |
| virtual_mac | Определите Ethernet mac, связанный с функцией Cumulus Linux VRR. | |
| vlan_aware |
| Включает режим vlan-aware. |
Примечания
Примечание
- Поскольку этот модуль записывает расположение каталога интерфейса, убедитесь, что
/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 | changed | изменен ли интерфейс Пример: True |
| msg string | всегда | читаемая человеком информация об успехе или неудаче Пример: конфигурация интерфейса 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.5/modules/cl_bridge_module.html