junipernetworks.junos.junos_linkagg – (устаревший, удалён после 2022-06-01) Управление группами агрегирования каналов на устройствах Juniper JUNOS

Примечание

Этот плагин входит в коллекцию junipernetworks.junos (версия 1.2.1).

Для установки используйте: ansible-galaxy collection install junipernetworks.junos.

Для использования в плейбуке укажите: junipernetworks.junos.junos_linkagg.

Новое в версии 1.0.0: из junipernetworks.junos

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

УСТАРЕВШИЙ

Удалено в: главном релизе после 2022-06-01
Почему: Выпущены обновлённые модули с большей функциональностью
Альтернатива: Используйте junipernetworks.junos.junos_lag_interfaces вместо этого.

Обзор

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

Примечание

Для этого модуля есть соответствующий плагин действий.

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active boolean		Варианты: нет да ←	Указывает, активна или деактивирована конфигурация
aggregate список / элементы=словарь			Список определений агрегирования каналов.
	active boolean	Варианты: нет да	Указывает, активна или деактивирована конфигурация
	description строка		Описание интерфейса.
	device_count целое число		Количество агрегированных ethernet-устройств, которые можно настроить. Допустимое целое число от 1 до 128.
	members список / элементы=строка		Список интерфейсов-членов группы агрегирования каналов. Значение может быть одним интерфейсом или списком интерфейсов.
	min_links целое число		Минимальное количество подключённых членов, которые должны быть активны перед включением группы агрегирования каналов.
	mode строка	Варианты: включено выключено активно пассивно	Режим группы агрегирования каналов. Значение `on` включит LACP в режиме `passive`. `active` настраивает интерфейс на активное получение информации о состоянии канала, или он может быть настроен в режиме `passive`, т.е. отправлять информацию о состоянии канала только при её получении от другого канала. Значение `off` отключит LACP.
	name строка / обязательно		Имя группы агрегирования каналов.
	state строка	Варианты: есть нет включен выключен	Состояние группы агрегирования каналов.
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 (для `transport=cli`) или 830 (для `transport=netconf`) устройства.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации SSH-сессии. Если значение не указано в задаче, будет использоваться значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: cli netconf ←	Настраивает транспортное соединение для подключения к удалённому устройству.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, будет использоваться значение переменной окружения `ANSIBLE_NET_USERNAME`.
state строка		Варианты: есть ← нет включен выключен	Состояние группы агрегирования каналов.

Примечания

Примечание

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

Примеры

- name: configure link aggregation
  junipernetworks.junos.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
  junipernetworks.junos.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
  junipernetworks.junos.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
  junipernetworks.junos.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
  junipernetworks.junos.junos_linkagg:
    name: ae11
    state: down

- name: Enable link aggregation
  junipernetworks.junos.junos_linkagg:
    name: ae11
    state: up

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

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

Ключ	Возвращаемое значение	Описание
diff string	при изменении конфигурации и включенном параметре 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 "configured by junos_linkagg"; + aggregated-ether-options { + lacp { + active; + } + } + }

Статус

Этот модуль будет удален в крупном релизе после 2022-06-01. [устаревший]
Для получения дополнительной информации см. УСТАРЕВШИЙ.

Авторы

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.10/collections/junipernetworks/junos/junos_linkagg_module.html