05-Ansible模块的基本使用

一、如何使用模块

由前面的学习可知,当我们使用 ansible 完成实际任务时,需要依靠 ansible 的各个模块,比如,我们想要去 ping 某主机,则需要使用 ping 模块,命令如下:

ansible all -m ping

除了 ping 模块,ansible 还有很多模块可供我们使用。我们可以使用如下命令,查看 ansible 都有哪些模块:

[root@ansible-manager ~]# ansible-doc -l
a10_server                                           Manage A10 Networks AX/SoftAX/Thunder/vThunder devices' server object.                                           
a10_server_axapi3                                    Manage A10 Networks AX/SoftAX/Thunder/vThunder devices                                                           
a10_service_group                                    Manage A10 Networks AX/SoftAX/Thunder/vThunder devices' service groups.                                          
a10_virtual_server                                   Manage A10 Networks AX/SoftAX/Thunder/vThunder devices' virtual servers.                                         
accelerate                                           Enable accelerated mode on remote node                                                                           
aci_aaa_user                                         Manage AAA users (aaa:User)                                                                                      
aci_aaa_user_certificate                             Manage AAA user certificates (aaa:UserCert)                                                                      
aci_access_port_to_interface_policy_leaf_profile     Manage Fabric interface policy leaf profile interface selectors (infra:HPortS, infra:RsAccBaseGrp, infra:PortBlk)
aci_aep                                              Manage attachable Access Entity Profile (AEP) objects (infra:AttEntityP, infra:ProvAcc)                          
aci_aep_to_domain                                    Bind AEPs to Physical or Virtual Domains (infra:RsDomP)                                                          
aci_ap                                               Manage top level Application Profile (AP) objects (fv:Ap)                                                        
aci_bd                                               Manage Bridge Domains (BD) objects (fv:BD)                                                                       
aci_bd_subnet                                        Manage Subnets (fv:Subnet)                                                                                       
aci_bd_to_l3out                                      Bind Bridge Domain to L3 Out (fv:RsBDToOut)       
......  

通过上面命令可以看到 ansible 中各个模块的名称,以及模块的大概功能。当然,通过ansible-doc -l命令获取到的模块信息比较概括,并不是特别详细,如果想要获取到各个模块更加详细的用法,可以使用ansible-doc -s命令。比如,我们想要获取 ping 模块的详细使用方法,则可以使用如下命令:

[root@ansible-manager ~]# ansible-doc -s ping
- name: Try to connect to host, verify a usable python and return `pong' on success
  ping:
      data:                  # Data to return for the `ping' return value. If this parameter is set to `crash', the module will cause an exception.

即使使用ansible-doc -s ping命令查看 ping 模块的描述,得到的信息也是比较少的。这是因为 ping 模块本来就比较简单,而且 ping 模块并没有太多参数可用。但是并非所有模块都像 ping 模块一样简单,有的模块在使用时必须使用参数,比如 fetch 模块,fetch 为”拿来”之意,当我们需要将被管理主机中的文件拉取到 ansible 主机时,则可以使用此模块。首先,我们可以使用ansible-doc -s fetch命令,查看一下 fetch 模块的用法:

[root@ansible-manager ~]# ansible-doc -s fetch
- name: Fetches a file from remote nodes
  fetch:
      dest:                  # (required) A directory to save the file into. For example, if the `dest' directory is `/backup' a `src' file named `/etc/profile' on host
                               `host.example.com', would be saved into `/backup/host.example.com/etc/profile'
      fail_on_missing:       # When set to 'yes', the task will fail if the remote file cannot be read for any reason.  Prior to Ansible-2.5, setting this would only fail
                               if the source file was missing. The default was changed to "yes" in Ansible-2.5.
      flat:                  # Allows you to override the default behavior of appending hostname/path/to/file to the destination.  If dest ends with '/', it will use the
                               basename of the source file, similar to the copy module. Obviously this is only handy if the filenames are
                               unique.
      src:                   # (required) The file on the remote system to fetch. This `must' be a file, not a directory. Recursive fetching may be supported in a later
                               release.
      validate_checksum:     # Verify that the source and destination checksums match after the files are fetched.

从帮助信息中可以看出,fetch 模块的作用就是”Fetches a file from remote nodes”,即”从被管理主机中拉取文件”之意,而且 fetch 模块提供了一些参数供我们使用,可用的参数有 destfail_on_missingflatsrcvalidate_checksum ,而且帮助信息中注释了每个参数的作用。

比如 src 参数的作用就是指定从被管理主机中拉取哪个文件。
比如 dest 参数的作用就是指定拉取文件到本地以后文件存放的位置。

dest 参数和 src 参数的注释中都包含”(required)”字样,这表示在使用 fetch 模块时,dest 参数与 src参数是必须提供的,如果在使用 fetch 模块时,没有提供这两个参数,将会报错。想想也对,如果我们想要从远程主机中拉取文件,那么我们必须告诉 ansible,从哪里拉取文件,然后将文件存放到哪里。所以,在学习怎样使用一个模块时,要注意这些必选参数。

现在,我们就以 fetch 模块为例,看看怎样使用带有参数的模块。

首先来看一下主机清单配置:

[demoA]
ansible-demo1
[demoB]
ansible-demo2
ansible-demo3
[demo:children]
demoA
demoB

假如我们想要将 demoB 组中所有主机的 /testdir/testfile1 文件拉取到本地,则可以使用如下命令:

ansible demoB -m fetch -a "src=/testdir/testfile1 dest=/testdir/ansible/"

