Spec-Zone.ru › Ansible 2.10

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

Примечание

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

Для его установки используйте: 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
Включает/отключает шлюз-партнера
pkl_dest
string
IP-адрес назначения (удаленный), используемый для соединения peer keepalive
pkl_dest требуется всякий раз, когда используются параметры pkl.
pkl_src
string
IP-адрес источника, используемый для соединения peer keepalive
pkl_vrf
string
VRF, используемый для соединения peer keepalive
VRF должен существовать на устройстве перед использованием pkl_vrf.
(Примечание) 'default' - перегруженное понятие: по умолчанию для контекста pkl_vrf используется 'management'; 'pkl_vrf: default' относится к буквальному 'default' rib.
provider
dictionary
Устарело
Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli
Начиная с Ansible 2.6, для NX-API рекомендуется использовать connection: httpapi
Эта опция будет удалена в релизе после 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
Приоритет системы устройства. Имейте в виду, что они должны совпадать между партнерами.

Примечания

Примечание

  • Проверено на 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
  • Дополнительную информацию об использовании 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/nxos/nxos_vpc_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API