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

Примечание

Этот плагин входит в коллекцию junipernetworks.junos (версия 1.2.1).

Для его установки используйте: ansible-galaxy collection install junipernetworks.junos

Для использования в плейбуке укажите: junipernetworks.junos.junos_facts

Новое в версии 1.0.0: из junipernetworks.junos

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

Описание

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

Примечание

Этот модуль имеет соответствующий плагин действий.

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
config_format строка		Варианты: xml текст ← set json	Аргумент config_format определяет формат конфигурации при сериализации вывода с устройства. Этот аргумент применим только тогда, когда значение `config` присутствует в gather_subset. config_format должен поддерживаться версией junos, работающей на устройстве. Это значение не применяется при получении фактов старого стиля, то есть когда значение `ofacts` присутствует в значении gather_subset. Этот параметр действителен только для значений `gather_subset`.
gather_network_resources список / элементы=строка			При указании этого аргумента будут ограничены собираемые факты заданным подмножеством. Возможные значения этого аргумента включают все и ресурсы, такие как интерфейсы, VLAN и т. д. Можно указать список значений для включения более широкого подмножества. Значения также могут использоваться с начальным `!` для указания того, что определённое подмножество не должно собираться. Допустимые подмножества: 'all', 'interfaces', 'lacp', 'lacp_interfaces', 'lag_interfaces', 'l2_interfaces', 'l3_interfaces', 'lldp_global', 'lldp_interfaces', 'vlans'.
gather_subset список / элементы=строка		Значение по умолчанию: ["!config"]	При указании этого аргумента будут ограничены собираемые факты заданным подмножеством. Возможные значения этого аргумента включают все, оборудование, конфигурацию и интерфейсы. Можно указать список значений для включения более широкого подмножества. Значения также могут использоваться с начальным `!` для указания того, что определённое подмножество не должно собираться. Для обеспечения обратной совместимости факты старого стиля можно получить, явно добавив `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 целое число		Указывает порт для создания подключения к удалённому устройству. Значение порта по умолчанию — известный порт SSH 22 (для `transport=cli`) или порт 830 (для `transport=netconf`) устройства.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: cli netconf ←	Настраивает транспортное подключение для подключения к удалённому устройству.
	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
  junipernetworks.junos.junos_facts:

- name: collect default set of facts and configuration
  junipernetworks.junos.junos_facts:
    gather_subset: config

- name: Gather legacy and resource facts
  junipernetworks.junos.junos_facts:
    gather_subset: all
    gather_network_resources: all

Авторы

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.10/collections/junipernetworks/junos/junos_facts_module.html