Spec-Zone.ru › Ansible 2.6

junos_interface - Управление интерфейсами на сетевых устройствах Juniper JUNOS

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

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

Обзор

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

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • ncclient (>=v0.5.2)

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
active
bool
    Варианты:
  • нет
  • да ←
Указывает, активна или деактивирована конфигурация
aggregate
Список определений интерфейсов.
delay По умолчанию:
10
Время в секундах ожидания перед проверкой операционного состояния на удаленном устройстве. Это ожидание применимо к параметру операционного состояния, которое имеет значения up/down, tx_rate и rx_rate.
description
Описание интерфейса.
duplex
    Варианты:
  • полный
  • полудуплексный
  • авто ←
Статус соединения интерфейса.
enabled
Настройка статуса соединения интерфейса.
mtu
Максимальный размер передаваемого пакета.
name
обязательно
Имя интерфейса.
neighbors
Проверка операционного состояния заданного интерфейса name для соседа LLDP.
Доступны следующие подпараметры.
host
Хост соседа LLDP для данного интерфейса name.
port
Порт соседа LLDP, к которому подключен данный интерфейс name.
provider
Устарело
Начиная с Ansible 2.5, рекомендуем использовать connection: network_cli или connection: netconf.
Дополнительную информацию см. в руководстве Junos OS Platform Options.
Объект типа dict, содержащий данные подключения.
host
обязательно
Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
port По умолчанию:
22
Указывает порт для подключения к удаленному устройству. По умолчанию используется стандартный порт SSH 22 (для transport=cli) или порт 830 (для transport=netconf) устройства.
username
Настройка имени пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_USERNAME.
password
Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_PASSWORD.
timeout По умолчанию:
10
Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истечет до завершения операции, модуль выдаст ошибку.
ssh_keyfile
Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_SSH_KEYFILE.
rx_rate
Скорость приема в битах в секунду (бит/с).
Этот параметр используется только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в сетевых модулях
speed
Скорость интерфейса.
state
    Варианты:
  • present ←
  • absent
  • включено
  • выключено
Состояние конфигурации интерфейса, up указывает на наличие и оперативное включение, а down указывает на наличие и оперативное down
tx_rate
Скорость передачи в битах в секунду (бит/с).
Этот параметр используется только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в сетевых модулях

Примечания

Примечание

  • Для работы этого модуля на удаленном управляемом устройстве должна быть включена служба netconf.
  • Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
  • Рекомендуемое подключение — netconf. См. руководство по параметрам платформы Junos OS.
  • Этот модуль также работает с подключениями local для устаревших playbooks.
  • Дополнительную информацию об использовании CLI и netconf см. в руководстве Параметры платформы Junos OS
  • Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Руководство по сетям Ansible
  • Дополнительную информацию об использовании Ansible для управления устройствами Juniper см. на сайте https://www.ansible.com/ansible-juniper.

Примеры

- name: configure interface
  junos_interface:
    name: ge-0/0/1
    description: test-interface

- name: remove interface
  junos_interface:
    name: ge-0/0/1
    state: absent

- name: make interface down
  junos_interface:
    name: ge-0/0/1
    enabled: False

- name: make interface up
  junos_interface:
    name: ge-0/0/1
    enabled: True

- name: Deactivate interface config
  junos_interface:
    name: ge-0/0/1
    state: present
    active: False

- name: Activate interface config
  net_interface:
    name: ge-0/0/1
    state: present
    active: True

- name: Configure interface speed, mtu, duplex
  junos_interface:
    name: ge-0/0/1
    state: present
    speed: 1g
    mtu: 256
    duplex: full

- name: Create interface using aggregate
  junos_interface:
    aggregate:
      - name: ge-0/0/1
        description: test-interface-1
      - name: ge-0/0/2
        description: test-interface-2
    speed: 1g
    duplex: full
    mtu: 512

- name: Delete interface using aggregate
  junos_interface:
    aggregate:
      - name: ge-0/0/1
      - name: ge-0/0/2
    state: absent

- name: Check intent arguments
  junos_interface:
    name: "{{ name }}"
    state: up
    tx_rate: ge(0)
    rx_rate: le(0)

- name: Check neighbor intent
  junos_interface:
    name: xe-0/1/1
    neighbors:
    - port: Ethernet1/0/1
      host: netdev

- name: Config + intent
  junos_interface:
    name: "{{ name }}"
    enabled: False
    state: down

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

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

Ключ Возвращаемое значение Описание
diff.prepared
строка
при изменении конфигурации и включенном параметре diff.
Разница в конфигурации до и после применения изменений.

Пример:
[edit interfaces] + ge-0/0/1 { + description test-interface; + }


Статус

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

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

Этот модуль помечен как сетевой, что означает, что он поддерживается командой 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/junos_interface_module.html

Spec-Zone.ru

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