Ansible03-Ansible Playbook剧本详解

写在前面
5. Ansible Playbook 剧本
- 5.1 YAML语法
- - 5.1.1 语法规定
  - 5.1.2 示例
  - 5.1.3 YAML数据类型
- 5.2 Playbook组件
- 5.3 Playbook 案例
- - 5.3.1 Playbook语句
  - 5.3.2 Playbook1 分发hosts文件
  - 5.3.3 Playbook2 分发软件包，安装软件包，启动服务
  - - 5.3.3.1 任务拆解
    - 5.3.3.2 步骤变模块
    - 5.3.3.3 编写playbook
    - 5.3.3.4 测试并运行playbook
  - 5.3.4 Playbook3 nfs服务
  - - 5.3.4.1 任务拆解
    - 5.3.4.2 步骤变模块
    - 5.3.4.3 编写playbook
    - 5.3.4.4 测试并运行

写在前面

这是Ansible系列第三篇，内容为Ansible Playbook的介绍、使用
序号连续上篇笔记 Ansible02-Ansible Modules模块详解

回顾一下Ansible架构：

5. Ansible Playbook 剧本

Playbook，剧本，即Ansible中的脚本。用于配置、部署、管理被控节点。
就如同这个名字，Ansible会一步步执行Playbook中的内容，并相应返回OK,Changed,False,Skipped等反馈。
Ad-hoc的执行方式在多Modules时，过于繁琐，而为Ad-hoc编写shell脚本，又有点本末倒置。
Playbook语法尊崇yaml语法格式，文件名以.yaml或.yml为后缀。

5.1 YAML语法

一种类似XML、JSON的标记性语言。强调以数据为中心，号称“一种人性化的数据格式语言”（我没觉得多人性化）

5.1.1 语法规定

严格区分大小写
使用缩进标识层级关系
缩进不可用tab，只使用空格。空格数量没有要求，但同一层级需要保持一致。
#标识注释
"后需要有一个空格
多段YAML配置放在一个文件，用---分割

YAML转JSON语法网站，可用于验证yaml语法是否正确
http://json2yaml.com/convert-yaml-to-json

5.1.2 示例

#xml
<zhangsan><age>30</age><address>tianjin</address><dianha>132xxxxxx</dianha><youxiang>xx@163.com</youxiang>
</zhangsan>

#yaml
yunwei:chengyuan: 10gangwei: weihu---
kaifa:chengyuan: 25gangwei: kaifa---
ceshi:chengyuan: 5gangwei: ceshi

5.1.3 YAML数据类型

纯量(布尔值、整数、浮点数、Null、时间、日期、字符串)

#布尔类型
c1: true（真），false（假）#整数
c2: 123#浮点型（小数）
c3: 123.1#null类型（使用~表示null）
c4: ~#日期类型，日期必须使用ISO 8601格式，即yyyy-MM-dd
c5: 2024-05-28#时间类型，时间使用ISO 8601格式，时间和日期之间使用T连接，最后使用+代表时区
c6: 2024-05-28T08:34:20+08:00#字符串类型，简单写法直接写值即可，如果字符串中间有特殊字符，必须使用单引或双引括起来
c7: 'thi*!$hello'#字符串类型，字符串过多的情况可以使用引号拆成多行，每一行会被转化成一个空格
c8: "hello word xxxxxxxxxx"

对象（键值对）

#对象形式一（推荐）
zhangsan:age: 25address: beijing#对象形式二（了解）
zhangsan: {age: 25,address: beijing}

数组（列表）

#数组形式一（推荐）
lisi:age: 24address: - nanjing- beijing#数组形式二（了解）address: [nanjing,beijing]

5.2 Playbook组件

playbook是由一个或者多个play组成的列表，可以让这些列表按事先编排的机制执行
task是调用ansible的具体模块，在模块参数中可以使用变量。模块执行是幂等性的，意味着多次执行结果相同。

hosts：执行的远程主机列表
remote_user: 指定以远程主机哪个用户的身份执行命令
tasks：任务集
variables：内置变量或自定义变量在playbook中调用
tempaltes 模板，可替换文件中的变量并实现一些简单逻辑的文件
handles 处理程序和notify结合使用，由特定条件触发的操作，满足条件方执行，否则不执行
tags标签，指定某条任务执行，用于选择运行playbook中的部分代码。

5.3 Playbook 案例

5.3.1 Playbook语句

#运行剧本,playbook以yml或yaml结尾皆可
ansible-playbook xxx.yaml/xxx.yml#--syntax-check 用于检测playbook语法是否正确，如果正确只返回playbook名称
ansible-playbook --syntax-check xxx.yaml/xxx.yml#--check 用于模拟执行playbook
ansible-playbook --check xxx.yaml/xxx.yml

