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

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

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

Описание

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

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний 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.8/modules/junos_facts_module.html