community.network.ironware_facts 模块 – 从运行 Extreme Ironware 的设备收集事实

注意

此模块是 community.network 集合（版本 5.1.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.network。

要在 playbook 中使用它，请指定：community.network.ironware_facts。

注意

community.network 集合已弃用，并将从 Ansible 12 中删除。有关更多信息，请参阅讨论主题。

已弃用

在以下版本中删除:

版本 6.0.0

原因:

此集合及其中的所有内容都已无人维护并已弃用。

替代方案:

未知。

概要

  • 从运行 Ironware 的远程设备收集基本设备事实集。此模块会在所有基本网络事实键前面加上 ansible_net_<fact>。事实模块将始终从设备收集基本的事实集，并可以启用或禁用其他事实的收集。

别名：network.ironware.ironware_facts

参数

参数

注释

authorize

布尔值

已弃用

从 Ansible 2.7 开始，我们建议使用 connection: network_cli 和 become: true。

有关更多信息，请参阅IronWare 平台选项指南。

<hr>

指示模块在发送任何命令之前在远程设备上进入特权模式。如果未指定，设备将尝试在非特权模式下执行所有命令。如果未在任务中指定值，则将使用环境变量 ANSIBLE_NET_AUTHORIZE 的值。

选择

  • false ← (默认)

  • true

gather_subset

字符串

如果提供，此参数将把收集的事实限制为给定的子集。此参数的可能值包括 all、hardware、config、mpls 和 interfaces。可以指定一个值列表以包括更大的子集。值也可以与初始 ! 一起使用，以指定不应收集特定的子集。

默认： ["!config", "!mpls"]

备注

注意

  • 已针对 Ironware 5.8e 进行测试

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

示例

- name: Collect all facts from the device
  community.network.ironware_facts:
    gather_subset: all

- name: Collect only the config and default facts
  community.network.ironware_facts:
    gather_subset:
      - config

- name: Do not collect hardware facts
  community.network.ironware_facts:
    gather_subset:
      - "!hardware"

返回值

常见的返回值记录在 此处，以下是此模块独有的字段

键

描述

ansible_net_all_ipv4_addresses

列表 / 元素=字符串

设备上配置的所有 IPv4 地址

返回：当配置了接口时

ansible_net_all_ipv6_addresses

列表 / 元素=字符串

设备上配置的所有 IPv6 地址

返回：当配置了接口时

ansible_net_config

字符串

设备中的当前活动配置

返回：当配置了 config 时

ansible_net_filesystems

列表 / 元素=字符串

设备上所有可用的文件系统名称

返回：当配置了 hardware 时

ansible_net_gather_subset

列表 / 元素=字符串

从设备收集的事实子集列表

返回：总是

ansible_net_interfaces

字典

系统上运行的所有接口的哈希

返回：当配置了接口时

ansible_net_memfree_mb

整数

远程设备上以 Mb 为单位的可用空闲内存

返回：当配置了 hardware 时

ansible_net_memtotal_mb

整数

远程设备上以 Mb 为单位的总内存

返回：当配置了 hardware 时

ansible_net_model

字符串

从设备返回的型号名称

返回：总是

ansible_net_mpls_lsps

字典

设备上配置的所有 MPLS LSPs

返回：当配置了 LSP 时

ansible_net_mpls_vll

字典

设备上配置的所有 VLL 实例

返回：当配置了 MPLS VLL 时

ansible_net_mpls_vll_local

字典

设备上配置的所有 VLL-LOCAL 实例

返回：当配置了 MPLS VLL-LOCAL 时

ansible_net_mpls_vpls

字典

设备上配置的所有 VPLS 实例

返回：当配置了 MPLS VPLS 时

ansible_net_neighbors

字典

来自远程设备的 LLDP 邻居列表

返回：当配置了接口时

ansible_net_serialnum

字符串

远程设备的序列号

返回：总是

ansible_net_version

字符串

远程设备上运行的操作系统版本

返回：总是

状态

  • 此模块将在版本 6.0.0 中删除。[已弃用]

  • 更多信息请参阅已弃用。

作者

  • Paul Baker (@paulquack)