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 |
| Состояние конфигурации интерфейса, 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