上章节我们已知道，当我们使用ansible完成任务时，需要使用的是ansible的各个模块。（如上章节我们使用的ping 模块）

除开ping模块，ansible还有很多的模块可供我们使用，那么ansible终究有多少模块可供使用？ 那我们可以借助下面的命令来查看ansible具体有哪些模块

• 模块查看命令 ansible-doc -l
  

  空格下翻未显示内容

• 如若通过此类方法ansible-doc -l查询每个命令使用方法，不是非常详细，如果要各模块更加详细的使用方法那么需要使用 ansible-doc -s

  • 举个栗子 如若我们查看ping的具体使用方法 那么我们使用命令ansible-doc -s ping如下图
    
    展示ping模块使用具体说明

  • 举例 如fetch模块，我们来看一下这个是我们经常要用到的模块。fetch-拿来，当我们需要将受管理的文件拉取ansible主机时，则可以使用此模块，首先，我们可以使用“ansible-doc -s fetch”

    
    
    fetch使用说明
  • 从帮助信息中可以看出，fetch模块的作用就“Fecthes a file from remote nodes”,从受管理的的主机中拉取文件，我们可以使用的参数有dest、fail_on_missing、flat、src、validate_checksum,如上图所示，每个参数的作用已有对应的详细说明
  • 测试使用fetch模块
    • 开始之前我们先来配置一下hosts主机清单

all:
children:
  server:
   children:
    serverA:
       hosts:
         192.168.3.41:
    serverB:
       hosts:
         192.168.3.42: 

      - 假如我们将serverA组中的主机的 /etc/fstab文件拉取到本地，则使用如下命令
        ansible serverA -m fetch -a "src=/etc/fstab dest=/testdir/ansible/"
        -m选项用于调用模块 -a选项用于传递模块所需要使用的参数， -a "src=/etc/fstab dest=/test/ansible/"
        表示我们在使用fetch模块时，为fetch模块传入了两个参数，src和dest 即源和目的
        那么我们执行上述命令后，效果如下：

执行结果

• 查看文件是否传到本机，此处说明一下，本机是无/testdir/ansible目录，当拉取成功后ansible会自动创建此目录，而且ansible会自动我们创建对就各个主机的目录，以区分放在不同主机中的同名文件，是不是很方便。如图我们测试后传至本机的结果则为/test/ansible/192.168.3.41/etc/fstab
  
  验证文件正常传送
  • 细心发现个问题执行命令时，上面显示的CHANGED 已改变，字段为TRUE，同时我们也验证拉取到本机的文件了。而不是我们像上面执行结果为success呢？这是为什么？
  • 说到这里时我们来解释一下状态的问题
    • 当返回值信息为绿色时，“changed”为false，表示ansible没有执行任何操作，也就是没有改变什么
    • 当返回值信息为黄色时，“changed”为true，表示ansible执行了操作，“当前状态”已被ansible改变成了“目标状态“。

    • 这里体现出来的问题就是ansible幂等性，当第一次执行上述命令时，ansible发现当前主机中并没有我们要的fstab文件，ansible就会按照我们的指定操作，拉取fstab文件。也就是说ansible“改变”了”当前状态“，将当前”没有fstab文件“的状态改变成了”有fstab文件“的状态。当我们再次执行同样的命令时，ansible发现对应的文件已经存在于对应目录中了，于是ansible并没有做出任务操作，也没有做任何改变，只是”当前状态“已与我们”目标状态“一致，没有必要再做重复性工作了，可参考如下图，第一次执行和第二次执行的对比状态：

      
      
      对比初次执行和第二次执行
    • 细心的话你可以看出，从执行的返回信息中可以看到，当ansible进行fetch操作时，会对应文件进行哈希计算，对应文件进行哈希计算。也就是，如果我们改变了文件内容，那么哈希值也将随之发生改变。这个时候，即使对应目录中存在同名的文件，ansible也会判断出两个不同的文件，因为他们哈希值不同。具体我们来实验一下，在本机添加fstab文件行追加
      echo ' ' >>/testdir/ansible/192.168.3.41/etc/fstab
      
      • 如图，我们在/testdir/ansible/192.168.3.41/etc/fstab文件结尾追加一个空格，以改变其内容，然后很执行fetch后，192.168.3.41返回信息 为changed 证明ansible已做出明确判断，将修过的文件替换了，替换为重新拉取的文件

小结

• 列出ansible所有支持模块 ansible-doc -l
• 查看模块详细信帮助信息，例如 fecth模块帮助 ansible-doc -s fetch
• 调用模块，比如调用ping ansible all -m ping
• 调用模块同时传入模块所需参数，如fetch ansible 192.168.3.41 -m fetch -a "src=/etc/fstab dest=/testdir/ansible"