如上述命令所示,-m 选项用于调用指定的模块,”-m fetch“表示调用 fetch 模块,-a 选项用于传递模块所需要使用的参数, -a "src=/testdir/testfile1 dest=/testdir/ansible/" 表示我们在使用 fetch 模块时,为 fetch 模块传入了两个参数,srcdest

我们看一下上述命令的执行效果:
05-Ansible模块的基本使用_第1张图片

从命令的执行结果可以看出,上述命令执行成功了,因为两个主机对应的返回信息都返回了”SUCCESS”字样。

为什么命令执行成功了,返回的信息却是”黄色”的,在我们的印象中,执行成功,返回的信息不应该是”绿色”的吗?这个后面我们再解释。

从返回信息可以看出,执行上述 ansible 命令后,主机 ansible-demo2 和主机 ansible-demo3 中的文件已经拉取成功,ansible-demo2 的 testfile1 文件被拷贝到了本机的 /testdir/ansible目录中,而且,ansible在 /testdir/ansible 目录中自动创建了目录结构 ansible-demo2/testdir/,由于我们是同时从多台被管理主机中拉取相同名称的文件,所以 ansible 会自动为我们创建各个主机对应的目录,以区分存放不同主机中的同名文件。是不是很方便,很人性化呢?

二、关于幂等性

在00节介绍 ansible 特点时说过,ansible 具有幂等性,幂等性能够保证我们重复的执行一项操作时,得到的结果是相同的,下面详细介绍一下幂等性的概念。

举个例子,你想把一个文件拷贝到目标主机的某个目录上,但是你不确定此目录中是否已经存在此文件,当你使用 ansible 完成这项任务时,就非常简单了,因为如果目标主机的对应目录中已经存在此文件,那么 ansible 则不会进行任何操作,如果目标主机的对应目录中并不存在此文件,ansible 就会将文件拷贝到对应目录中。说白了,ansible 是”以结果为导向的”,我们指定了一个”目标状态”,ansible 会自动判断,”当前状态”是否与”目标状态”一致,如果一致,则不进行任何操作,如果不一致,那么就将”当前状态”变成”目标状态”,这就是”幂等性”,”幂等性”可以保证我们重复的执行同一项操作时,得到的结果是一样的。

现在我们就来实验一下,看看重复执行相同的 ansible 命令时,会得到什么效果,如下图所示:
05-Ansible模块的基本使用_第2张图片
从上图可以看出,返回信息仍然包含”SUCCESS”字样,证明 ansible 命令执行成功,不过很明显,这次的返回信息为”绿色”,而且细心的你一定发现了,这次绿色的返回信息中,”changed” 字段的值为false,而之前黄色的返回信息中,”changed” 字段的值为 true。

当返回信息为绿色时,”changed” 为 false,表示 ansible 没有进行任何操作,没有”改变什么”。
当返回信息为黄色时,”changed” 为 true,表示 ansible 执行了操作,”当前状态”已经被 ansible 改变成了”目标状态”。

这就是幂等性的体现,当第一次执行上述命令时,ansible 发现当前主机中并没有我们需要的 testfile1文件,ansible 就会按照我们指定的操作,拉取 testfile1 文件,也就是说,ansible “改变”了”当前状态”,将当前”没有 testfile1 文件的状态”变为了”有 testfile1 文件的状态”。当我们再次执行同样的命令时,ansible 发现对应文件已经存在于对应目录中,于是 ansible 并没有做出任何操作,也没有进行任何改变,因为”当前状态”与我们预期的”目标状态”一致,没有必要再做出重复的无用功。

看到这里,你应该已经明白,为什么执行 ansible 命令时,会返回黄色的成功信息或者绿色的成功信息了吧?我们可以通过返回信息的颜色,更加精准的判断执行命令之前的状态是否与我们预期的一致。

从返回信息中可以看到,当 ansible 进行 fetch 操作时,会对对应文件进行哈希计算,算出文件哈希值,也就是说,如果我们改变了文件中的内容,哈希值也将随之发生改变,这个时候,即使对应目录中存在同名的文件,ansible 也会判断出两个文件属于不同的文件,因为它们的哈希值并不相同,我们来实验一下,操作如下:
05-Ansible模块的基本使用_第3张图片

如上图所示,我们在 /testdir/ansible/ansible-demo2/testdir/testfile1文件的尾部加入一个”空格”,以改变文件内容,然后又执行了 fetch 命令,结果发现,ansible-demo2 的返回信息为黄色,ansible-demo3 主机的返回信息为绿色,证明 ansible 已经做出了正确的判断,将修改过的文件替换为重新拉取的文件。

三、总结

我们对上面的一些命令进行总结,方便以后回顾:

1.列出ansible所支持的模块。

ansible-doc -l

2.查看模块的详细帮助信息,比如查看 fetch 模块的帮助。

ansible-doc -s fetch

3.调用模块,比如调用 ping模块。

ansible 192.168.128.83 -m ping

4.调用模块的同时传入模块所需要的参数,以 fetch 模块为例。

ansible 192.168.128.83 -m fetch -a "src=/testdir/testfile1 dest=/testdir/ansible/"

关于 ansible 模块的基本使用,我们先介绍到这里。后续将对 ansible 的常用模块进行介绍,首先是 command 模块。

注:本节的大部分文字主要摘抄自下面文档内容(作者写的太精彩了),有部分改动,在这里对原作者深表感谢!

参考文档:
http://www.zsythink.net/archives/2523
《Ansible 权威指南》

你可能感兴趣的:(ansible,Ansible,学习总结)