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

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

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

Описание

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

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
access_vlan			Настройка указанного VLAN на порте доступа. Значение `access_vlan` должно быть именем VLAN.
active bool		Варианты: нет да ←	Указывает, активна ли конфигурация или отключена
aggregate			Список определений интерфейсов второго уровня.
description			Описание интерфейса.
mode		Варианты: access trunk	Режим, в котором необходимо настроить интерфейс.
name			Имя интерфейса без номера логического блока.
native_vlan			VLAN по умолчанию для настройки на порту trunk. Значение `native_vlan` должно быть идентификатором VLAN.
provider			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство Junos OS Platform Options. Объект словаря, содержащий данные подключения.
	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`.
state		Варианты: present ← absent	Состояние конфигурации интерфейса второго уровня.
trunk_vlans			Список имен VLAN, которые нужно настроить на порту trunk. Значение `trunk_vlans` должно быть списком имен VLAN.
unit		По умолчанию: 0	Номер логического интерфейса. Значение `unit` должно быть целым числом.

Примечания

Примечание

Для работы этого модуля требуется, чтобы служба netconf была включена на управляемом удалённом устройстве.
Тестировалось на vqfx-10000 JUNOS Version 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 in access mode
  junos_l2_interface:
    name: ge-0/0/1
    description: interface-access
    mode: access
    access_vlan: red
    active: True
    state: present

- name: Configure interface in trunk mode
  junos_l2_interface:
    name: ge-0/0/1
    description: interface-trunk
    mode: trunk
    trunk_vlans:
    - blue
    - green
    native_vlan: 100
    active: True
    state: present

- name: Configure interface in access and trunk mode using aggregate
  junos_l2_interface:
    aggregate:
    - name: ge-0/0/1
      description: test-interface-access
      mode: access
      access_vlan: red
    - name: ge-0/0/2
      description: test-interface-trunk
      mode: trunk
      trunk_vlans:
      - blue
      - green
      native_vlan: 100
    active: True
    state: present

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

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

Ключ	Возвращаемое значение	Описание
diff строка	при изменении конфигурации и включенном параметре diff.	Разница в конфигурации до и после применения изменений. Пример: [edit interfaces] + ge-0/0/1 { + description "l2 interface configured by Ansible"; + unit 0 { + family ethernet-switching { + interface-mode access; + vlan { + members red; + } + } + } + }

Статус

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

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

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