junos_lldp - Управление конфигурацией LLDP на устройствах Juniper JUNOS
Новая версия с 2.4.
Обзор
- Этот модуль предоставляет декларативное управление службой LLDP на устройствах Juniper JUNOS.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| active bool |
| Указывает, активна или деактивирована конфигурация. | |
| hold_multiplier | Указывает количество секунд, в течение которого информация LLDP сохраняется, прежде чем будет удалена. Значение множителя используется совместно со значением interval. | ||
| interval | Частота отправки объявлений LLDP (в секундах). | ||
| 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 гарантирует, что заданная конфигурация LLDP присутствует на устройстве и LLDP включен, для значения absent конфигурация LLDP удаляется, а LLDP выключен. Значение enabled гарантирует, что протокол LLDP включен, и любая конфигурация LLDP, если она присутствует на удаленном устройстве, также конфигурируется, а для значения disabled — что протокол LLDP отключен и любая конфигурация LLDP, если она присутствует. | |
| transmit_delay | Указывает количество секунд, которое устройство ожидает перед отправкой объявлений соседям после изменения в локальной системе. | ||
Примечания
Примечание
- Для работы этого модуля на управляемом удаленном устройстве должна быть включена служба netconf.
- Тестировалось на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Рекомендуемое подключение —
netconf. См. справочник Junos OS Platform Options. - Этот модуль также работает с подключением
localдля устаревших файлов playbooks. - Сведения об использовании командной строки и netconf см. в руководстве Junos OS Platform Options
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible по сетям
- Дополнительную информацию об использовании 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; + } + } |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сетевой, что означает, что он поддерживается командой 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_lldp_module.html