5.3.2 Playbook1 分发hosts文件

# 编写playbook
[root@manager playbook]# cat 02.fenfa.yaml
- hosts: front,dockertasks:- name: 01.create the directory#    file: path=/server/files state=directoryfile:path: /server/filesstate: directory- name: 02.send the filecopy:src: /etc/hostsdest: /server/files

解释：

## Playbook 文件：`02.fenfa.yaml`
这个Playbook 指定了两个任务，这些任务将在名为 `front` 和 `docker` 的主机上执行。### 主机（Hosts）
- `front,docker`：这些是目标主机的名称，Playbook 将会在这两个主机上执行定义的任务。### 任务列表（Tasks）
#### 任务 1: 创建目录 (`01.create the directory`)
- **名称**: `01.create the directory` — 此任务的描述性名称。
- **模块**: `file` — Ansible 的文件模块，用于文件和目录的管理。
- **参数**:- `path`: `/server/files` — 指定了要创建的目录的路径。- `state`: `directory` — 确保指定路径被创建为一个目录。#### 任务 2: 发送文件 (`02.send the file`)
- **名称**: `02.send the file` — 此任务的描述性名称。
- **模块**: `copy` — Ansible 的复制模块，用于将文件从本地复制到远程主机。
- **参数**:- `src`: `/etc/hosts` — 指定了要复制的源文件的路径，这里是本地的 `/etc/hosts` 文件。- `dest`: `/server/files` — 指定了复制文件到远程主机上的目标路径。### 特殊说明
- 注释掉的行（以 `#` 开头）表示该行被注释，不会执行。在这个例子中，`file` 模块的一行被注释了，这意味着实际执行时将使用未注释的 `file` 模块的配置。这个Playbook 的目的是在 `front` 和 `docker` 这两个主机上创建一个名为 `/server/files` 的目录，并将本地的 `/etc/hosts` 文件复制到该目录中。

# 执行语法检查，若成果只返回文件名
[root@manager playbook]# ansible-playbook --syntax-check 02.fenfa.yaml
playbook: 02.fenfa.yaml# 模拟运行，只会返回结果而不会真实运行
[root@manager playbook]# ansible-playbook --check 02.fenfa.yamlPLAY [front,docker] **************************************************************************************************TASK [Gathering Facts] ***********************************************************************************************
ok: [192.168.100.148]
ok: [192.168.100.141]TASK [01.create the directory] ***************************************************************************************
ok: [192.168.100.148]
changed: [192.168.100.141]TASK [02.send the file] **********************************************************************************************
changed: [192.168.100.141]
changed: [192.168.100.148]PLAY RECAP ***********************************************************************************************************
192.168.100.141            : ok=3    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.168.100.148            : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0#真正的playbook运行
[root@manager playbook]# ansible-playbook  02.fenfa.yamlPLAY [front,docker] **************************************************************************************************TASK [Gathering Facts] ***********************************************************************************************
ok: [192.168.100.148]
ok: [192.168.100.141]TASK [01.create the directory] ***************************************************************************************
ok: [192.168.100.148]
changed: [192.168.100.141]TASK [02.send the file] **********************************************************************************************
changed: [192.168.100.148]
changed: [192.168.100.141]PLAY RECAP ***********************************************************************************************************
192.168.100.141            : ok=3    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.168.100.148            : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0# 检查运行结果是否正确
[root@manager playbook]# ansible docker,front -m shell -a 'tree /server/files; cat /server/files/hosts'
192.168.100.141 | CHANGED | rc=0 >>
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.100.151  manager
192.168.100.150  storage
192.168.100.149  backup
192.168.100.148  front
192.168.100.141  docker192.168.100.148 | CHANGED | rc=0 >>
/server/files
└── hosts0 directories, 1 file
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.100.151  manager
192.168.100.150  storage
192.168.100.149  backup
192.168.100.148  front
192.168.100.141  docker

5.3.3 Playbook2 分发软件包，安装软件包，启动服务

以zabbix-agent为例

5.3.3.1 任务拆解

下载

wget https://mirrors.aliyun.com/zabbix/zabbix/6.5/centos/8/x86_64/zabbix-agent-7.0.0-alpha3.release1.el8.x86_64.rpm

安装

yum install -y zabbix-agent-7.0.0-alpha3.release1.el8.x86_64.rpm

配置(略)
启动开机

5.3.3.2 步骤变模块

wget -> get_url
yum -> yum
配置 -> debug模拟
systemctl -> systemd

5.3.3.3 编写playbook

