cisco.nxos.nxos_linkagg – (устаревший, удален после 2022-06-01) Управление группами агрегирования каналов на устройствах Cisco NXOS.

Примечание

Этот плагин входит в коллекцию cisco.nxos (версия 1.3.1).

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

Для использования в книге задач, укажите: cisco.nxos.nxos_linkagg.

Новое в версии 1.0.0: of cisco.nxos

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

УСТАРЕВШИЙ

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

Обзор

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

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate список / элементы=словарь			Список определений агрегирования каналов.
	force булево	Варианты: нет ← да	При значении true принудительно назначаются члены группы агрегирования каналов, соответствующие заданным в параметре members. Это можно использовать для удаления членов.
	group строка / обязательно		Номер группы каналов для группы агрегирования каналов port-channel.
	members список / элементы=строка		Список интерфейсов, которые будут управляться в группе агрегирования каналов.
	min_links целое число		Минимальное количество подключений, необходимых для включения группы агрегирования каналов.
	mode строка	Варианты: активно вкл пассивно	Режим работы группы агрегирования каналов.
	state строка	Варианты: наличие отсутствует	Состояние группы агрегирования каналов.
force булево		Варианты: нет ← да	При значении true принудительно назначаются члены группы агрегирования каналов, соответствующие заданным в параметре members. Это можно использовать для удаления членов.
group строка			Номер группы каналов для группы агрегирования каналов port-channel.
members список / элементы=строка			Список интерфейсов, которые будут управляться в группе агрегирования каналов.
min_links целое число			Минимальное количество подключений, необходимых для включения группы агрегирования каналов.
mode строка		Варианты: активно вкл ← пассивно	Режим работы группы агрегирования каналов.
provider словарь			Устаревший Начиная с Ansible 2.5 рекомендуется использовать `connection: network_cli`. Начиная с Ansible 2.6 рекомендуется использовать `connection: httpapi` для NX-API. Этот параметр будет удален в версии после 2022-06-01. Для получения дополнительной информации см. Руководство по платформе NXOS. Объект словаря, содержащий сведения о подключении.
	auth_pass строка		Указывает пароль для входа в привилегированный режим на удалённом устройстве, если это необходимо. Если authorize ложно, то этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	authorize булево	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удалённом устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному протоколу. Значение host используется в качестве адреса назначения для протокола.
	password строка		Указывает пароль для проверки подлинности подключения к удалённому устройству. Это общий аргумент, используемый для протоколов cli или nxapi. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт для создания подключения к удалённому устройству. Это значение применяется к протоколам cli или nxapi. Значение порта по умолчанию соответствует соответствующему общему порту для протокола, если он не указан в задаче (cli=22, http=80, https=443).
	ssh_keyfile строка		Указывает SSH-ключ для проверки подлинности подключения к удалённому устройству. Этот аргумент используется только для протокола cli. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернёт ошибку. NX-API может медленно реагировать на длительные команды (sh mac, sh bgp и т. д.).
	transport строка	Варианты: cli ← nxapi	Настраивает протокол подключения для соединения с удалённым устройством. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy булево	Варианты: нет да ←	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl булево	Варианты: нет ← да	Настраивает transport на использование SSL, если установлено значение `yes`, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	username строка		Настраивает имя пользователя для проверки подлинности подключения к удалённому устройству. Это значение используется для проверки подлинности входа в CLI или проверки подлинности nxapi в зависимости от используемого протокола. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	validate_certs булево	Варианты: нет ← да	Если `no`, сертификаты SSL не будут проверяться. Это следует использовать только на контролируемых вами сайтах с самоподписанными сертификатами. Если аргумент transport не равен nxapi, это значение игнорируется.
purge булево		Варианты: нет ← да	Удалить подключения, не определённые в параметре aggregate.
state строка		Варианты: наличие ← отсутствует	Состояние группы агрегирования каналов.

Примечания

Примечание

Тестировалось на NXOSv 7.0(3)I5(1).
state=absent удаляет конфигурацию portchannel и интерфейс, если они уже существуют. Если члены, которые нужно удалить, не указаны явно, удаляются все существующие члены (если таковые имеются).
Члены должны быть списком.
LACP необходимо сначала включить, если используются режимы активного/пассивного.
Дополнительную информацию об использовании CLI и NX-API см. в руководстве NXOS Platform Options.
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide.
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco.

Примеры

- name: create link aggregation group
  cisco.nxos.nxos_linkagg:
    group: 99
    state: present

- name: delete link aggregation group
  cisco.nxos.nxos_linkagg:
    group: 99
    state: absent

- name: set link aggregation group to members
  cisco.nxos.nxos_linkagg:
    group: 10
    min_links: 3
    mode: active
    members:
    - Ethernet1/2
    - Ethernet1/4

- name: remove link aggregation group from Ethernet1/2
  cisco.nxos.nxos_linkagg:
    group: 10
    min_links: 3
    mode: active
    members:
    - Ethernet1/4

- name: Create aggregate of linkagg definitions
  cisco.nxos.nxos_linkagg:
    aggregate:
    - {group: 3}
    - {group: 100, min_links: 3}

- name: Remove aggregate of linkagg definitions
  cisco.nxos.nxos_linkagg:
    aggregate:
    - {group: 3}
    - {group: 100, min_links: 3}
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
commands list / elements=string	всегда, за исключением платформ, которые используют транспорт Netconf для управления устройством.	Список команд конфигурации, которые необходимо отправить устройству Пример: ['interface port-channel 30', 'lacp min-links 5', 'interface Ethernet2/1', 'channel-group 30 mode active', 'no interface port-channel 30']

Статус

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

Авторы

Trishna Guha (@trishnaguha)

© 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/cisco/nxos/nxos_linkagg_module.html