初识ansible playbook

前面博文中，我们介绍了一些ansible的常用模块，聪明如你，一定已经掌握了这些模块的使用方法。

那么现在，我们来想象一个工作场景，看看怎样把之前的知识点应用到这个工作场景中。

假设，我们想要在test181主机上安装nginx并启动，我们可以在ansible主机中执行如下3条命令！

$ ansible test181 -m yum_repository -a 'name=aliEpel description="alibaba EPEL" baseurl=https://mirrors.aliyun.com/epel/$releasever\Server/$basearch/'

$ ansible test181 -m yum -a 'name=nginx disable_gpg_check=yes enablerepo=aliEpel'

$ ansible test181 -m service -a "name=nginx state=started"

我们通过上述3条命令，先确定配置了对应的yum源，然后使用yum模块安装了nginx，最后使用service模块启动了nginx，最终达到了我们的目的。

但是在实际的工作环境中，我们可能需要经常在新主机上安装nginx，难道每次有新的服务器加入工作环境，我们都要修改上述3条命令中的主机名并且重新将每一条命令执行一遍吗？这样似乎有些麻烦，肯定有更好的办法，没错，我们可以将上述命令写成脚本，每次修改一些变量，然后执行脚本就行了，这样似乎方便了不少，而ansible天生就提供了这种类似脚本的功能，在ansible中，类似脚本的文件被称作剧本，剧本的英文名称为playbook，我们只需要将要做的事情编写成playbook，把不同的模块按照顺序编排在剧本中，ansible就会按照剧本一步一步的执行，最终达到我们的目的，虽然playbook的功能与脚本类似，但是剧本并不是简单的将ad-hoc命令按照顺序堆砌在一个可执行文件中，编写剧本需要遵循YAML语法，如果你没有接触过YAML语法，不用害怕，坚持看完后面的示例，熟悉一些固定套路以后，你也可以自己编写playbook。

那么怎样编写playbook呢？我们先从一个简单的示例开始吧！

首先，我们需要创建一个YAML格式的playbook文件。

playbook文件以.yaml或者.yml作为文件名后缀，此处我们创建一个名为test.yaml的剧本文件。

在编写剧本之前，我们先来回顾两个简单的ad-hoc命令，比如如下两条命令：

$ ansible test181 -m ping
$ ansible test181 -m file -a "path=/testdir/test state=directory"

上述命令表示使用ping模块去ping主机test181，然后再用file模块在test181主机上创建目录，那么，如果把上述命令转换成playbook的表现形式，该如何书写呢？示例如下（此处先进行示例，后文会说明怎样执行playbook）：

如上图所示：

• 第一行使用三个横杠作为开始，在YAML语法中，---表示文档开始；
• 第二行使用-作为开头（注意：横杠后面有空格），如果你了解过YAML语法，那么你一定知道YAML使用-表示一个块序列的节点，如果你不了解YAML语法，不用在此处纠结，先这么写，写的多了，自然会理解，从上例可以看出，-后面使用hosts关键字指定了要操作的主机，hosts关键字对应的值为test181，表示我们要在test181主机上进行操作，hosts: test181是一个键值对，注意，在YAML语法中使用冒号映射键值对时，冒号后面必须有空格，这也是语法，没有为什么，记住就好，如果你想要一次性在多台主机上进行操作，可以同时写多个主机，每台主机使用逗号隔开，比如hosts: test181,test61，如果你在清单中对主机进行了分组，也可以使用组名；
• 第三行，使用remote_user关键字可以指定在进行远程操作时使用哪个用户进行操作，remote_user: root表示test181的root用户进行操作，上图中，remote_user关键字与hosts关键字对齐，表示它们是平级的，之前的文章中提到过，在YAML语法中进行缩进时，不能使用tab键进行缩进，必须使用空格，所以，为了兼容使用tab键进行缩进的使用习惯，可以将vim编辑器设置为自动将tab转成空格；
• 第四行，使用tasks关键字指明要进行操作的任务列表，之后的行都属于tasks键值对中的值；

之后的行都属于tasks任务列表中的任务，可以看出，整个任务列表一共有两个任务组成，每个任务都以-开头，每个任务都有自己的名字，任务名使用name关键字进行指定，第一个任务使用ping模块，使用ping模块时没有指定任何参数。第二个任务使用file模块，使用file模块时，指定了path参数与state参数的值。

好了，test.yaml已经编写完成了，但是，我们还没有运行这个剧本，运行剧本需要使用ansible-playbook命令,示例如下：

如上图所示，playbook执行后返回了一些信息，这些信息是这次剧本运行的概况。

PLAY [test181]表示这次运行的playbook中有一个play是针对test181这台主机运行的，一个playbook是由一个或多个play组成的，这样说可能不太容易理解，那么我们打个比方，一个剧本是由一个或多个桥段组成的，每个桥段都有不同的场景、人物、故事，所有的桥段组合在一起，组成一个完整的剧本，剧本就是playbook，桥段就是play，而上例中，整个剧本中只有一个桥段，也就是说，上例的playbook中，我们只写了一个play，在下文中我们会举例说明怎样书写多个play，到时候你会更加明白到底什么是所谓的play，当然，桥段只是为了方便理解给play起的中文名，官方名称只叫play。

