当前位置：首页 > news >正文

做网站公司/谷歌官网入口

news 文章来源：https://blog.csdn.net/2301_78249345/article/details/137127092 2025/2/23 22:24:07

做网站公司,谷歌官网入口,四川住房与城乡建设部网站,百度云虚拟主机playbook的介绍、应用与实施文章目录 playbook的介绍、应用与实施1. 实施playbook1.1 Ansible Playbook与临时命令1.2 格式化Ansible Playbook1.3 运行playbook1.4 提高输出的详细程度1.5 语法验证1.6 执行空运行 2. 实施多个play2.1 缩写多个play2.2 play中的远程用户和特权升…

playbook的介绍、应用与实施

文章目录

playbook的介绍、应用与实施
- 1. 实施playbook
- - 1.1 Ansible Playbook与临时命令
  - 1.2 格式化Ansible Playbook
  - 1.3 运行playbook
  - 1.4 提高输出的详细程度
  - 1.5 语法验证
  - 1.6 执行空运行
- 2. 实施多个play
- - 2.1 缩写多个play
  - 2.2 play中的远程用户和特权升级
  - - 2.2.1 用户属性
    - 2.2.2 特权升级属性
  - 2.3 查找用于任务的模块
  - - 2.3.1 模块文档
    - 2.3.2 Playbook语法变化
    - 2.3.3 过时的“键=值” playbook简写

1. 实施playbook

1.1 Ansible Playbook与临时命令

临时命令可以作为一次性命令对一组目标主机运行一项简单的任务。不过，若要真正发挥Ansible的力量，需要了解如何使用playbook以便轻松重复的方式对一组目标主机执行多项复杂的任务。

play是针对清单中选定的主机运行的一组有序任务。playbook是一个文本文件，其中包含由一个或多个按特定顺序运行的play组成的列表。

Play可以将一系列冗长而复杂的手动管理任务转变为可轻松重复的例程，并且具有可预测的成功成果。在playbook中，可以将play内的任务序列保存为人类可读并可立即运行的形式。根据任务的编写方式，任务本身记录了部署应用或基础架构所需的步骤。

1.2 格式化Ansible Playbook

前面我们学习了临时命令模块，下面以一条命令做为案例来讲解下其在playbook中是如何编写的。

ansible 192.168.116.140 -m user -a 'name=runtime uid=4000 state=present'

这个任务可以将其编写为一个单任务的play并保存在playbook中。生成的playbook如下方所示：

[root@node1 ~]# id tom
id: ‘tom’: no such user[root@controller ~]# vim test.yaml
[root@controller ~]# cat test.yaml
---
- name: create a userhosts: 192.168.116.140tasks:- name: create user user: name: tomuid: 2000state: present
[root@controller ~]# ansible-playbook test.yamlPLAY [create a user] ************************************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
ok: [192.168.116.140]TASK [create user] **************************************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@node1 ~]# id tom
uid=2000(tom) gid=2000(tom) groups=2000(tom)

Playbook是以YAML格式编写的文本文件，通常使用扩展名yml保存。Playbook使用空格字符缩进来表示其数据结构。YAML对用于缩进的空格数量没有严格的要求，但有两个基本的规则：

处于层次结构中同一级别的数据元素（例如同一列表中的项目）必须具有相同的缩进量。
如果项目属于其他项目的子项，其缩进量必须大于父项

只有空格字符可用于缩进，不允许使用tab键。约定俗成的缩进量一般是一级2个空格。

Playbook开头的一行由三个破折号（—）组成，这是文档开始标记。其末尾可能使用三个圆点（…）作为文档结束标记，尽管在实践中这通常会省略。

在这两个标记之间，会以一个play列表的形式来定义playbook。YAML列表中的项目以一个破折号加空格开头。例如，YAML列表可能显示如下：

- apple
- orange
- grape

Play本身是一个键值对集合。同一play中的键应当使用相同的缩进量。以下示例显示了具有三个键的YAML代码片段。前两个键具有简单的值。第三个将含有三个项目的列表作为值。

- name: just an examplehosts: webserverstasks:- first- second- third

作为play中的一部分，tasks属性按顺序实际列出要在受管主机上运行的任务。列表中各项任务本身是一个键值对集合。

还以上面创建用户的play为例，play中唯一任务有两个键：

