cl_bond — Настройка порта агрегирования на Cumulus Linux
Новое в версии 2.1.
УСТЕРЕГШИЙСЯ
| Удалено в Ansible: | |
|---|---|
| версия: 2.5 | |
| Почему: | Модуль nclu разработан для удобства пользователей, которые только начинают работать с Cumulus Linux, предоставляя автоматируемый способ доступа к интерфейсу NCLU. |
| Альтернатива: | Используйте nclu вместо этого. |
Описание
- Настраивает интерфейс агрегирования на Cumulus Linux. Для настройки порта моста используйте модуль cl_bridge. Для настройки любого другого типа интерфейса используйте модуль cl_interface. Следуйте руководству по агрегированию, приведенному в руководстве пользователя Cumulus по адресу http://docs.cumulusnetworks.com.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.
- Альтернативный менеджер сетевых интерфейсов Debian — ifupdown2 @ github.com/CumulusNetworks/ifupdown2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| addr_method |
| Настраивает порт для использования DHCP. Для активации этой функции используйте параметр dhcp. |
| alias_name | Описание порта. | |
| clag_id | Укажите уникальный clag_id для каждого двойного агрегированного порта на каждом коммутаторе-партнёре. Значение должно быть от 1 до 65535 и должно быть одинаковым на обоих коммутаторах-партнёрах, чтобы порт агрегирования считался двойным. | |
| ipv4 | Список IPv4-адресов для настройки на интерфейсе. В формате X.X.X.X/YY. | |
| ipv6 | Список IPv6-адресов для настройки на интерфейсе. В формате X:X:X::X/YYY. | |
| lacp_bypass_all_active | Активировать все интерфейсы для обхода. Рекомендуется настроить all_active вместо использования bypass_priority. | |
| lacp_bypass_allow | Включить обход LACP. | |
| lacp_bypass_period | Период активации обхода LACP. Максимальное значение равно 900. | |
| lacp_bypass_priority | Список портов и приоритетов. Пример: "swp1=10, swp2=20". | |
| lacp_rate | По умолчанию: 1 | Скорость lacp. |
| location | По умолчанию: ["/etc/network/interfaces.d"] | Расположение каталога интерфейса. |
| miimon | По умолчанию: 100 | Интервал мониторинга ссылки mii. |
| min_links | По умолчанию: 1 | Минимальное количество подключений. |
| mode | По умолчанию: "802.3ad" | Режим агрегирования, начиная с Cumulus Linux 2.5, поддерживается только режим агрегирования LACP. |
| mstpctl_bpduguard |
| Включает BPDU Guard на порту в режиме с поддержкой VLAN. |
| mstpctl_portadminedge |
| Включает порт admin edge. |
| mstpctl_portnetwork |
| Включает гарантию моста в режиме с поддержкой VLAN. |
| mtu | Установить MTU. Настройте Jumbo Frame, установив MTU в 9000. | |
| name обязательно | Имя интерфейса. | |
| pvid | В режиме с поддержкой VLAN определяет VLAN, который является untagged VLAN. | |
| slaves обязательно | Члены агрегирования. | |
| vids | В режиме с поддержкой VLAN перечисляет VLAN, определенные для интерфейса. | |
| virtual_ip | Определите IPv4 виртуальный IP, используемый функцией Cumulus Linux VRR. | |
| virtual_mac | Определите Ethernet MAC, связанный с функцией Cumulus Linux VRR. | |
| xmit_hash_policy | По умолчанию: "layer3+4" | Алгоритм балансировки нагрузки передачи. Начиная с Cumulus Linux 2.5, поддерживается только политика layer3+4. |
Примечания
Примечание
- Поскольку этот модуль записывает расположение каталога интерфейса, убедитесь, что
/etc/network/interfacesимеет «source /etc/network/interfaces.d/*» или любой другой путь, указанный в атрибутеlocation. - Для активации конфигурации, т.е. её установки в ядро, необходимо выполнить «service networking reload». См. раздел ПРИМЕРЫ.
Примеры
# Options ['virtual_mac', 'virtual_ip'] are required together
# configure a bond interface with IP address
- cl_bond:
name: bond0
slaves:
- swp4-5
ipv4: 10.1.1.1/24
# configure bond as a dual-connected clag bond
- cl_bond:
name: bond1
slaves:
- swp1s0
- swp2s0
clag_id: 1
# define cl_bond once in tasks file
# then write interface config in variables file
# with just the options you want.
- cl_bond:
name: "{{ item.key }}"
slaves: "{{ item.value.slaves }}"
clag_id: "{{ item.value.clag_id|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_portnetwork: "{{ item.value.mstpctl_portnetwork|default('no') }}"
mstpctl_portadminedge: "{{ item.value.mstpctl_portadminedge|default('no') }}"
mstpctl_bpduguard: "{{ item.value.mstpctl_bpduguard|default('no') }}"
with_dict: "{{ cl_bonds }}"
# In vars file
# ============
---
cl_bonds:
bond0:
alias_name: uplink to isp
slaves:
- swp1
- swp3
ipv4: 10.1.1.1/24'
bond2:
vids:
- 1
- 50
clag_id: 1
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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_bond_module.html