从上述信息可以看出，仅有的这个play是针对test181运行的，这个play一共包含三个任务，第一个任务的名字叫做Gathering Facts，第二个任务的名字叫做Ping the host，第三个任务的名字叫做make directory test，看到此处你会发现，我们在playbook中明明只写了两个任务，为什么最后执行时却有三个任务呢？这是因为，每个play在执行时，都会先执行一个默认任务，这个默认任务就是Gathering Facts，Gathering Facts任务会收集当前play对应的目标主机的相关信息，收集完这些基础信息后，才会执行我们指定的任务，由于上例中，hosts的值只有test181一个主机，所以这个play只针对test181运行，所以Gathering Facts这个任务只收集了test181的相关信息，执行完默认任务后，开始执行Ping the host任务和make directory test任务，由于在执行playbook之前，/testdir/test目录已经存在于test181主机中，所以make directory test任务返回的信息是绿色的，如果对应的目录并不存在，make directory test任务返回的信息应该是黄色的，这是因为幂等性的缘故，前文已经解释过，此处不再赘述。

当playbook中的所有play执行完毕后，在返回信息的PLAY RECAP中可以对所有目标主机的执行情况进行回顾，由于我们的目标主机只有test181一台，所以只看到了test181的执行概括信息。

我们已经执行了一个playbook，这个playbook中只有一个play，我们也可以在这个playbook中多写几个play，示例如下：

如上图所示，上例中有多个play：

• 第一个play针对test181执行，这个play会执行两个任务；
• 第二个play针对test181和test182执行，第二个play只包含一个任务，即在对应的目标主机上创建/tfile文件；
• 第三个play针对test181和test182执行，细心如你一定发现了，当你需要在play中指定多个主机时，有两种语法可以使用，第二个play和第三个play中的语法都可以指定多个主机，第三个play也只包含一个任务，即在test181和test182主机上创建lvzhenjiang用户；

多个play写完以后，我们来运行一下剧本试试：

如上图所示，每个play执行时都会显示当前play对应的目标主机，并且每个play执行时都会先执行默认的facts任务，收集对应目标主机的信息，当所有play都执行完毕后，会出现PLAY RECP，相当于一个小的报告信息，看到这里，你应该已经理解了到底什么是所谓的play了吧。

再次强调一遍，如果你并不是很熟悉YAML语法，你可以不用过于深究YAML语法，只需要死记硬背，记住某些固定套路即可编写playbook，写的多了，自然会对这些语法有所理解的。

如果你的playbook写完了，但是你不能确定playbook文件中是否存在语法错误，那么你可以使用如下命令对playbook进行语法检查。

$ ansible-playbook --syntax-check /root/test.yaml

执行上述命令后，如果只返回了playbook的名称，就表示没有语法错误。

除了对playbook进行语法测试，我们还能够模拟执行playbook，模拟执行并不是真正的执行，只是假装执行一下，playbook中的任务并不会真正在目标主机中运行，所以你可以放心大胆的进行模拟，使用如下命令即可模拟运行playbook，模拟运行功能可以帮助我们预估playbook是否能够正常执行。

$ ansible-playbook --check test.yaml

注意：使用上述命令进行模拟时，一些任务可能会报错，这可能是因为报错的任务在执行时需要依赖之前的其他任务的完成结果，但是因为是模拟执行，所以之前的任务并不会真正的执行，既然之前的任务没有真正的执行，自然不会产生对应的结果，所以后面的任务就报错了，也就是说，我们并不能完全以模拟的反馈结果作为playbook是否能够正常运行的判断依据，只能通过模拟大概的预估一下而已。

有上面的内容作为基础，如下示例是非常容易理解的：

---
- hosts: test181
  remote_user: root
  tasks:
  - name: make testfile
    file:
      path: /testdir/testfile
      state: touch
      mode: 0700

上例中有一个play，这个play针对test181主机运行，这个play的任务列表中只有一个任务，这个任务就是调用file模块，确保/testdir/testfile文件存在并且testfile文件的权限为0700,把上例中的任务列表部分单独截取出来，如下所示：

tasks:
- name: make testfile
  file:
    path: /testdir/testfile
    state: touch
    mode: 0700

正如你所看到的，path: /testdir/testfile表示为file模块的path参数赋值，我们使用冒号(冒号后有空格)对参数赋值。

其实，除了这种使用冒号的方式，我们还可以使用如下格式为模块的参数赋值：

tasks:
- name: make testfile
  file: path=/testdir/testfile state=touch mode=0700

如上所示，我们调用file模块时，设置了三个参数，path参数、state参数、mode参数，为参数赋值时，使用了等号，每个参数之间使用空格隔开，这种格式也是完全正确的，如果你在使用一个模块时设置的参数比较多，那么使用上述格式设置参数时，这些参数可能会挤在一行里面，你也可以把它们分成多行去写，如下例所示：

tasks:
- name: make testfile
  file: path=/testdir/testfile
        state=touch mode=0700

即使把多个参数分行写，也需要注意缩进。

上述书写格式都是0.8版本以后的ansible推荐的书写格式，在0.8版本之前，使用action关键字调用模块，示例如下：

tasks:
- name: make testfile
  action: file path=/testdir/testfile state=touch mode=0700

如上例所示，使用action关键字调用对应的模块，在当前版本中（博客中的ansible版本为2.4）仍然兼容这种语法！

在之前的示例中，我们对每个任务都指定了对应的名称，即每个task都有对应的name，当我们省略name时，默认以当前任务调用的模块的名称作为任务的名称，不过建议不要省略name，因为当任务存在name时，可读性比较高。

在编写任务时，我习惯将name属性写在任务的开头，当然，任务的各个属性并没有严格的顺序要求，如下两种写法的效果是相同的。

# 写法一：
tasks:
- name: make testfile
  file: path=/testdir/testfile
        state=touch
        mode=0700
 
# 写法二：
tasks:
- file: path=/testdir/testfile
        state=touch
        mode=0700
  name: make testfile

各属性顺序虽然没有要求，但是仍然需要严格按照缩进进行对齐！