name是记录任务用途的可选标签。最好命名所有的任务，从而帮助记录自动流程中的每一步用途。
user是要为这个任务运行的模块。其参数作为一组键值对传递，它们是模块的子项（name、uid和state）。

下面再来看一个含有多项任务的tasks属性案例：

tasks:- name: web server is enabledservice:name: httpdenabled: true- name: NTP server is enabledservice:name: chronydenabled: true- name: Postfix is enabledservice:name: postfixenabled: true

playbook中play和任务列出的顺序很重要，因为Ansible会按照相同的顺序运行它们。

1.3 运行playbook

absible-playbook命令可用于运行playbook。该命令在控制节点上执行，要运行的playbook的名称则作为参数传递。

ansible-playbook test.yml

在运行playbook时，将生成输出来显示所执行的play和任务。输出中也会报告执行的每一项任务的结果。

以下示例中显示了一个简单的playbook的内容，后面是运行它的结果。

[root@node1 ~]# rpm -qa|grep httpd //没运行之前啥也没有[root@controller ~]# mkdir httpd
[root@controller ~]# cd httpd
[root@controller httpd]# vim apache.yaml
[root@controller httpd]# cat apache.yaml
---
- name: bushu httpd fuwuhosts: 192.168.116.140tasks:- name: anzhaung httpd fuwu yum:name: httpdstate: present- name: kaiqi httpd fuwuservice:name: httpdstate: started- name: set httpd enableservice:name: httpdenabled: yes
[root@controller httpd]# ansible-playbook apache.yamlPLAY [bushu httpd fuwu] *********************************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
ok: [192.168.116.140]TASK [anzhaung httpd fuwu] ******************************************************************************************************
changed: [192.168.116.140]TASK [kaiqi httpd fuwu] *********************************************************************************************************
changed: [192.168.116.140]TASK [set httpd enable] *********************************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=4    changed=3    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@node1 ~]# rpm -qa|grep httpd       //运行之后
httpd-tools-2.4.57-5.el9.x86_64
httpd-filesystem-2.4.57-5.el9.noarch
rocky-logos-httpd-90.14-2.el9.noarch
httpd-core-2.4.57-5.el9.x86_64
httpd-2.4.57-5.el9.x86_64
[root@node1 ~]# systemctl status httpd
● httpd.service - The Apache HTTP ServerLoaded: loaded (/usr/lib/systemd/system/httpd.service; enabled; preset: disabled)Active: active (running) since Sat 2023-12-23 16:40:10 CST; 1min 28s agoDocs: man:httpd.service(8)Main PID: 713843 (httpd)Status: "Total requests: 0; Idle/Busy workers 100/0;Requests/sec: 0; Bytes served/sec:   0 B/sec"Tasks: 213 (limit: 10820)Memory: 41.6MCPU: 171msCGroup: /system.slice/httpd.service├─713843 /usr/sbin/httpd -DFOREGROUND├─714844 /usr/sbin/httpd -DFOREGROUND├─714845 /usr/sbin/httpd -DFOREGROUND├─714846 /usr/sbin/httpd -DFOREGROUND└─714847 /usr/sbin/httpd -DFOREGROUND

请注意，在playbook运行时，屏幕中会显示每个play和任务的name键的值。（Gathering Facts任务是一项特别的任务，setup模块通常在play启动时自动运行这项任务。）对于含有多个play和任务的playbook，设置name属性后可以更加轻松地监控playbook执行的进展。

通常而言，Ansible Playbook中的任务是幂等的，而且能够安全地多次运行playbook。如果目标受管主机已处于正确的状态，则不应进行任何更改。如果再次运行这个playbook，所有任务都会以状态OK传递，且不报告任何更改。

1.4 提高输出的详细程度

ansible-playbook命令提供的默认输出不提供详细的任务执行信息。ansible-playbook -v命令提供了额外的信息，总共有四个级别。

配置Playbook执行的输出详细程序

选项	描述
-v	显示任务结果
-vv	任务结果和任务配置都会显示
-vvv	包含关于与受管主机连接的信息
-vvvv	增加了连接插件相关的额外详细程序选项，包括受管主机上用于执行脚本的用户以及所执行的脚本

下面来演示一下效果

