Ansible Playbook 初识

发表于 | 分类于 | | 阅读次数:
字数统计: 2k | 阅读时长 ≈ 9

image

主机规划

主机名称 操作系统版本 内网IP 外网IP(模拟) 安装软件
ansi-manager CentOS7.5 172.16.1.180 10.0.0.180 ansible
ansi-haproxy01 CentOS7.5 172.16.1.181 10.0.0.181
ansi-haproxy02 CentOS7.5 172.16.1.182 10.0.0.182
ansi-web01 CentOS7.5 172.16.1.183 10.0.0.183
ansi-web02 CentOS7.5 172.16.1.184 10.0.0.184
ansi-web03 CentOS7.5 172.16.1.185 10.0.0.185

添加用户账号

说明：

1、 运维人员使用的登录账号；

2、 所有的业务都放在 /app/ 下「yun用户的家目录」，避免业务数据乱放；

3、 该用户也被 ansible 使用，因为几乎所有的生产环境都是禁止 root 远程登录的（因此该 yun 用户也进行了 sudo 提权）。

1
2
3
4
5
6
7
# 使用一个专门的用户，避免直接使用root用户
# 添加用户、指定家目录并指定用户密码
# sudo提权
# 让其它普通用户可以进入该目录查看信息
useradd -u 1050 -d /app yun && echo '123456' | /usr/bin/passwd --stdin yun
echo "yun  ALL=(ALL)       NOPASSWD: ALL" >>  /etc/sudoers
chmod 755 /app/

Ansible 配置清单Inventory

之后文章都是如下主机配置清单

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[yun@ansi-manager ansible_info]$ pwd
/app/ansible_info
[yun@ansi-manager ansible_info]$ cat hosts_key 
# 方式1、主机 + 端口 + 密钥
[manageservers]
172.16.1.180:22

[proxyservers]
172.16.1.18[1:2]:22

# 方式2：别名 + 主机 + 端口 + 密码
[webservers]
web01 ansible_ssh_host=172.16.1.183 ansible_ssh_port=22
web02 ansible_ssh_host=172.16.1.184 ansible_ssh_port=22
web03 ansible_ssh_host=172.16.1.185 ansible_ssh_port=22

Playbook 基本概述

什么是 playbook，playbook 翻译过来就是“剧本”，那 playbook 组成如下：

1、play：定义主机角色「比作：剧本中的角色」

2、task：定义具体执行任务「比作：剧本中的角色要做什么事儿」

3、playbook：由一个或多个play组成，一个 play 可以包含多个 task 任务

简单理解：使用不同的模块完成一项事情

image

Playbook 优势

1、功能上比 Ad-Hoc 更全

2、能很好的控制先后执行顺序，以及依赖关系

3、语法更加直观，可读性更好

4、Ad-Hoc 是临时的无法持久使用，Playbook 可以持久化使用。

Playbook 书写格式

Playbook 是有 yml 语法书写，结构清晰，可读性强。

语法 描述
缩进 YAML 使用固定的缩进风格表示层级结构，每个缩进由两个空格组成，不能使用 Tab 键
冒号 以冒号结尾除外，其他所有冒号后面必须有空格
短横线 表示列表项，使用一个短横线加一个空格；多个项使用同样的缩进级别作为同一列表

Playbook 示例-安装部署 httpd

要求：在 172.16.1.180、172.16.1.181、172.16.1.182 安装 httpd 服务。

test_httpd.yml 脚本内容

说明：其中 172.16.1.181 和 172.16.1.182 已经安装好了 httpd 服务。

脚本参数说明：

host：指定主机

remote_user：要使用什么用户操作

tasks：具体执行什么任务

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
[yun@ansi-manager object01]$ pwd
/app/ansible_info/object01
[yun@ansi-manager object01]$ ll ../  # 主机清单存放位置
total 16
-rw-rw-r-- 1 yun yun 226 Oct  8 16:07 hosts_key  # 主机清单文件
drwxrwxr-x 2 yun yun  28 Oct 11 19:24 object01
[yun@ansi-manager object01]$ ll
total 4
-rw-rw-r-- 1 yun yun 937 Oct 11 19:24 test_httpd.yml 
[yun@ansi-manager object01]$ cat test_httpd.yml  # playbook 内容
---
# 上面一行表明这是一个 yml 文件，无其他作用
# test playbook
- hosts: manageservers, proxyservers  # 定义主机组 「可以有多个主机组 使用 逗号加空格 隔开」
  # remote_user: yun    # 可省略该行  定义用户的身份「我们按之前的约定使用的 yun 用户，因此这里也是 yun 用户」

  tasks:               # 定义运行什么样的任务
    - name: "Installed httpd server"  # 第一个任务 描述
      yum: name=httpd state=present   # 执行什么模块「第一种书写方式，如果该行很长，会有折行的情况，不怎么美观」

    - name: "site update"             # 第二个任务 描述「第二种书写方式，推荐，更规范人性化」
      copy:
        content: "Test WEB"
        dest: "/var/www/html/index.html"

    - name: "start httpd server"
      systemd:
        name: httpd
        daemon_reload: yes
        state: started
        enabled: yes

语法检查

1
2
3
4
5
# 由于我们使用的是 yun 普通用户
# 因此有时需要使用 -b 选择进行提权
[yun@ansi-manager object01]$ ansible-playbook -b -i ../hosts_key --syntax-check test_httpd.yml

playbook: test_httpd.yml

预执行

如果存在依赖关系【如：软件安装，配置，启动】，那么可能预执行报错，但是执行是正常的。

