junos_facts - Сбор фактов с удаленных устройств, работающих под управлением Juniper Junos

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

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

Описание

Сбор информации о фактах с удаленного устройства, работающего под управлением операционной системы Junos. По умолчанию модуль собирает базовые факты устройства для включения в hostvars. Дополнительная информация о фактах может быть собрана на основе настроенного набора аргументов.

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
config_format (добавлен в 2.3)		Варианты: xml set text ← json	Аргумент config_format определяет формат конфигурации при сериализации выходных данных с устройства. Этот аргумент применим только когда значение `config` присутствует в gather_subset. config_format должен поддерживаться версией Junos, установленной на устройстве.
gather_subset (добавлен в 2.3)		Значение по умолчанию: !config	При указании этого аргумента, сбор фактов будет ограничен заданным подмножеством. Возможные значения для этого аргумента включают all, hardware, config и interfaces. Можно указать список значений для включения большего подмножества. Значения также могут использоваться с начальным `!` для указания, что определённое подмножество не должно собираться. Для обеспечения обратной совместимости старые типы фактов могут быть получены, используя значение all. Для этого требуется установить junos-eznc как предварительное условие.
provider		Значение по умолчанию: None	Устарело Начиная с Ansible 2.5 рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство Junos OS Platform Options. Объект словаря, содержащий данные подключения.
	username		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение - путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	Значение по умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку.
	password	Значение по умолчанию: None	Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port	Значение по умолчанию: 22	Указывает порт для подключения к удалённому устройству. Порт по умолчанию — 22 (для `transport=cli`) или 830 (для `transport=netconf`) устройства.

Примечания

Примечание

Убедитесь, что используемый 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.
Для получения информации по использованию CLI и netconf см. руководство Junos OS Platform Options
Для получения дополнительной информации о использовании Ansible для управления сетевыми устройствами см. руководство Ansible Network Guide
Для получения дополнительной информации об использовании 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

Статус

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

Поддержка

Для получения дополнительной информации о поддержке этого модуля 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.5/modules/junos_facts_module.html