//一个v
[root@controller httpd]# ansible-playbook -v apache.yaml
Using /etc/ansible/ansible.cfg as config filePLAY [bushu httpd fuwu] *********************************************************************************************************TASK [Gathering Facts] *********************************************************************************************************
ok: [192.168.116.140]TASK [anzhaung httpd fuwu] ******************************************************************************************************
ok: [192.168.116.140] => {"changed": false, "msg": "Nothing to do", "rc": 0, "results": []}TASK [kaiqi httpd fuwu] *********************************************************************************************************
ok: [192.168.116.140] => {"changed": false, "name": "httpd", "state": "started", "status": {"AccessSELinuxContext": "system_u:object_r:httpd_unit_file_t:s0", "ActiveEnterTimestamp": "Sat 2023-12-23 16:40:10 CST", "ActiveEnterTimestampMonotonic": "17391422769
.....................     //内容有点多省略了
PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=4    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   //两个vv
[root@controller httpd]# ansible-playbook -vv apache.yaml
ansible-playbook 2.9.27config file = /etc/ansible/ansible.cfgconfigured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']ansible python module location = /usr/lib/python3.6/site-packages/ansibleexecutable location = /usr/bin/ansible-playbookpython version = 3.6.8 (default, Dec  5 2019, 15:45:45) [GCC 8.3.1 20191121 (Red Hat 8.3.1-5)]
Using /etc/ansible/ansible.cfg as config file
Skipping callback 'actionable', as we already have a stdout callback.
Skipping callback 'counter_enabled', as we already have a stdout callback.
Skipping callback 'debug', as we already have a stdout callback.
Skipping callback 'dense', as we already have a stdout callback.
Skipping callback 'dense', as we already have a stdout callback.
Skipping callback 'full_skip', as we already have a stdout callback.
Skipping callback 'json', as we already have a stdout callback.
Skipping callback 'minimal', as we already have a stdout callback.
Skipping callback 'null', as we already have a stdout callback.
Skipping callback 'oneline', as we already have a stdout callback.
Skipping callback 'selective', as we already have a stdout callback.
Skipping callback 'skippy', as we already have a stdout callback.
Skipping callback 'stderr', as we already have a stdout callback.
Skipping callback 'unixy', as we already have a stdout callback.
Skipping callback 'yaml', as we already have a stdout callback.PLAYBOOK: apache.yaml ***********************************************************************************************************
1 plays in apache.yamlPLAY [bushu httpd fuwu] *********************************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
task path: /root/httpd/apache.yaml:2
....................         //省略
PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=4    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   //三个vvv
[root@controller httpd]# ansible-playbook -vvv apache.yaml//四个vvvv
[root@controller httpd]# ansible-playbook -vvvv apache.yaml

1.5 语法验证

在执行playbook之前，最好要进行验证，确保其内容的语法正确无误。ansible-playbook命令提供了一个–syntax-check选项，可用于验证playbook的语法。

下例演示了一个playbook成功通过语法验证：

[root@controller httpd]# ansible-playbook --syntax-check apache.yamlplaybook: apache.yaml

语法验证失败时，将报告语法错误。输出中包含语法问题在playbook中的大致位置。

下例演示了一个playbook语法验证失败的情况：

[root@controller httpd]# vim apache.yaml
[root@controller httpd]# cat apache.yaml
---
- name: bushu httpd fuwuhosts: 192.168.116.140tasks:                //这里多了一个空格测试语法- name: anzhaung httpd fuwu yum:name: httpdstate: present- name: kaiqi httpd fuwuservice:name: httpdstate: started- name: set httpd enableservice:name: httpdenabled: yes
[root@controller httpd]# ansible-playbook --syntax-check apache.yaml
ERROR! We were unable to read either as JSON nor YAML, these are the errors we got from each:
JSON: Expecting value: line 1 column 1 (char 0)Syntax Error while loading YAML.mapping values are not allowed in this contextThe error appears to be in '/root/httpd/apache.yaml': line 4, column 9, but may
be elsewhere in the file depending on the exact syntax problem.The offending line appears to be:hosts: 192.168.116.140tasks:^ here

1.6 执行空运行

可以使用-C选项对playbook执行空运行。这会使Ansible报告在执行该playbook时将会发生什么更改，但不会对受管主机进行任何实际的更改。

下例演示了一个playbook的空运行，它包含单项任务，可确保在受管主机上安装了最新版本的httpd软件包。注意该空运行报告此任务会对受管主机产生的更改。

[root@node1 ~]# rpm -qa | grep vsftpd  //没安装之前啥也没有[root@controller ~]# vim vsftpd.yaml
[root@controller ~]# cat vsftpd.yaml
---
- name: bushu vsftpd fuwuhosts: 192.168.116.140tasks: - name: anzhuang vsftpd fuwuyum: name: vsftpdstate: present
[root@controller ~]# ansible-playbook -C vsftpd.yamlPLAY [bushu vsftpd fuwu] ********************************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
ok: [192.168.116.140]TASK [anzhuang vsftpd fuwu] *****************************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@node1 ~]# rpm -qa | grep vsftpd  //还是啥也没有[root@controller ~]# ansible-playbook vsftpd.yaml       //没加-CPLAY [bushu vsftpd fuwu] ********************************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
ok: [192.168.116.140]TASK [anzhuang vsftpd fuwu] *****************************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@node1 ~]# rpm -qa | grep vsftpd
vsftpd-3.0.5-5.el9.x86_64

