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 |
| Способ адресации. |
| 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