cl_bond - Настройка порта связи bond в Cumulus Linux
Новая версия с 2.1.
- УСТАРЕВШЕЕ
- Синопсис
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Значения возврата
- Примечания
УСТАРЕВШЕЕ
Устарело в версии 2.3. Используйте nclu вместо этого.
Синопсис
- Настройка интерфейса связи bond в Cumulus Linux. Для настройки порта моста используйте модуль cl_bridge. Для настройки любого другого типа интерфейса используйте модуль cl_interface. Следуйте инструкциям по настройке связи bond, указанным в руководстве пользователя Cumulus, по адресу http://docs.cumulusnetworks.com.
Требования (к хосту, на котором выполняется модуль)
- Альтернативный менеджер сетевых интерфейсов Debian — ifupdown2 @ github.com/CumulusNetworks/ifupdown2
Параметры
| параметр | обязательно | значение по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| addr_method | нет |
| Настройка порта для использования DHCP. Для включения этой функции используйте параметр dhcp. | |
| alias_name | нет | Описание порта. | ||
| clag_id | нет | Укажите уникальный clag_id для каждого дублированного соединения bond на каждом коммутаторе-партнере. Значение должно быть в диапазоне от 1 до 65535 и должно быть одинаковым на обоих коммутаторах-партнёрах, чтобы связь bond считалась дублированной. | ||
| 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 | Режим связи bond. Начиная с Cumulus Linux 2.5, поддерживается только режим LACP bond. | |
| mstpctl_bpduguard | нет |
| Включает BPDU Guard на порту в режиме vlan-aware. | |
| mstpctl_portadminedge | нет |
| Включает порт административного края. | |
| mstpctl_portnetwork | нет |
| Включает проверку моста в режиме vlan-aware. | |
| mtu | нет | Установить MTU. Настройте Jumbo Frame, установив MTU в 9000. | ||
| name | да | Имя интерфейса. | ||
| pvid | нет | В режиме vlan-aware определяет vlan, который является untagged vlan. | ||
| slaves | да | Члены bond. | ||
| vids | нет | В режиме vlan-aware перечисляет 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. |
Примеры
# 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 |
Примечания
Примечание
- Поскольку этот модуль записывает расположение каталога интерфейса, убедитесь, что
/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_bond_module.html