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

注意

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

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

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

要在 playbook 中使用它，请指定：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 平台选项。

  • 此模块还适用于旧版 playbook 的 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)