2. 实施多个play

2.1 缩写多个play

Playbook是一个YAML文件，含有由一个或多个play组成的列表。记住一个play按顺序列出了要对清单中的选定主机执行的任务。因此，如果一个playbook中有多个play，每个play可以将其任务应用到单独的一组主机。

在编排可能涉及对不同主机执行不同任务的复杂部署时，这会大有帮助。我们可以这样进行编写：对一组主机运行一个play，完成后再对另一组主机运行另一个play。

缩写包含多个play的playbook非常简单。Playbook中的各个play编写为playbook中的顶级列表项。各个play是含有常用play关键字的列表项。

以下示例显示了含有两个play的简单playbook。第一个play针对192.168.116.140运行，第二个play则针对192.168.116.143运行。

[root@controller ~]# vim httpd.yaml
[root@controller ~]# cat httpd.yaml
---
- name: bushu httpd fuwuhosts: 192.168.116.140tasks:- name: create a httpd fuwuyum:name: httpdstate: present- name: bushu httpdhosts: 192.168.116.143tasks: - name: create a httpd fuwuyum: name: httpdstate: present
[root@controller ~]# ansible-playbook httpd.yamlPLAY [bushu httpd fuwu] *********************************************************************************************************TASK [Gathering Facts] ********************************************************************************************************
ok: [192.168.116.140]TASK [create a httpd fuwu] ******************************************************************************************************
changed: [192.168.116.140]PLAY [bushu httpd] **************************************************************************************************************TASK [Gathering Facts] ********************************************************************************************************
ok: [192.168.116.143]TASK [create a httpd fuwu] ******************************************************************************************************
changed: [192.168.116.143]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
192.168.116.143            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@node1 ~]# rpm -qa | grep httpd
httpd-tools-2.4.57-5.el9.x86_64
httpd-filesystem-2.4.57-5.el9.noarch
rocky-logos-httpd-90.14-2.el9.noarch
httpd-core-2.4.57-5.el9.x86_64
httpd-2.4.57-5.el9.x86_64[root@node2 ~]# rpm -qa | grep httpd
httpd-tools-2.4.57-5.el9.x86_64
httpd-filesystem-2.4.57-5.el9.noarch
rocky-logos-httpd-90.14-2.el9.noarch
httpd-core-2.4.57-5.el9.x86_64
httpd-2.4.57-5.el9.x86_64

2.2 play中的远程用户和特权升级

Play可以将不同的远程用户或特权升级设置用于play，取代配置文件中指定的默认设置。这些在play本身中与hosts或tasks关键字相同的级别上设置。

2.2.1 用户属性

playbook中的任务通常通过与受管主机的网络连接来执行。与临时命令相同，用于任务执行的用户帐户取决于Ansible配置文件/etc/ansible/ansible.cfg中的不同关键字。运行任务的用户可以通过remote_user关键字来定义。不过，如果启用了特权升级，become_user等其他关键字也会发生作用。

如果用于任务执行的Ansible配置中定义的远程用户不合适，可以通过在play中使用remote_user关键字覆盖。

[root@controller ~]# vim test.yaml
[root@controller ~]# cat test.yaml
---
- name: create a userremote_user: root                 //指定用户hosts: 192.168.116.140tasks:- name: create user user: name: tomuid: 2000state: present
[root@controller ~]# ansible-playbook test.yaml
PLAY [create a user] ************************************************************************************************************TASK [Gathering Facts] ********************************************************************************************************
ok: [192.168.116.140]TASK [create user] **************************************************************************************************************
ok: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

