ansible模块介绍之ios_facts

2019/04/22 11:49
阅读数 52

一、模块简介

  收集运行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字符串

 

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部