Spec-Zone.ru › Ansible 2.6

eos_l3_interface - Управление интерфейсами L3 на устройствах Arista EOS.

Новая в версии 2.5.

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
  • Техническое обслуживание
    • Поддержка
    • Автор

Обзор

  • Этот модуль обеспечивает декларативное управление интерфейсами L3 на устройствах Arista EOS.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
aggregate
Список определений интерфейсов L3. Каждая запись в списке aggregate должна определять имя интерфейса name и необязательный ipv4 или ipv6 адрес.
auth_pass
Устарело
Начиная с Ansible 2.5, рекомендуем использовать connection: network_cli и become: yes с become_pass.
Этот параметр требуется только при использовании eAPI.
Дополнительную информацию см. в руководстве EOS Platform Options.
Указывает пароль для входа в привилегированный режим на удаленном устройстве. Если authorize имеет значение false, этот параметр не влияет. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_AUTH_PASS.
authorize
bool
    Варианты:
  • нет ←
  • да
Устарело
Начиная с Ansible 2.5, рекомендуем использовать connection: network_cli и become: yes.
Этот параметр требуется только при использовании eAPI.
Дополнительную информацию см. в руководстве EOS Platform Options.
Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой каких-либо команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_AUTHORIZE.
ipv4
IP-адрес IPv4, который нужно установить для интерфейса L3, указанного в параметре name. Формат адреса: <ip-адрес IPv4>/<маска>, маска — число в диапазоне 0-32, например 192.168.0.1/24.
ipv6
IP-адрес IPv6, который нужно установить для интерфейса L3, указанного в параметре name. Формат адреса: <ip-адрес IPv6>/<маска>, маска — число в диапазоне 0-128, например fd5d:12c9:2201:1::1/64.
name
Имя интерфейса L3, который нужно настроить, например ethernet1.
provider
Устарело
Начиная с Ansible 2.5, рекомендуем использовать connection: network_cli.
Этот параметр требуется только при использовании eAPI.
Дополнительную информацию см. в руководстве EOS Platform Options.
Объект словаря, содержащий данные подключения.
host
обязательно
Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному протоколу. Значение host используется в качестве адреса назначения для протокола.
port По умолчанию:
"0 (используется стандартный порт)"
Указывает порт для подключения к удаленному устройству. Это значение относится к cli или eapi. Значение порта будет по умолчанию соответствовать стандартному порту для соответствующего протокола, если оно не указано в задаче (cli=22, http=80, https=443).
username
Указывает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа по CLI или аутентификации eAPI в зависимости от используемого протокола. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_USERNAME.
password
Указывает пароль для аутентификации подключения к удаленному устройству. Это общий параметр, используемый для протоколов cli или eapi. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_PASSWORD.
timeout По умолчанию:
10
Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку.
ssh_keyfile
Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот параметр используется только для протокола cli. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_SSH_KEYFILE.
authorize
bool
    Варианты:
  • нет ←
  • да
Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_AUTHORIZE.
auth_pass
Указывает пароль для входа в привилегированный режим на удалённом устройстве. Если authorize имеет значение false, этот параметр не влияет. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_AUTH_PASS.
transport
обязательно
    Варианты:
  • eapi
  • cli ←
Указывает протокол подключения к удаленному устройству.
use_ssl
bool
    Варианты:
  • нет
  • да ←
Указывает протоколу transport использовать SSL, если значение равно true только тогда, когда transport=eapi. Если параметр transport не равен eapi, это значение игнорируется.
validate_certs
bool
    Варианты:
  • нет
  • да
Если no, сертификаты SSL не будут проверяться. Это следует использовать только на сайтах, контролируемых лично, которые используют самозаверяющие сертификаты. Если параметр transport не равен eapi, это значение игнорируется.
use_proxy
bool

(добавлено в 2.5)
    Варианты:
  • нет
  • да ←
Если no, переменные среды http_proxy и https_proxy будут проигнорированы.
state
    Варианты:
  • present ←
  • absent
Состояние конфигурации интерфейса L3. Определяет, должна ли конфигурация присутствовать или отсутствовать на удалённом устройстве.

Примечания

Примечание

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

Примеры

- name: Remove ethernet1 IPv4 and IPv6 address
  eos_l3_interface:
    name: ethernet1
    state: absent

- name: Set ethernet1 IPv4 address
  eos_l3_interface:
    name: ethernet1
    ipv4: 192.168.0.1/24

- name: Set ethernet1 IPv6 address
  eos_l3_interface:
    name: ethernet1
    ipv6: "fd5d:12c9:2201:1::1/64"

- name: Set IP addresses on aggregate
  eos_l3_interface:
    aggregate:
      - { name: ethernet1, ipv4: 192.168.2.10/24 }
      - { name: ethernet1, ipv4: 192.168.3.10/24, ipv6: "fd5d:12c9:2201:1::1/64" }

- name: Remove IP addresses on aggregate
  eos_l3_interface:
    aggregate:
      - { name: ethernet1, ipv4: 192.168.2.10/24 }
      - { name: ethernet1, ipv4: 192.168.3.10/24, ipv6: "fd5d:12c9:2201:1::1/64" }
    state: absent

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

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

Ключ Возвращаемое значение Описание
commands
список
всегда, за исключением платформ, использующих протокол Netconf для управления устройством.
Список команд конфигурации, которые нужно отправить устройству.

Пример:
['interface ethernet1', 'ip address 192.168.0.1/24', 'ipv6 address fd5d:12c9:2201:1::1/64']


Статус

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

Техническое обслуживание

Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible по сетевым технологиям. Для получения дополнительной информации см. Поддержка и техническое обслуживание модулей.

Список других модулей, также поддерживаемых командой Ansible по сетевым технологиям, см. в этом месте.

Поддержка

Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, пожалуйста, ознакомьтесь со статьей Базы знаний.

Автор

  • Ganesh Nalawade (@ganeshrn)

Подсказка

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

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

Spec-Zone.ru

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