cisco.nxos.nxos_vpc – Управляет глобальной конфигурацией VPC

Примечание

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

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

Для использования в плейбуке укажите: cisco.nxos.nxos_vpc.

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

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

Обзор

Управляет глобальной конфигурацией VPC

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auto_recovery boolean		Варианты: no yes	Включает/Отключает автоматическое восстановление на платформах, поддерживающих эту функцию Таймеры не изменяются с помощью этого атрибута Взаимоисключающий с auto_recovery_reload_delay
auto_recovery_reload_delay string			Управляет таймером автовосстановления reload-delay в секундах Взаимоисключающий с auto_recovery
delay_restore string			Управляет командой delay restore и значением конфигурации в секундах
delay_restore_interface_vlan string			Управляет командой delay restore interface-vlan и значением конфигурации в секундах Не поддерживается на всех платформах
delay_restore_orphan_port string			Управляет командой delay restore orphan-port и значением конфигурации в секундах Не поддерживается на всех платформах
domain string / обязательно			Область VPC
peer_gw boolean		Варианты: no yes	Включает/Отключает peer шлюз
pkl_dest string			IP-адрес назначения (удаленный), используемый для peer keepalive link pkl_dest требуется всякий раз, когда используются pkl-опции.
pkl_src string			IP-адрес источника, используемый для peer keepalive link
pkl_vrf string			VRF, используемый для peer keepalive link VRF должен существовать на устройстве перед использованием pkl_vrf. (Примечание) 'default' - перегруженный термин: контекст VRF по умолчанию для pkl_vrf - 'management'; 'pkl_vrf: default' относится к буквальному 'default' rib.
provider dictionary			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Начиная с Ansible 2.6, рекомендуется использовать `connection: httpapi` для NX-API. Этот параметр будет удален в релизе после 2022-06-01. Дополнительную информацию см. в руководстве NXOS Platform Options. Объект словаря, содержащий данные подключения.
	auth_pass string		Указывает пароль для использования, если требуется ввести привилегированный режим на удаленном устройстве. Если authorize false, то этот аргумент ничего не делает. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize boolean	Варианты: no ← yes	Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host string		Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password string		Указывает пароль для аутентификации подключения к удаленному устройству. Это общий аргумент, используемый для транспорта cli или nxapi. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port integer		Указывает порт для создания соединения с удаленным устройством. Это значение относится к cli или nxapi. Значение порта по умолчанию устанавливается для соответствующего порта транспорта, если он не указан в задаче. (cli=22, http=80, https=443).
	ssh_keyfile string		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout integer		Указывает таймаут в секундах для взаимодействия с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль вернет ошибку. NX-API может медленно возвращать результат при выполнении длительных команд (sh mac, sh bgp и т. д.).
	transport string	Варианты: cli ← nxapi	Настраивает транспортное подключение для подключения к удаленному устройству. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy boolean	Варианты: no yes ←	Если `no`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl boolean	Варианты: no ← yes	Настраивает transport на использование SSL, если значение `yes`, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	username string		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs boolean	Варианты: no ← yes	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с самоподписанными сертификатами. Если аргумент transport не nxapi, это значение игнорируется.
role_priority string			Приоритет роли для устройства. Помните, что меньше - лучше.
state string		Варианты: present ← absent	Управляет желаемым состоянием ресурса
system_priority string			Системный приоритет устройства. Помните, что они должны совпадать между peer-устройствами.

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
Функция vpc должна быть включена перед использованием этого модуля
Если используется не vrf управления, vrf должен быть глобально включен на устройстве перед использованием в конфигурации pkl
Хотя IP-адрес источника не требуется в командной строке, он требуется при использовании этого модуля. PKL VRF также должен быть настроен перед использованием этого модуля.
Для изменения PKL VRF необходимы как pkl_src, так и pkl_dest.
Дополнительную информацию об использовании CLI и NX-API см. в руководстве NXOS Platform Options
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco.

Примеры

- name: configure a simple asn
  cisco.nxos.nxos_vpc:
    domain: 100
    role_priority: 1000
    system_priority: 2000
    pkl_dest: 192.168.100.4
    pkl_src: 10.1.100.20
    peer_gw: true
    auto_recovery: true

- name: configure
  cisco.nxos.nxos_vpc:
    domain: 100
    role_priority: 32667
    system_priority: 2000
    peer_gw: true
    pkl_src: 10.1.100.2
    pkl_dest: 192.168.100.4
    auto_recovery: true

- name: Configure VPC with delay restore and existing keepalive VRF
  cisco.nxos.nxos_vpc:
    domain: 10
    role_priority: 28672
    system_priority: 2000
    delay_restore: 180
    peer_gw: true
    pkl_src: 1.1.1.2
    pkl_dest: 1.1.1.1
    pkl_vrf: vpckeepalive
    auto_recovery: true

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

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

Ключ	Возвращаемое	Описание
команды список / элементы=строка	всегда	команды, отправленные на устройство Пример: ['vpc domain 100', 'peer-keepalive destination 192.168.100.4 source 10.1.100.20 vrf management', 'auto-recovery', 'peer-gateway']

Авторы

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

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