ansible模块介绍之ios_facts

一、模块简介

　　收集运行IOS系统的（此处指思科的ios）的远端设备信息

二、模块参数

auth_pass   #特权密码,如果参数authorize=no，则不会检索此密码，如果任务task不指定，则默认使用环境变量ANSIBLE_NET_AUTH_PASS代替
authorize   #是否进入特权模式，yes是;no不是。如果任务task不指定，则默认使用环境变量ANSIBLE_NET_AUTHORIZE 代替
gather_subset   #限定取的子集范围，可跟范围:all(所有设备信息),config(配置信息),hardware(硬件信息),interfaces(接口信息)，默认是!config不收集配置信息
provider    #包含连接详情的对象，此处称它位母参数,可接如下子参数
    auth_pass   #与上面效果一致
    authorize   #与上面效果一致
    host        #【必填】指定远程设备的ip地址或名字，用于传输的目的地址
    username    #远程设备登录用户名
    password    #远程设备登录密码
    port        #ssh的端口，默认22
    ssh_keyfile #指定用于与远程设备认证用的ssh密钥，填写的是密钥存放在本地路径，如果任务task不指定，则默认使用环境变量ANSIBLE_NET_SSH_KEYFILE代替
    timeout     #超时时间，默认10s

三、模块使用注意事项

　　 暂无

四、模块使用实例

　　需求1：收集远端设备硬件信息（使用ad-hoc方式）

　　命令：ansible 192.168.62.41 -c local -m ios_facts -a "auth_pass=cisco authorize=yes gather_subset=hardware" -u cisco -k

　　结果：

　　需求2：收集远端设备硬件信息（使用playbook方式）

　　步骤1：创建ios_facts_info.yaml文件

　　步骤2：编辑vim ios_facts_info.yaml文件（此处使用vim是因为他可以对yaml的关键字高亮显示，对于排除格式错误有很大帮助）,并保存

---
  - hosts: 192.168.62.41
    connection: local

    tasks:
      - name: use ios_facts to gather info
        ios_facts:
            gather_subset: hardware
            authorize: yes
            auth_pass: cisco
            provider:
              username: cisco
              password: cisco
              host: 192.168.62.41
        register: facts_output

      - name: debug the result
        debug:
            msg: "{{facts_output}}"

　　步骤3:执行剧本  ansible-playbook ios_facts_info.yaml

五、模块返回内容字段介绍

ansible_net_all_ipv4_addresses  # 设备上所有ipv4的地址，返回值list列表形式
ansible_net_all_ipv6_addresses  # 设备上所有ipv6的地址，返回值list列表形式
ansible_net_config  # 设备上的配置信息，返回值是string字符串
ansible_net_filesystems # 设备上的文件系统，返回值是list列表形式，如,unix系统
ansible_net_filesystems_info  #设备上的文件信息的哈希值，返回值是dict字典形式，如空闲和总空间
ansible_net_gather_subset   #收集设备上的子集范围，返回值list列表形式，eg:["hardware", "default", "interfaces", "config"]
ansible_net_hostname      #显示设备主机名，返回值string字符串
ansible_net_image         #设备正在运行的镜像文件全路径，返回值是string字符串
ansible_net_interfaces    #设备上的接口配置信息，返回值是dict字典
ansible_net_memfree_mb    #设备的可用存储空间，单位Mb,返回值integer数值形式
ansible_net_memtotal_mb   #设备的总共存储空间，单位Mb,返回值integer数值形式
ansible_net_model         #设备型号，返回值string字符串
ansible_net_serialnum     #设备序列号，返回值string字符串
ansible_net_stacked_models  #每台设备的堆叠产品型号，返回值list列表
ansible_net_stacked_serialnums  #堆叠设备的每一台序列号，返回值list列表
ansible_net_version     #设备系统版本，返回值string字符串