因为后面的「启动」依赖前面的「配置」，「配置」依赖前面的「软件安装」。

因此如果报错，那么详细看看。确定是存在问题还是依赖关系导致的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
[yun@ansi-manager object01]$ ansible-playbook -b -i ../hosts_key -C test_httpd.yml

PLAY [manageservers, proxyservers] ***************************************************************************************

TASK [Gathering Facts] **************************************************************************************************
ok: [172.16.1.180]
ok: [172.16.1.182]
ok: [172.16.1.181]

TASK [Installed httpd server] *******************************************************************************************
ok: [172.16.1.182]
ok: [172.16.1.181]
changed: [172.16.1.180]

TASK [site update] ******************************************************************************************************
changed: [172.16.1.180]
changed: [172.16.1.181]
changed: [172.16.1.182]

TASK [start httpd server] ***********************************************************************************************
changed: [172.16.1.180]
changed: [172.16.1.181]
changed: [172.16.1.182]

PLAY RECAP **************************************************************************************************************
172.16.1.180               : ok=3    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
172.16.1.181               : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
172.16.1.182               : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

执行 test_httpd.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
[yun@ansi-manager object01]$ ansible-playbook -b -i ../hosts_key test_httpd.yml

PLAY [manageservers, proxyservers] **************************************************************************************

TASK [Gathering Facts] *************************************************************************************************
ok: [172.16.1.182]
ok: [172.16.1.180]
ok: [172.16.1.181]

TASK [Installed httpd server] ******************************************************************************************
ok: [172.16.1.182]
ok: [172.16.1.181]
ok: [172.16.1.180]

TASK [site update] *****************************************************************************************************
changed: [172.16.1.181]
changed: [172.16.1.182]
changed: [172.16.1.180]

TASK [start httpd server] **********************************************************************************************
ok: [172.16.1.180]
ok: [172.16.1.182]
ok: [172.16.1.181]

PLAY RECAP *************************************************************************************************************
172.16.1.180               : ok=4    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
172.16.1.181               : ok=4    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
172.16.1.182               : ok=4    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

然后在 172.16.1.180、172.16.1.181、172.16.1.182 可见 httpd 安装部署已完成、服务已启动且已加入开机自启动；浏览器也能正常访问。

Playbook 示例-安装部署 nfs

要求：在 172.16.1.180 安装 NFS 服务端，在 172.16.1.181、172.16.1.182 挂载 NFS。

test_nfs.yml 脚本内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
[yun@ansi-manager object01]$ pwd
/app/ansible_info/object01
[yun@ansi-manager object01]$ ll
total 8
-rw-rw-r-- 1 yun yun  937 Oct 11 19:24 test_httpd.yml
-rw-rw-r-- 1 yun yun 1434 Oct 11 19:50 test_nfs.yml
[yun@ansi-manager ansible_info]$ cat test_nfs.yml  # playbook 内容
---
# 必要包安装
- hosts: manageservers, proxyservers

  tasks:
    - name: "NFS package install"
      yum:
        name:
          - nfs-utils
          - rpcbind
        state: present

# 服务端配置与启动
- hosts: manageservers

  tasks:
    - name: "create NFS dir"
      file:
        path: /data
        owner: nfsnobody
        group: nfsnobody
        state: directory
        recurse: yes

    - name: "NFS server config and start"
      copy:
        content: "/data   172.16.1.0/24(rw,sync,root_squash,all_squash)\n"
        dest: /etc/exports
        owner: root
        group: root
        mode: '644'
      # 当配置文件改变时，需要重加载 NFS 服务
      notify: "reload NFS server"

    - name: "rpcbind server start"
      systemd:
        name: rpcbind
        state: started
        daemon_reload: yes
        enabled: yes

    - name: "NFS server start"
      systemd:
        name: nfs
        state: started
        daemon_reload: yes
        enabled: yes

  handlers:
    - name: "reload NFS server"
      systemd:
        name: nfs
        state: reloaded

# 客户端操作
- hosts: proxyservers

  tasks:
    - name: "rpcbind server start"
      systemd:
        name: rpcbind
        state: started
        daemon_reload: yes
        enabled: yes

    - name: "mount NFS"
      mount:
        src: 172.16.1.180:/data
        path: /mnt
        fstype: nfs
        state: mounted
        backup: True

语法检查

1
2
3
4
5
# 由于我们使用的是 yun 普通用户
# 因此有时需要使用 -b 选择进行提权
[yun@ansi-manager object01]$ ansible-playbook -b -i ../hosts_key --syntax-check test_nfs.yml 

playbook: test_nfs.yml

预执行

如果存在依赖关系【如：软件安装，配置，启动】，那么可能预执行报错，但是执行是正常的。

因为后面的「启动」依赖前面的「配置」，「配置」依赖前面的「软件安装」。

因此如果报错，那么详细看看。确定是存在问题还是依赖关系导致的。

1
[yun@ansi-manager object01]$ ansible-playbook -b -i ../hosts_key -C test_nfs.yml  # 具体打印内容，这里省略

执行 test_nfs.yml

1
[yun@ansi-manager object01]$ ansible-playbook -b -i ../hosts_key test_nfs.yml  # 具体打印内容，这里省略

然后在 172.16.1.180 可见 NFS 服务已经部署且启动成功。

在 172.16.1.181、172.16.1.182 可见 NFS 挂载成功，且已写入 /etc/fstab 文件。

<-------------the end------------->
lightzhang wechat
欢迎扫一扫，订阅我的微信公众号！
坚持原创分享，你的支持就是我最大的动力！