nxos_vrrp — Управляет конфигурацией VRRP на коммутаторах NX-OS.

Новое в версии 2.1.

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

Описание

Управляет конфигурацией VRRP на коммутаторах NX-OS.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
admin_state		выключено не выключено ←	Используется для включения или выключения процесса VRRP.
authentication		Значение по умолчанию: Отсутствует	Строка аутентификации в открытом виде.
group обязательно			Номер группы VRRP.
interface обязательно			Полное имя интерфейса, который управляется для VRRP.
preempt		True False	Включение/выключение предвосхищения.
priority		Значение по умолчанию: Отсутствует	Приоритет VRRP.
provider		Значение по умолчанию: Отсутствует	Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр необходим только при использовании NX-API. Для получения дополнительной информации см. руководство NXOS Platform Options. Объект словаря, содержащий данные подключения.
	username		Настройка имени пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_USERNAME`.
	authorize (добавлено в 2.5.3)	нет ← да	Указывает модулю перейти в привилегированный режим на удаленном устройстве перед отправкой каких-либо команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот параметр используется только для транспорта cli. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	use_proxy (добавлено в 2.5)	да ← нет	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	auth_pass (добавлено в 2.5.3)	Значение по умолчанию: нет	Указывает пароль для использования, если необходимо перейти в привилегированный режим на удаленном устройстве. Если authorize равно false, то этот параметр ничего не делает. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение хоста используется в качестве адреса назначения для транспорта.
	timeout (добавлено в 2.3)	Значение по умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать данные при выполнении длительных команд (sh mac, sh bgp и т. д.).
	use_ssl	да нет ←	Настраивает transport на использование SSL, если установлено в true только при `transport=nxapi`, в противном случае это значение игнорируется.
	password	Значение по умолчанию: Отсутствует	Указывает пароль для аутентификации подключения к удаленному устройству. Это общий параметр, используемый для транспортов cli или nxapi. Если значение не указано в задаче, будет использовано значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	validate_certs	да нет Значение по умолчанию: Отсутствует	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых локальных сайтах с самозаверяющими сертификатами. Если параметр транспорта не nxapi, это значение игнорируется.
	port	Значение по умолчанию: 0 (использовать общий порт)	Указывает порт для подключения к удаленному устройству. Это значение относится к cli или nxapi. Значение порта будет установлено по умолчанию для соответствующего общего порта транспорта, если не указано в задаче (cli = 22, http = 80, https = 443).
	transport обязательно	Значение по умолчанию: cli	Настраивает транспортное подключение для подключения к удаленному устройству. Параметр transport поддерживает подключение к устройству через cli (ssh) или nxapi.
state		наличие ← отсутствие	Указывает желаемое состояние ресурса.
vip		Значение по умолчанию: Отсутствует	Виртуальный IP-адрес VRRP.

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
Функция VRRP должна быть сначала включена в системе.
SVIs должны существовать перед использованием этого модуля.
Интерфейс должен быть портом L3 перед использованием этого модуля.
state=absent удаляет группу VRRP, если она существует на устройстве.
VRRP не может быть настроен на интерфейсах loopback.
Для получения информации об использовании CLI и NX-API см. руководство по параметрам платформы NXOS
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. руководство по сети Ansible
Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco.

Примеры

- name: Ensure vrrp group 100 and vip 10.1.100.1 is on vlan10
  nxos_vrrp:
    interface: vlan10
    group: 100
    vip: 10.1.100.1

- name: Ensure removal of the vrrp group config
  # vip is required to ensure the user knows what they are removing
  nxos_vrrp:
    interface: vlan10
    group: 100
    vip: 10.1.100.1
    state: absent

- name: Re-config with more params
  nxos_vrrp:
    interface: vlan10
    group: 100
    vip: 10.1.100.1
    preempt: false
    priority: 130
    authentication: AUTHKEY

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

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

Ключ	Возвращаемое значение	Описание
commands список	всегда	Отправленные на устройство команды Пример: ['interface vlan10', 'vrrp 150', 'address 10.1.15.1', 'authentication text testing', 'no shutdown']

Статус

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

Поддержка

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье Knowledge Base.

Автор

Jason Edelman (@jedelman8)
Gabriele Gerbino (@GGabriele)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/nxos_vrrp_module.html