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

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

УСТАРЕВШЕЕ
Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕВШЕЕ

Удалено в Ansible:
	версия: 2.13
Почему:	Выпущены обновленные модули с расширенными функциями
Альтернатива:	Используйте junos_interfaces вместо этого.

Описание

Этот модуль обеспечивает декларативное управление интерфейсами на устройствах 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 boolean		Варианты: no yes	Настройка состояния связи интерфейса.
mtu -			Максимальный размер передаваемого пакета.
name - / обязательно			Имя интерфейса.
neighbors -			Проверка операционного состояния заданного интерфейса `name` для соседа LLDP. Доступны следующие подопции.
	host -		Хост соседа LLDP для данного интерфейса `name`.
	port -		Порт соседа LLDP, к которому подключен данный интерфейс `name`.
provider словарь			Устаревший Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство Junos OS Platform Options. Объект словаря, содержащий сведения о подключении.
	host строка / обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число	По умолчанию: 22	Указывает порт для подключения к удаленному устройству. Значение порта по умолчанию - 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.
Проверено на 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; + }

Статус

Этот модуль будет удалён в версии 2.13. [устаревший]
Для получения дополнительной информации см. УСТАРЕВШЕЕ.

Авторы

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.9/modules/junos_interface_module.html