2.2.2 特权升级属性

Ansible也提供额外的关键字，从而在playbook内定义特权升级参数。become布尔值关键字可用于启用或禁用特权升级，无论它在Ansible配置文件中的定义为何。它可取yes或true值来启用特权升级，或者取no或false值来禁用它。、

[root@controller ~]# vim test.yaml
[root@controller ~]# cat test.yaml
---
- name: create a userremote_user: rootbecome: no                  //指定是否启用特权hosts: 192.168.116.140tasks:- name: create user user: name: tomuid: 2000state: present
[root@controller ~]# ansible-playbook test.yamlPLAY [create a user] ************************************************************************************************************TASK [Gathering Facts] ********************************************************************************************************
ok: [192.168.116.140]TASK [create user] **************************************************************************************************************
ok: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

如果启用了特权升级，则可以使用become_method关键字来定义特定play期间要使用的特权升级方法。

以下示例中指定sudo用于特权升级：

become_method: sudo

此外，启用了特权升级时，become_user关键字可定义特定play上下文内要用于特权升级的用户帐户。

become_user: privileged_user

2.3 查找用于任务的模块

2.3.1 模块文档

Ansible随附打包的大量模块为管理员提供了许多用于常见管理任务的工具。前面我们介绍了Ansible官方网站的帮助文档链接https://docs.ansible.com/。通过模块索引，可以很轻松的找到对应的模块。例如，适用于用户和服务管理的模块可以在Systems Modules下找到，而适合数据库管理的模块则可在Database Modules下找到。

对于每一个模块，Ansible官网提供了其功能摘要，以及关于如何通过模块的选项来调用各项具体功能的说明。文档还提供了实用的示例，演示各个模块的用法，以及任务中关键字的设置方法。

前面我们用到过ansible-doc -l命令。这将显示模块名称列表以及其功能的概要。

ansible-doc -l

使用ansible-doc [module name]命令来显示模块的详细文档。与Ansible官网一样，该命令提供模块功能的概要、其不同选项的详细信息，以及示例。

ansible-doc yum     # 显示yum模块的帮助文档

ansible-doc命令还提供-s选项，它会生成示例输出，可以充当如何在playbook在使用特定模块的示范。此输出可以作为起步模板，包含在实施该模块以执行任务的playbook中。输出中包含的注释，提醒管理员各个选项的用法。下例演示了yum模块的这种输出：

ansible-doc -s yum

使用ansible-doc命令可以查找和了解如何使用模块。尽管command、shell和raw模块的用法可能看似简单，但在可能时，应尽量避免在playbook中使用它们因为它们可以取胜任意命令，因此使用这些模块时很容易写出非幂等的playbook。

例如，以下使用shell模块的任务为非幂等。每次运行play时，它都会重写/etc/resolv.conf，即使它已经包含了行nameserver 192.168.116.140。

[root@controller ~]# vim test.yaml
[root@controller ~]# cat test.yaml
---
- name: xiang wenjian xieru shujuhosts: 192.168.116.140tasks:- name: xie shujushell: echo 'hello world' > /tmp/abc.txt 
[root@controller ~]# ansible-playbook test.yamlPLAY [xiang wenjian xieru shuju] ************************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
ok: [192.168.116.140]TASK [xie shuju] ****************************************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
[root@controller ~]# ansible 192.168.116.140 -a 'cat /tmp/abc.txt'
192.168.116.140 | CHANGED | rc=0 >>
hello world

可以通过多种方式编写以幂等方式使用shell模块的任务，而且有时候进行这些更改并使用shell是最佳的做法。但更快的方案或许是使用ansible-doc发现copy模块，再使用它获得所需的效果。

在以下示例中，如果/etc/resolv.conf文件已包含正确的内容，则不会重写该文件：

[root@controller ~]# ansible 192.168.116.140 -m shell -a 'cat /etc/hosts'
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
192.168.116.140 | CHANGED | rc=0 >>
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
[root@controller ~]# vim test.yaml
[root@controller ~]# cat test.yaml
---
- name: fuzhi yige wenjianhosts: 192.168.116.140tasks:- name: xiang mubiao wenjian fuzhi neironcopy:dest: /etc/hostscontent: '192.168.116.140 node1\n'
[root@controller ~]# ansible-playbook test.yamlPLAY [fuzhi yige wenjian] *******************************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
ok: [192.168.116.140]TASK [xiang mubiao wenjian fuzhi neiron] ****************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@controller ~]# ansible 192.168.116.140 -m shell -a 'cat /etc/hosts'
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
192.168.116.140 | CHANGED | rc=0 >>
192.168.116.140 node1

