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

注意

此模块是 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 的远程设备收集一组基本的设备 facts。此模块将所有基本网络 fact 密钥的开头都加上 ansible_net_<fact>。facts 模块将始终从设备收集一组基本的 facts，并且可以启用或禁用其他 facts 的收集。

别名：network.ironware.ironware_facts

参数

参数

注释

authorize

布尔值

已弃用

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

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

<hr>

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

选项

  • false ← (默认)

  • true

gather_subset

字符串

提供此参数时，它会将收集到的 facts 限制为给定的子集。此参数的可能值为 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 地址

已返回：当配置了 interfaces 时

ansible_net_all_ipv6_addresses

列表 / 元素=字符串

设备上配置的所有 IPv6 地址

已返回：当配置了 interfaces 时

ansible_net_config

字符串

设备的当前活动配置

已返回：当配置了 config 时

ansible_net_filesystems

列表 / 元素=字符串

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

已返回：当配置了 hardware 时

ansible_net_gather_subset

列表 / 元素=字符串

从设备收集的 facts 子集列表

已返回：始终返回

ansible_net_interfaces

字典

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

已返回：当配置了 interfaces 时

ansible_net_memfree_mb

整数

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

已返回：当配置了 hardware 时

ansible_net_memtotal_mb

整数

远程设备上的总内存（以 MB 为单位）

已返回：当配置了 hardware 时

ansible_net_model

字符串

从设备返回的型号名称

已返回：始终返回

ansible_net_mpls_lsps

字典

设备上配置的所有 MPLS LSP

已返回：当配置了 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 邻居列表

已返回：当配置了 interfaces 时

ansible_net_serialnum

字符串

远程设备的序列号

已返回：始终返回

ansible_net_version

字符串

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

已返回：始终返回

状态

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

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

作者

  • Paul Baker (@paulquack)