Spec-Zone.ru › Ansible 2.6

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. Для активации этой функции используйте параметр 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
    Варианты:
  • yes
  • no
Включает BPDU Guard на порту в режиме с поддержкой VLAN.
mstpctl_portadminedge
    Варианты:
  • yes
  • no
Включает порт admin edge.
mstpctl_portnetwork
    Варианты:
  • yes
  • no
Включает гарантию моста в режиме с поддержкой 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API