junos_facts - Сбор фактов с удалённых устройств, работающих под Juniper Junos
Новое в версии 2.1.
Описание
- Сбор информации о фактах с удалённого устройства, работающего под операционной системой Junos. По умолчанию модуль собирает базовые факты об устройстве для включения в hostvars. Дополнительную информацию о фактах можно собрать, основываясь на настроенных аргументах.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| config_format (добавлен в 2.3) |
| Аргумент config_format определяет формат конфигурации при сериализации выходных данных с устройства. Этот аргумент применим только в том случае, если значение config присутствует в gather_subset. config_format должен поддерживаться версией Junos, работающей на устройстве. Это значение не применимо при извлечении фактов старого стиля, то есть когда значение gather_subset all или ofacts присутствует в значении. | |
| gather_subset (добавлен в 2.3) | Значение по умолчанию: ["!config", "!ofacts"] | При указании этот аргумент ограничит собираемые факты определенным подмножеством. Возможные значения для этого аргумента включают все, аппаратное обеспечение, конфигурацию и интерфейсы. Можно указать список значений для включения более широкого подмножества. Значения также можно использовать с начальным ! для указания того, что определенное подмножество не должно собираться. Для обеспечения обратной совместимости факты старого стиля могут быть получены с помощью значения all; это требует установки junos-eznc в качестве предварительного условия. Действительные значения gather_subset: default, hardware, config, interfaces, ofacts. Если ofacts присутствует в списке, извлекаются факты старого стиля (ключи фактов без префикса «ansible_»), и для этого требуется, чтобы библиотека junos-eznc была установлена на контрольном узле, а учетные данные входа в устройство должны быть указаны в параметре provider. | |
| 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. | ||
Примечания
Примечание
- Убедитесь, что config_format, используемый для извлечения конфигурации с устройства, поддерживается версией Junos, работающей на устройстве.
- При config_format = json конфигурация в результатах будет словарем (а не строкой JSON).
- Этот модуль требует включения сетевой службы netconf на удалённом управляемом устройстве.
- Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Рекомендуемое подключение —
netconf. См. Junos OS Platform Options. - Этот модуль также работает с подключениями
localдля устаревших playbooks. - Для извлечения фактов старого стиля требуется установка библиотеки junos-eznc на контрольном узле и предоставление учетных данных входа в устройство в параметре provider.
- Дополнительная информация об использовании CLI и netconf приведена в руководстве Junos OS Platform Options
- Дополнительная информация об использовании Ansible для управления сетевыми устройствами содержится в руководстве по сетям Ansible
- Дополнительная информация об использовании Ansible для управления сетевыми устройствами Juniper содержится в https://www.ansible.com/ansible-juniper.
Примеры
- name: collect default set of facts
junos_facts:
- name: collect default set of facts and configuration
junos_facts:
gather_subset: config
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сетевой, что означает, что его обслуживает команда Ansible по сетевым вопросам. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых командой Ansible по сетевым вопросам, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний
Автор
- Nathaniel Case (@qalthos)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ для улучшения.
© 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_facts_module.html