copy模块可以测试来了解是否达到了需要的状态，如果已达到，则不进行任何更改。shell模块容许非常大的灵活性，但需要格外小心，从而确保它以幂等方式运行。

幂等的playbook可以重复运行，确保系统处于特定的状态，而不会破坏状态已经正确的系统。

2.3.2 Playbook语法变化

YAML注释
注释也可以用于提高可读性。在YAML中，编号或井号字符（#）右侧的所有内容都是注释。如果注释的左侧有内容，请在该编号符号的前面加一个空格。

# This is a YAML comment
some data # This is also a YAML comment

YAML字符串
YAML中的字符串通常不需要放在引号里，即使字符串中包含空格。字符串可以用双引号或单引号括起。

this is a string'this is another string'"this is yet another a string"

编写多行字符串有两种方式。可以使用管道符表示要保留字符串中的换行字符。

[root@controller ~]# vim test.yaml
[root@controller ~]# cat test.yaml
---
- name: xiang wenjian xieru neironhosts: 192.168.116.140tasks:- name: xiang wenjian xieru neironcopy: dest: /tmp/123content: |hello worldhello chinahello wuhan
[root@controller ~]# ansible-playbook test.yamlPLAY [xiang wenjian xieru neiron] ***********************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
ok: [192.168.116.140]TASK [xiang wenjian xieru neiron] ***********************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@controller ~]# ansible 192.168.116.140 -a 'cat /tmp/123'
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
192.168.116.140 | CHANGED | rc=0 >>
hello world
hello china
hello wuhan

要编写多行字符串，还可以使用大于号字符来表示换行字符转换成空格并且行内的引导空白将被删除。这种方法通常用于将很长的字符串在空格字符处断行，使它们跨占多行来提高可读性。

[root@controller ~]# vim test.yaml
[root@controller ~]# cat test.yaml
---
- name: xiang wenjian xieru neironhosts: 192.168.116.140tasks:- name: xiang wenjian xieru neironcopy: dest: /tmp/123content: >hello worldhello chinahello wuhan
[root@controller ~]# ansible-playbook test.yamlPLAY [xiang wenjian xieru neiron] ***********************************************************************************************TASK [Gathering Facts] **********************************************************************************************************
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
ok: [192.168.116.140]TASK [xiang wenjian xieru neiron] ***********************************************************************************************
changed: [192.168.116.140]PLAY RECAP **********************************************************************************************************************
192.168.116.140            : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   [root@controller ~]# ansible 192.168.116.140 -a 'cat /tmp/123'
[WARNING]: Platform linux on host 192.168.116.140 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.
192.168.116.140 | CHANGED | rc=0 >>
hello world hello china hello wuhan

YAML字典
下面是一个简单的字典形式：

name: svcrole
svcservice: httpd
svcport: 80

字典也可以使用以大括号括起的内联块格式编写，如下所示：

{name: svcrole, svcservice: httpd, svcport: 80}

大多数情况下应避免内联块格式，因为其可读性较低。不过，至少有一种情形中会较常使用它。当playbook中包含角色列表时，较常使用这种语法，从而更加容易区分play中包含的角色和传递给角色的变量。

YAML列表
最简单的列表如下：

hosts:- servera- serverb- serverc

列表也有以中括号括起的内联格式，如下所示：

hosts: [servera, serverb, serverc]

我们应该避免使用此语法，因为它通常更难阅读。

2.3.3 过时的“键=值” playbook简写

某些playbook可能使用较旧的简写方法，通过将模块的键值对放在与模块名称相同的行上来定义任务。例如，你可能会看到这种语法：

tasks:- name: shorthand formservice: name=httpd enabled=true state=started

通常我们应该将这样的语法编写为如下所示：

tasks:- name: normal formservice:name: httpdenabled: truestate: started

通常我们应避免简写形式，而使用普通形式。

普通形式的行数较多，但更容易操作。任务的关键字垂直堆叠，更容易区分。阅读play时，眼睛直接向一扫视，左右运动较少。而且，普通语法是原生的YAML。

你可能会在文档和他人提供的旧playbook中看到这种语法，而且这种语法仍然可以发挥作用。