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 | По умолчанию: [u'/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, которая является немаркированной 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 | changed | изменён ли интерфейс Пример: 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.5/modules/cl_bond_module.html