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

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

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

Описание

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

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
config_format - добавлен в 2.3		Варианты: xml text ← set json	Аргумент config_format определяет формат конфигурации при сериализации выходных данных устройства. Этот аргумент применим только в том случае, если значение `config` присутствует в gather_subset. config_format должен поддерживаться версией Junos, работающей на устройстве. Это значение не применимо при получении фактов старого стиля, то есть когда значение `ofacts` присутствует в значении gather_subset.
gather_subset - добавлен в 2.3		Значение по умолчанию: ["!config", "!ofacts"]	При указании этого аргумента фактические данные будут ограничены заданным подмножеством. Возможные значения для этого аргумента включают all, hardware, config и interfaces. Можно указать список значений для включения большего подмножества. Значения также могут быть использованы с начальным `!` для указания того, что определённое подмножество не должно собираться. Для обеспечения обратной совместимости данные фактов старого стиля можно получить, явно добавив `ofacts` в значение, для этого необходимо установить 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. Объект словаря, содержащий данные подключения.
	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`.

Примечания

Примечание

Убедитесь, что config_format, используемый для получения конфигурации с устройства, поддерживается версией Junos, работающей на устройстве.
При config_format = json конфигурация в результатах будет словарем (а не строкой JSON).
Для работы этого модуля необходима служба netconf системы на удалённом управляемом устройстве.
Тестировалось с vSRX JUNOS версией 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение - netconf. См. Руководство по вариантам платформы Junos OS.
Этот модуль также работает с подключениями local для устаревших playbooks.
Для получения фактов старого стиля требуется библиотека junos-eznc, установленная на контрольном узле, и учетные данные входа в устройство, указанные в параметре provider.
Дополнительная информация о использовании CLI и netconf приведена в Руководстве по вариантам платформы Junos OS
Дополнительная информация об использовании 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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается командой Ansible Network. [сеть]

Поддержка Red Hat

Дополнительную информацию о поддержке Red Hat данного модуля можно найти в этой статье из базы знаний Red Hat: статья Red Hat Knowledge Base.

Авторы

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.7/modules/junos_facts_module.html