ansible-playbook的YAML语法学习

YAML:可以将你打算对多机器的批量操作放到一个文件中，顺序执行，可以根据机器做到根据机器信息判断执行，其他命令执行结果判断执行。

YAML有着严格的层级要求，稍微有个缩进问题就会无法运行，所以学习过程中，需要细心观察。

命令      指定hosts文件位置     剧本文件     参数

-C 调试模式，调试剧本是否可以正常运行（这个模式中，任何更改的操作都不会执行）

ansible-playbook     -i hosts    yaml.file
ansible-playbook     -i hosts    yaml.file   -C

　　

剧本开始语法

---                                     #一个标识符，类似#!/bin/bash
- hosts: all                            #此剧本作用域
  remote_user: root                     #使用什么用户运行此剧本
  gather_facts: True                    #在远程主机运行setup模块，并将收集的信息记录起来（等于命令ansible  all -m setup#查看系统信息），可以通过系统信息来判断是否执行
  vars:                                 #定义变量
    variable: values
  tasks:                                #任务开始标签
   - name: task_name
     model_name: values

　　

　　

每一个任务，可以指定一定的操作，定义一个任务基础参数如下

#一个用name模块被'命名'任务下只允许有一个同级的模块存在（不包括辅助功能，后面会讲）

- name: task_name
  model_name: values

yaml语法中结构：

[
{
'name': 'task_name',
'model_name': 'values'
}
]

　　

　　

以下这种情况，命名任务与模块是同级的情况下，可以正常执行，只是不在命名任务模块下的模块执行起来显示的是是模块名称，而不是任务名称（例子1-1），任务多了无法判断

- model_name: values
- name: task_name
  model_name: values
- model_name: values

yaml语法中结构：

[
{'model_name': 'values'},
{
'name': 'task_name',
 'model_name': 'values'
},
{'model_name': 'values'}
]

　　

例子1-1

[root@host1 [::]/yaml/test]#cat test.yaml
---
- hosts: all
  remote_user: root
  gather_facts: True
  tasks:
    - name: "ping test"
      ping:
    - ping:

[root@host1 [::]/yaml/test]#ansible-playbook -i hosts test.yaml  

PLAY [all] ***********************************************************************************************************************************************************

TASK [Gathering Facts] ***********************************************************************************************************************************************
ok: [192.168.100.3]

TASK [ping test] *****************************************************************************************************************************************************
ok: [192.168.100.3]

TASK [ping] **********************************************************************************************************************************************************
ok: [192.168.100.3]

PLAY RECAP ***********************************************************************************************************************************************************
192.168.100.3              : ok=    changed=    unreachable=    failed=   

[root@host1 [::]/yaml/test]#

　　

实际情况演练

新建下方文件：

[root@host1 [::]/yaml/test]#cat test.yaml
---
- hosts: all
  remote_user: root
  gather_facts: True
  tasks:
    - name: "ping test"
      ping:

上方意思是新建ping test的任务，并执行ping模块，测试连通性，看下方结果,可以看到任务标签，并且状态也是成功的。（Gathering Facts 代表或许系统信息，也是成功的）

#以下以"情况"的形式，向大家讲解如何使用常用方法

情况1：你的环境中有多台机器，分别有CentOS6系统和CentOS7系列系统,两类系统在某些方面可能是不一样的，你现在两台机器上执行不同的操作，让我们来看看怎么实现。

hosts文件内容

100.3为centos6 秘钥对认证，可以免密连接

100.7为centos7 没做过密钥对认证，通过密码认证

192.168.100.3
192.168.100.7 ansible_user=root ansible_password=nihao123!     

　　

执行下方命令

ansible  all -m setup

返回的是主机的信息，如系统类型，ip地址等，ansible可以根据这些做过滤

在此情况下，我们可以通过 ansible_distribution和ansible_distribution_major_version进行匹配(以下是两台主机的信息组合，因为我使用的grep过滤的我需要的字段)

[root@host1 [::]/yaml/test]#ansible -i hosts all  -m setup |grep "ansible_distribution"
        "ansible_distribution": "CentOS",
        "ansible_distribution_file_parsed": true,
        "ansible_distribution_file_path": "/etc/redhat-release",
        "ansible_distribution_file_variety": "RedHat",
        "ansible_distribution_major_version": "",
        "ansible_distribution_release": "Core",
        "ansible_distribution_version": "7.2.1511",
        "ansible_distribution": "CentOS",
        "ansible_distribution_file_parsed": true,
        "ansible_distribution_file_path": "/etc/redhat-release",
        "ansible_distribution_file_variety": "RedHat",
        "ansible_distribution_major_version": "",
        "ansible_distribution_release": "Final",
        "ansible_distribution_version": "6.5", 

编写下方剧本。

根据when执行判断条件，当系统版本为6时执行对应的任务，为7时执行对应的任务。

[root@host1 [::]/yaml/test]#cat test2.yaml
---
- hosts: all
  remote_user: root
  gather_facts: True
  tasks:
    - name: "ping test"
      ping:
    - name: "only on Centos6"
      shell: "echo 'ON THE Centos6'"
      when: ansible_distribution == 'CentOS' and  ansible_distribution_major_version == '6'
    - name: "only on Centos7"
      shell: "echo 'ON THE Centos7'"
      when: ansible_distribution == 'CentOS' and  ansible_distribution_major_version == '7'

执行测试，可以看到，任务执行时，都执行了对应的匹配条件，只有条件通过才执行对应的shell模块指定的命令，不通过时跳过执行。