- hosts: front,dockertasks:- name: 01.download the zabbix-agentget_url:url: https://mirrors.aliyun.com/zabbix/zabbix/6.5/centos/8/x86_64/zabbix-agent-7.0.0-alpha3.release1.el8.x86_64.rpmdest: /tmp/validate_certs: no #关闭校验- name: 02.yum install zayum:name: /tmp/zabbix-agent-7.0.0-alpha3.release1.el8.x86_64.rpmstate: presentdisable_gpg_check: yes #关闭gpgcheck- name: 03.配置debug:msg: "模拟配置zabbix-agent"- name: 04.startupsystemd:name: zabbix-agentenabled: yesstate: started

5.3.3.4 测试并运行playbook

#测试语法合格
[root@manager playbook]# ansible-playbook --syntax-check 03.install-zabbix-agent.yamlplaybook: 03.install-zabbix-agent.yaml#模拟测试运行
[root@manager playbook]# ansible-playbook --check 03.install-zabbix-agent.yaml#运行
[root@manager playbook]# ansible-playbook 03.install-zabbix-agent.yamlPLAY [front,docker] **************************************************************************************************TASK [Gathering Facts] ***********************************************************************************************
ok: [192.168.100.148]
ok: [192.168.100.141]TASK [01.download the zabbix-agent] **********************************************************************************
ok: [192.168.100.148]
ok: [192.168.100.141]TASK [02.yum install za] *********************************************************************************************
changed: [192.168.100.141]
changed: [192.168.100.148]TASK [03.配置] *******************************************************************************************************
ok: [192.168.100.148] => {"msg": "模拟配置zabbix-agent"
}
ok: [192.168.100.141] => {"msg": "模拟配置zabbix-agent"
}TASK [04.startup] ****************************************************************************************************
changed: [192.168.100.148]
changed: [192.168.100.141]PLAY RECAP ***********************************************************************************************************
192.168.100.141            : ok=5    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.168.100.148            : ok=5    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

5.3.4 Playbook3 nfs服务

5.3.4.1 任务拆解

服务端backup：

部署nfs-utils，rpcbind
修改配置文件
创建共享目录并修改所有者
启动服务rpcbind、nfs

客户端front：

安装nfs-utils
配置挂载

5.3.4.2 步骤变模块

服务端：

部署 -> yum
配置文件 -> lineinfile
创建共享目录 -> file
启动服务 -> systemd

客户端：

安装 -> yum
挂载 -> mount

5.3.4.3 编写playbook

- hosts: backuptasks:- name: 1. 部署nfs-utils，rpcbindyum:name: nfs-utils,rpcbindstate: present- name: 2. 修改配置文件lineinfile:path: /etc/exportsline: "/backup-nfs *(rw,all_squash)"create: true- name: 3. 创建共享目录并修改所有者file:path: /backup-nfsstate: directoryowner: nobodygroup: nobody- name: 4. 启动服务rpcbindsystemd:name: rpcbindenabled: yesstate: started- name: 5. 启动服务nfssystemd:name: nfs-serverenabled: yesstate: started- hosts: fronttasks:- name: 1. 安装nfs-utilsyum:name: nfs-utilsstate: present- name: 2. 配置挂载mount:src: 192.168.100.149:/backup-nfspath: /ans-upload#挂载点不存在会自动创建fstype: nfsstate: mounted

5.3.4.4 测试并运行

# 语法测试
[root@manager playbook]# ansible-playbook --syntax-check 04.deploy_nfs.yamlplaybook: 04.deploy_nfs.yaml#运行
[root@manager playbook]# ansible-playbook 04.deploy_nfs.yamlPLAY [backup] ********************************************************************************************************TASK [Gathering Facts] ***********************************************************************************************
ok: [192.168.100.149]TASK [1. 部署nfs-utils，rpcbind] *************************************************************************************
ok: [192.168.100.149]TASK [2. 修改配置文件] ***********************************************************************************************
ok: [192.168.100.149]TASK [3. 创建共享目录并修改所有者] ***********************************************************************************
ok: [192.168.100.149]TASK [4. 启动服务rpcbind] ********************************************************************************************
ok: [192.168.100.149]TASK [5. 启动服务nfs] ************************************************************************************************
ok: [192.168.100.149]PLAY [front] *********************************************************************************************************TASK [Gathering Facts] ***********************************************************************************************
ok: [192.168.100.148]TASK [1. 安装nfs-utils] **********************************************************************************************
ok: [192.168.100.148]TASK [2. 配置挂载] ***************************************************************************************************
changed: [192.168.100.148]PLAY RECAP ***********************************************************************************************************
192.168.100.148            : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.168.100.149            : ok=6    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0