arista.eos.eos_vrf – Управление VRF на устройствах Arista EOS

Примечание

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

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

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

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

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

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate список / элементы=словарь			Список определений VRF
	associated_interfaces список / элементы=строка		Это опция намерения и проверяет оперативное состояние заданного vrf `name` для ассоциированных интерфейсов. Если значение в `associated_interfaces` не соответствует оперативному состоянию интерфейсов vrf на устройстве, это приведет к ошибке.
	delay целое число	По умолчанию: 10	Время в секундах ожидания перед проверкой оперативного состояния на удаленном устройстве. Это ожидание применимо к аргументам оперативного состояния.
	interfaces список / элементы=строка		Определяет набор интерфейсов, которые должны быть сконфигурированы в VRF. Интерфейсы должны быть маршрутизируемыми для размещения в VRF. Имя интерфейса должно быть в расширенном формате, а не сокращенном.
	name строка / обязательный		Имя VRF.
	rd строка		Маршрутизатор VRF
	state строка	Варианты: present ← absent	Состояние конфигурации VRF.
associated_interfaces список / элементы=строка			Это опция намерения и проверяет оперативное состояние заданного vrf `name` для ассоциированных интерфейсов. Если значение в `associated_interfaces` не соответствует оперативному состоянию интерфейсов vrf на устройстве, это приведет к ошибке.
delay целое число		По умолчанию: 10	Время в секундах ожидания перед проверкой оперативного состояния на удаленном устройстве. Это ожидание применимо к аргументам оперативного состояния.
interfaces список / элементы=строка			Определяет набор интерфейсов, которые должны быть сконфигурированы в VRF. Интерфейсы должны быть маршрутизируемыми для размещения в VRF. Имя интерфейса должно быть в расширенном формате, а не сокращенном.
name строка			Имя VRF.
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 логическое значение	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой каких-либо команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTHORIZE`
	host строка		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение хоста используется в качестве адреса назначения для транспорта.
	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`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl логическое значение	Варианты: нет да ←	Настраивает транспорт transport для использования SSL, если установлено `yes`, только когда `transport=eapi`. Если аргумент транспорта не eapi, это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации eAPI в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`
	validate_certs логическое значение	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с самозаверяющими сертификатами. Если аргумент транспорта не eapi, это значение игнорируется.
purge логическое значение		Варианты: нет ← да	Удаляет VRF, не определённые в параметре aggregate.
rd строка			Маршрутизатор VRF
state строка		Варианты: present ← absent	Состояние конфигурации VRF.

Примечания

Примечание

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

Примеры

- name: Create vrf
  arista.eos.eos_vrf:
    name: test
    rd: 1:200
    interfaces:
    - Ethernet2
    state: present

- name: Delete VRFs
  arista.eos.eos_vrf:
    name: test
    state: absent

- name: Create aggregate of VRFs with purge
  arista.eos.eos_vrf:
    aggregate:
    - {name: test4, rd: 1:204}
    - {name: test5, rd: 1:205}
    state: present
    purge: yes

- name: Delete aggregate of VRFs
  arista.eos.eos_vrf:
    aggregate:
    - name: test2
    - name: test3
    - name: test4
    - name: test5
    state: absent

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

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

Ключ	Возвращаемое	Описание
commands список / элементы=строка	всегда	Список команд режима конфигурации для отправки устройству Пример: ['vrf definition test', 'rd 1:100', 'interface Ethernet1', 'vrf forwarding test']

Авторы

Ricardo Carrillo Cruz (@rcarrillocruz)

© 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/arista/eos/eos_vrf_module.html