junos_linkagg - Управление группами агрегирования каналов на устройствах Juniper JUNOS

Новая в версии 2.4.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Поддержка
- Автор

Обзор

Этот модуль предоставляет декларативное управление группами агрегирования каналов на устройствах Juniper JUNOS.

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active		Варианты: да ← нет Значение по умолчанию: да	Указывает, активна или деактивирована конфигурация
aggregate			Список определений агрегирования каналов.
description			Описание интерфейса.
device_count			Количество агрегированных устройств Ethernet, которые можно настроить. Допустимое целое значение от 1 до 128.
members обязательно			Список интерфейсов-членов группы агрегирования каналов. Значение может быть одним интерфейсом или списком интерфейсов.
min_links			Минимальное количество активных членов, необходимых для включения группы агрегирования каналов.
mode		Варианты: вкл выкл активно пассивно Значение по умолчанию: нет	Режим группы агрегирования каналов. Значение `on` включит LACP в режиме `passive`. Значение `active` настраивает интерфейс для активного мониторинга состояния канала, или он может быть настроен в режиме `passive`, т.е. отправлять информацию о состоянии канала только при получении ее от другого канала. Значение `off` отключит LACP.
name обязательно			Имя группы агрегирования каналов.
provider		Значение по умолчанию: None	Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Дополнительная информация в руководстве Junos OS Platform Options. Объект словаря, содержащий сведения о подключении.
	username		Указывает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `ANSIBLE_NET_USERNAME`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение - путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	Значение по умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания превышено до завершения операции, модуль вернет ошибку.
	password	Значение по умолчанию: None	Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port	Значение по умолчанию: 22	Указывает порт для подключения к удаленному устройству. Значение по умолчанию - стандартный SSH-порт 22 (для `transport=cli`) или порт 830 (для `transport=netconf`) устройства.
state		Варианты: present ← absent up down	Состояние группы агрегирования каналов.

Примечания

Примечание

Для работы этого модуля требуется включенная служба netconf на удаленном управляемом устройстве.
Тестировалось на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение - netconf. См. Руководство по параметрам платформы Junos OS.
Этот модуль также работает с подключениями local для устаревших playbook'ов.
Сведения об использовании CLI и netconf см. в руководстве Параметры платформы Junos OS
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в Руководстве по сети Ansible
Дополнительную информацию об использовании Ansible для управления устройствами Juniper см. на https://www.ansible.com/ansible-juniper.

Примеры

- name: configure link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: present

- name: delete link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: delete

- name: deactivate link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: present
    active: False

- name: Activate link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: present
    active: True

- name: Disable link aggregation
  junos_linkagg:
    name: ae11
    state: down

- name: Enable link aggregation
  junos_linkagg:
    name: ae11
    state: up

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

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

Ключ	Возвращаемое значение	Описание
diff строка	при изменении конфигурации и включенном параметре diff.	Разница в конфигурации до и после внесения изменений. Пример: [edit interfaces] + ge-0/0/6 { + ether-options { + 802.3ad ae0; + } + } + [edit interfaces ge-0/0/7] + ether-options { + 802.3ad ae0; + } + [edit interfaces] + ae0 { + description "настроено с помощью junos_linkagg"; + aggregated-ether-options { + lacp { + active; + } + } + }

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.

Поддержка

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний

Автор

Ganesh Nalawade (@ganeshrn)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать его, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/junos_linkagg_module.html