junipernetworks.junos.junos_facts 模块 – 从运行 Juniper Junos 的远程设备收集事实

注意

此模块是 junipernetworks.junos 集合 (版本 9.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install junipernetworks.junos。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。

要在剧本中使用它，请指定：junipernetworks.junos.junos_facts。

junipernetworks.junos 1.0.0 中的新增功能

概要

  • 从运行 Junos 操作系统的远程设备收集事实信息。默认情况下，模块将从设备收集基本事实信息，并将其包含在 hostvars 中。可以根据配置的参数集收集其他事实信息。

要求

执行此模块的主机需要以下要求。

  • ncclient (>=v0.5.2)

参数

参数

注释

available_network_resources

布尔值

设置为 ‘True’ 时，将提供可用于资源模块的网络资源列表。

选项

  • false ← (默认)

  • true

config_format

字符串

config_format 参数指定在序列化设备输出的配置时的格式。此参数仅在gather_subset 中存在 config 值时适用。config_format 应受设备上运行的 junos 版本支持。在获取旧式事实（即当gather_subset 值中存在 ofacts 值时）时，此值不适用。此选项仅对 gather_subset 值有效。

选项

  • "xml"

  • "text" ← (默认)

  • "set"

  • "json"

gather_network_resources

列表 / 元素=字符串

提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值包括 all 和资源（如接口、VLAN 等）。可以指定一个值列表以包含更大的子集。值也可以与初始 ! 一起使用，以指定不应收集特定子集。有效的子集是 ‘all’、‘interfaces’、‘lacp’、‘lacp_interfaces’、‘lag_interfaces’、‘l2_interfaces’、‘l3_interfaces’、‘lldp_global’、‘lldp_interfaces’、‘vlans’。

gather_subset

列表 / 元素=字符串

提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值包括 all、hardware、config、interfaces 和 min。可以指定一个值列表以包含更大的子集。值也可以与初始 ! 一起使用，以指定不应收集特定子集。为了保持向后兼容性，可以通过显式添加 ofacts 到值来检索旧式事实，这需要安装 junos-eznc 作为先决条件。gather_subset 的有效值是 default、hardware、config、interfaces、ofacts。如果 ofacts 出现在列表中，它将获取旧式事实（没有 ‘ansible_’ 前缀的事实键），并且需要安装 junos-eznc 库。

默认值： ["min"]

备注

注意

  • 确保用于从设备检索配置的 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 连接。

  • 有关使用 CLI 和 netconf 的信息，请参阅：ref:`Junos OS 平台选项指南 <junos_platform_options>`

  • 有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南 <network_guide>`

  • 有关使用 Ansible 管理 Juniper 网络设备的更多信息，请参阅 https://ansible.org.cn/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)