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

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

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

Обзор

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

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Примечания

Примечание

Данному модулю требуется, чтобы на управляемом удаленном устройстве была включена служба netconf.
Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение — netconf. См. настройки Junos OS Platform Options.
Этот модуль также работает с подключениями local для устаревших playbooks.
Для получения информации по использованию командной строки и netconf, см. руководство по настройкам Junos OS Platform Options
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами, см. руководство по Ansible Network
Для получения дополнительной информации об использовании 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.8/modules/junos_linkagg_module.html