Spec-Zone.ru › Ansible 2.4

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. Для включения этой функции используйте параметр 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
нет
  • True
  • False
Включает BPDU Guard на порту в режиме vlan-aware.
mstpctl_portadminedge
нет
  • True
  • False
Включает порт административного края.
mstpctl_portnetwork
нет
  • True
  • False
Включает проверку моста в режиме 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

Spec-Zone.ru

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