junos_lldp – Управление конфигурацией LLDP на устройствах Juniper JUNOS
Новая в версии 2.4.
УСТАРЕЛО
| Удалено в Ansible: | |
|---|---|
| версия: 2.13 | |
| Почему: | Выпущены обновленные модули с большей функциональностью |
| Альтернатива: | Используйте junos_lldp_global вместо этого. |
Описание
- Этот модуль предоставляет декларативное управление службой LLDP на устройствах Juniper JUNOS.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| active
boolean
|
|
Определяет, активна или деактивирована конфигурация | |
| hold_multiplier
-
|
Укажите количество секунд, в течение которых информация LLDP хранится, прежде чем она будет удалена. Значение множителя используется в сочетании со значением interval. |
||
| interval
-
|
Частота отправки объявлений LLDP (в секундах). | ||
| provider
словарь
|
Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf.
Для получения дополнительной информации см. руководство Junos OS Platform Options.
Объект словаря, содержащий данные подключения. |
||
| 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. |
||
| state
-
|
|
Значение present гарантирует, что заданная конфигурация LLDP присутствует на устройстве, и LLDP включен. Для значения absent конфигурация LLDP удаляется, и LLDP находится в выключенном состоянии. Значение enabled гарантирует, что протокол LLDP включен, и любая конфигурация LLDP, если она настроена на удаленном устройстве, сохраняется. Для значения disabled он гарантирует, что протокол LLDP отключен, а любая конфигурация LLDP, если она присутствует, по-прежнему сохраняется. |
|
| transmit_delay
-
|
Укажите количество секунд, которые устройство ожидает, прежде чем отправлять объявления соседям после внесения изменений в локальную систему. | ||
Примечания
Примечание
- Для этого модуля требуется, чтобы служба netconf system была включена на удаленном управляемом устройстве.
- Тестируется на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Рекомендуемое подключение —
netconf. См. Руководство Junos OS Platform Options. - Этот модуль также работает с подключениями
localдля устаревших плейбуков. - Дополнительную информацию об использовании CLI и netconf см. в руководстве Junos OS Platform Options
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
- Дополнительную информацию об использовании Ansible для управления устройствами Juniper см. на странице https://www.ansible.com/ansible-juniper.
Примеры
- name: Enable LLDP service
junos_lldp:
state: enabled
- name: Disable LLDP service
junos_lldp:
state: disabled
- name: Set LLDP parameters
junos_lldp:
interval: 10
hold_multiplier: 5
transmit_delay: 30
state: present
- name: Delete LLDP parameters
junos_lldp:
interval: 10
hold_multiplier: 5
transmit_delay: 30
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в разделе, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff.prepared
строка
|
при изменении конфигурации и включенном параметре diff. | Разница в конфигурации до и после применения изменений. Пример: [edit] + protocols { + lldp { + disable; + } + } |
Статус
- Этот модуль будет удален в версии 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_lldp_module.html