Spec-Zone.ru › Ansible 2.6

cl_interface — Настраивает порт передней панели, порт петли обратной связи или управляющий порт в Cumulus Linux.

Новое в версии 2.1.

  • УСТАРЕЛО
  • Синопсис
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
    • Автор

УСТАРЕЛО

Удалено в Ansible:
версия: 2.5
Почему: Модуль nclu разработан для удобного использования пользователями, не знакомыми с Cumulus Linux, путем автоматизированного доступа к интерфейсу NCLU.
Альтернатива: Используйте nclu вместо этого.

Синопсис

  • Настраивает порт передней панели, подчиненный интерфейс, SVI, управляющий или петли обратной связи на коммутаторе Cumulus Linux. Для портов мостов используйте модуль cl_bridge. Для портов объединения (bond) используйте модуль cl_bond. При конфигурировании функций, связанных с мостами, таких как параметр «vid», следуйте инструкциям по настройке «vlan aware» мостов. Для получения дополнительной информации см. руководство по интерфейсам уровня 2 на http://docs.cumulusnetworks.com

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • Альтернативный менеджер сетевых интерфейсов Debian — ifupdown2 @ github.com/CumulusNetworks/ifupdown2

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
addr_method
    Варианты:
  • loopback
  • dhcp
Способ адресации.
alias_name
Описание порта.
clagd_enable
Включает демон clagd. Данная команда должна применяться только к интерфейсу clag peerlink.
clagd_peer_ip
IP-адрес интерфейса сопряжённого коммутатора.
clagd_priority
Целое число, которое изменяет роль коммутатора в домене clag. Коммутатор с меньшим приоритетом получит главную роль. Значение может находиться в диапазоне от 0 до 65535.
clagd_sys_mac
MAC-адрес системы clagd. Рекомендуется использовать диапазон, начинающийся с 44:38:39:ff. Должен быть одинаковым на двух коммутаторах clag.
ipv4
Список IPv4-адресов для настройки на интерфейсе. В формате X.X.X.X/YY.
ipv6
Список IPv6-адресов для настройки на интерфейсе. В формате X:X:X::X/YYY.
location Значение по умолчанию:
["/etc/network/interfaces.d"]
Расположение каталога интерфейса
mstpctl_bpduguard
Включает BPDU Guard на порту в режиме vlan-aware.
mstpctl_portadminedge
Включает порт admin edge.
mstpctl_portnetwork
Включает гарантию моста в режиме vlan-aware.
mtu
Установить MTU. Настройте Jumbo Frame, установив MTU в 9000.
name
обязательно
Имя интерфейса.
pvid
В режиме vlan-aware определяет VLAN, который является немаркированной VLAN.
speed
Установить скорость интерфейса swp (передняя панель) или management (eth0). Скорость в Мбит/с.
vids
В режиме vlan-aware перечисляет VLAN, определенные для интерфейса.
virtual_ip
Определяет IPv4 виртуальный IP, используемый функцией Cumulus Linux VRR.
virtual_mac
Определяет Ethernet MAC, связанный с функцией Cumulus Linux VRR.

Примечания

Примечание

  • Поскольку этот модуль записывает расположение каталога интерфейса, убедитесь, что /etc/network/interfaces содержит «source /etc/network/interfaces.d/*» или любой указанный в атрибуте location путь.
  • Для активации конфигурации, т. е. ее загрузки в ядро, необходимо выполнить «service networking reload». См. раздел ПРИМЕРЫ.

Примеры

# Options ['virtual_mac', 'virtual_ip'] are required together
- name: Configure a front panel port with an IP
  cl_interface:
    name: swp1
    ipv4: 10.1.1.1/24
  notify: reload networking

- name: Configure front panel to use DHCP
  cl_interface:
    name: swp2
    addr_family: dhcp
  notify: reload networking

- name: Configure a SVI for vlan 100 interface with an IP
  cl_interface:
    name: bridge.100
    ipv4: 10.1.1.1/24
  notify: reload networking

- name: Configure subinterface with an IP
  cl_interface:
    name: bond0.100
    alias_name: my bond
    ipv4: 10.1.1.1/24
  notify: reload networking

# define cl_interfaces once in tasks
# then write interfaces in variables file
# with just the options you want.
- name: Create interfaces
  cl_interface:
      name: '{{ item.key }}'
      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) }}'
      speed: '{{ item.value.link_speed | default(omit) }}'
      mtu: '{{ item.value.mtu | default(omit) }}'
      clagd_enable: '{{ item.value.clagd_enable | default(omit) }}'
      clagd_peer_ip: '{{ item.value.clagd_peer_ip | default(omit) }}'
      clagd_sys_mac: '{{ item.value.clagd_sys_mac | default(omit) }}'
      clagd_priority: '{{ item.value.clagd_priority | 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_interfaces }}'
  notify: reload networking

# In vars file
# ============
---
cl_interfaces:
  swp1:
    alias_name: uplink to isp
    ipv4: 10.1.1.1/24
  swp2:
    alias_name: l2 trunk connection
    vids:
      - 1
      - 50
  swp3:
    speed: 1000
    alias_name: connects to 1G link
##########
#   br0 interface is configured by cl_bridge
##########
  br0.100:
    alias_name: SVI for vlan 100
    ipv4: 10.2.2.2/24
    ipv6: '10:2:2::2/127'
    virtual_ip: 10.2.2.254
    virtual_mac: 00:00:5E:00:10:10

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ Возвращаемое значение Описание
changed
bool
changed
указывает, был ли изменён интерфейс

Пример:
True
msg
строка
всегда
человекопонятное сообщение об успехе или неудаче

Пример:
config интерфейса 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_interface_module.html

Spec-Zone.ru

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