when匹配方式有多种，除了我们使用的a=a and b=b之外，大致常用的如下

when: （ansible_distribution == 'CentOS' and ansible_distribution_major_version == '6'） or
(ansible_distribution == 'CentOS' and  ansible_distribution_major_version == '5')

#等同于and，匹配多个条件
when:
      -ansible_distribution== "CentOS"
      -ansible_distribution_major_version== "6"
#对数字做大于小于的判断
when：ansible_distribution_major_version|int >= 6
#定义变量，并根据变量来判断对应任务是否是否执行
vars:
  epic: true

when: epic
when not epic
#通过上个模块执行结果来判断此模块是否执行(result|failed 可以替换为result is failed ），此方法使用方法详见例子1-2
tasks:
  - command: /bin/false
    register: result
    ignore_errors: True
  - command: /bin/something
    when: result|failed
  - command: /bin/something_else
    when: result|success
  - command: /bin/still/something_else
    when: result|skipped

　　

例子1-2

新建下方剧本，

剧本含义：当cat /etc/fapweifjapewijfapwejfpawjf成立时，判断"when: result is success"才成立

（需要配合

register: result #将执行结果记录到result变量上,给when提供判断条件

ignore_errors: True #跳过错误，错误时继续执行，给when提供判断机会

使用）

---
- hosts: all
  remote_user: root
  gather_facts: True
  tasks:
    - shell: "cat /etc/fapweifjapewijfapwejfpawjf"
      register: result
      ignore_errors: True

    - shell: "head -10 /etc/fapweifjapewijfapwejfpawjf"
      when: result is success

执行结果

情况2：需要给多台机器添加yum源配置

像这种问题，就是需要使用echo "" >> ..repo 到文件中去，但是，yum仓库的配置可不是只是一项，有什么能写的更简洁的方法呢。

with_items  一个迭代器，你可以在里面定义很多的东西，然后在某处引用时，里面的东西会循环的输出，直到定义的值输出完。

类似下方例子

items=[1,2,3,4,5,6,7,8]

for i in items:
    print(i)

新建下方剧本

gather_facts: no  在不需要获取机器信息时，根据信息做判断时，将其关闭，避免影响执行速度。

定义名称：with_items,调用名称：item都是固定的，不能更改.

{{variable}} 调用变量的方法，也是调用迭代器的方法。

---
- hosts: all
  remote_user: root
  gather_facts: no
  tasks:
    - name: "setting yum"
      shell: "echo {{ item }} >> /etc/yum.repos.d/base.repo"
      with_items:
         - "[base]"
         - "name=base"
         - "baseurl=ftp://10.124.164.114/pub/Server"
         - "enabled=1"
         - "gpgcheck=0"

在客户端上查看结果，已经正常写入。

情况3：你需要一次操作多个服务，如启动，重启等。

你可以使用情况2中的，定义with_items方法，但是你需要去with_items字段中定义，代码量多了难免有点麻烦，我们可以结合变量使用（在文首就直接定义了），定义一个列表，然后将列表传给with_items，交由它来做一个迭代器，当引用item时引用多个值。

问：为什么不直接在{{}}中引用变量，而要引用迭代器

因为变量无法在引用时被循环，就算列表里面有多个值，它引用时也只会识别一个列表，就是[nginx,ntpd]。

---
- hosts: all
  remote_user: root
  gather_facts: no
  vars:
    service_list: [nginx,ntpd]
    service_state: restarted
  tasks:
    - service: name="{{item}}" state="{{service_state}}"
      with_items: '{{ service_list }}'

情况4:你的剧本文件中，定义了很多功能，但是这次，你只想运行某个功能，该如何实现呢。

debug模块,只是一个功能，在此情况中，可以用任何模块替换，此模块是将msg定义的消息回显到终端，供我们调试。

tags标签，定义在模块下，标签名称建议有意义，无难输入的特殊字符，无空格

---
- hosts: all
  remote_user: root
  gather_facts: no
  tasks:
    - debug: msg="task 1"
      tags: task1
    - debug: msg="task two"
      tags: task2

执行测试

此情况重点来了，单独运行某个标签。使用如下命令

只运行task1标签的任务

[root@host1 [18:17:53]/yaml/test]#ansible-playbook -i hosts  --tags=task1   test5.yaml

学习了上面的使用情况，你已经可以写一个属于你的yaml剧本，使用什么模块实现什么功能，这个你可以边学边用，你可以试着完成下方我根据我工作环境自制的精简版ansible yaml剧本练习作业，巩固你的学习。

以下要求需要在你写时，写在同一剧本中

1.新建用户 admin,deployer，并定义密码

2.设置用户永不过期

3.备份/home/admin/   的所有文件(包括隐藏文件) ,(假设你有一个叫/dev/vdb的磁盘)，判断/dev/vdb是否挂载，如果挂载了，就不用管，如果没有挂载，将其挂载到/home/admin/ ，恢复你备份的文件至/home/admin/

4.同步服务器的时间，将时间同步服务设置为自启动

5.先零时，后永久的增加ulimit ("max user processes", "open files", "pending signals")这三个值的大小，具体大小自定义，达到更改效果即可。

6.先零时关闭防火墙，selinux，后设置永久关闭。

7.将hostname 和本机ip的对应关系增加至/etc/hosts文件中

8.设置yum仓库，让其能正常下载软件，

9,支持运行此剧本时，指定值运行[同步时间]任务，而不设置时间同步服务自启动