arista.eos.eos_linkagg – (устаревший, удален после 2022-06-01) Управление группами агрегации каналов на устройствах Arista EOS

Примечание

Этот плагин входит в коллекцию arista.eos (версия 1.3.0).

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

Для использования в книге задач укажите: arista.eos.eos_linkagg.

Новое в версии 1.0.0: of arista.eos

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

УСТАРЕЛО

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

Обзор

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

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate список / элементы=словарь			Список определений агрегации каналов.
	group целое число / обязательно		Номер группы каналов для группы агрегации портов. Диапазон 1-2000.
	members список / элементы=строка		Список членов группы агрегации каналов.
	min_links целое число		Минимальное количество подключенных портов, необходимое для включения группы агрегации каналов.
	mode строка	Варианты: active on passive	Режим работы группы агрегации каналов.
	state строка	Варианты: present absent	Состояние группы агрегации каналов.
group целое число			Номер группы каналов для группы агрегации портов. Диапазон 1-2000.
members список / элементы=строка			Список членов группы агрегации каналов.
min_links целое число			Минимальное количество подключенных портов, необходимое для включения группы агрегации каналов.
mode строка		Варианты: active on passive	Режим работы группы агрегации каналов.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуем использовать `connection: network_cli`. Начиная с Ansible 2.6, рекомендуем использовать `connection: httpapi` для eAPI. Этот параметр будет удалён в версии после 2022-06-01. Дополнительную информацию см. в руководстве EOS Platform Options. Объект словаря, содержащий данные подключения.
	auth_pass строка		Указывает пароль для входа в привилегированный режим на удалённом устройстве. Если authorize – false, этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	authorize булево	Варианты: no ← yes	Инструктирует модуль войти в привилегированный режим на удалённом устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удалённому устройству. Это общий аргумент, используемый для транспортов cli или eapi. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port целое число	По умолчанию: 0	Указывает порт для подключения к удалённому устройству. Это значение относится к cli или eapi. Значение порта будет по умолчанию соответствовать обычному порту транспорта, если не указано в задаче (cli=22, http=80, https=443).
	ssh_keyfile путь		Указывает SSH-ключевой файл для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: cli ← eapi	Настраивает транспортное соединение для подключения к удалённому устройству.
	use_proxy булево	Варианты: no yes ←	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl булево	Варианты: no yes ←	Настраивает transport на использование SSL, если значение установлено в `yes` только при `transport=eapi`. Если аргумент transport не eapi, это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации eAPI в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	validate_certs булево	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах, использующих самозаверенные сертификаты. Если аргумент transport не eapi, это значение игнорируется.
purge булево		Варианты: no ← yes	Удалить ссылки, не определённые в параметре aggregate.
state строка		Варианты: present ← absent	Состояние группы агрегации каналов.

Примечания

Примечание

Проверено на EOS 4.15
Дополнительную информацию об использовании CLI, eAPI и привилегированного режима см. в руководстве EOS Platform Options
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления устройствами Arista EOS см. на странице интеграции Arista.

Примеры

- name: create link aggregation group
  arista.eos.eos_linkagg:
    group: 10
    state: present

- name: delete link aggregation group
  arista.eos.eos_linkagg:
    group: 10
    state: absent

- name: set link aggregation group to members
  arista.eos.eos_linkagg:
    group: 200
    min_links: 3
    mode: active
    members:
    - Ethernet0
    - Ethernet1

- name: remove link aggregation group from Ethernet0
  arista.eos.eos_linkagg:
    group: 200
    min_links: 3
    mode: active
    members:
    - Ethernet1

- name: Create aggregate of linkagg definitions
  arista.eos.eos_linkagg:
    aggregate:
    - {group: 3, mode: on, members: [Ethernet1]}
    - {group: 100, mode: passive, min_links: 3, members: [Ethernet2]}

- name: Remove aggregate of linkagg definitions
  arista.eos.eos_linkagg:
    aggregate:
    - {group: 3, mode: on, members: [Ethernet1]}
    - {group: 100, mode: passive, min_links: 3, members: [Ethernet2]}
    state: absent

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

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

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

Статус

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

Авторы

Trishna Guha (@trishnaguha)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/arista/eos/eos_linkagg_module.html