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

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

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

Обзор

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

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active boolean		Варианты: no yes ←	Указывает, активна или деактивирована конфигурация
aggregate -			Список определений интерфейсов.
delay -		По умолчанию: 10	Время в секундах, которое необходимо подождать перед проверкой операционного состояния на удаленном устройстве. Этот интервал ожидания применяется к параметрам операционного состояния, которые являются state со значениями `up`/`down`, tx_rate и rx_rate.
description -			Описание интерфейса.
duplex -		Варианты: full half auto ←	Состояние подключения интерфейса.
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 используется в качестве адреса назначения для транспорта.
	password -		Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задании, вместо него будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port -	По умолчанию: 22	Указывает порт, который следует использовать при построении подключения к удаленному устройству. Значение порта по умолчанию — общеизвестный порт SSH 22 (для `transport=cli`) или порт 830 (для `transport=netconf`) устройства.
	ssh_keyfile -		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задании, вместо него будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout -	По умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.
	username -		Указывает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задании, вместо него будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
rx_rate -			Скорость приёма в битах в секунду (бит/с). Этот параметр предназначен только для проверки состояния. Поддерживает условные операторы, см. Условные операторы в сетевых модулях
speed -			Скорость подключения интерфейса.
state -		Варианты: present ← absent up down	Состояние конфигурации интерфейса, `up` указывает на наличие и оперативное включение, а `down` указывает на наличие и оперативное `down`
tx_rate -			Скорость передачи в битах в секунду (бит/с). Этот параметр предназначен только для проверки состояния. Поддерживает условные операторы, см. Условные операторы в сетевых модулях

Примечания

Примечание

Данный модуль требует включения службы netconf system на удалённом управляемом устройстве.
Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое соединение — netconf. См. руководство Junos OS Platform Options.
Этот модуль также работает с соединениями local для устаревших playbooks.
Для получения информации об использовании CLI и netconf см. руководство Junos OS Platform Options
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. руководство Ansible Network Guide
Для получения дополнительной информации об использовании 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; + }

Статус

Гарантированное обратное совместимое интерфейс этого модуля не обеспечивается. [preview]
Этот модуль поддерживается командой Ansible Network. [network]

Поддержка Red Hat

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

Авторы

Ganesh Nalawade (@ganeshrn)

END_OF_DOCUMENT_MARKER

Подсказка

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

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