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

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

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

Обзор

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

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Статус

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

Техническое обслуживание

Этот модуль помечен как сетевой, что означает, что его поддерживает команда Ansible Network Team. Более подробная информация доступна в разделе Поддержка и техническое обслуживание модулей.

Список других модулей, поддерживаемых командой Ansible Network Team, см. в разделе здесь.

Поддержка

Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/junos_linkagg_module.html