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

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

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

Обзор

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

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Примечания

Примечание

Для работы этого модуля необходимо включить системную службу netconf на управляемом удаленном устройстве.
Тестировано на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение – netconf. См. Руководство по опциям платформы Junos OS.
Этот модуль также работает с подключениями local для устаревших playbooks.
Дополнительная информация по использованию 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; + } + } + }

Статус

Не гарантируется обратная совместимость интерфейса модуля. [предварительный просмотр]
Этот модуль поддерживается командой Ansible Network. [сеть]

Поддержка Red Hat

Дополнительная информация о поддержке этого модуля компанией Red Hat доступна в этой статье базы знаний 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.7/modules/junos_linkagg_module.html