自动化运维工具Ansible之Roles测验详解

88530091 2020-05-08

Ansible Roles 详解与实战案例

主机规划

自动化运维工具Ansible之Roles测验详解

添加用户账号

说明:

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

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

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

# 使用一个专门的用户,避免直接使用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

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

[ ansible_info]$ pwd
/app/ansible_info
[ 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

Ansible Roles 基本概述

前面已经学习了 变量、tasks 和 handlers,那怎样组织 playbook 才是最好的方式呢?

简单的回答就是:使用 roles。roles 基于一个已知的文件结构,去自动的加载某些 vars_files,tasks 以及 handlers。以便 playbook 更好的调用。相比 playbook,roles 的结构更加的清晰有层次。

假如:无论我们安装什么软件都会安装时间同步服务,那么每个 playbook 都要编写时间同步服务的 task。此时我们可以将时间同步服务 task 写好,等到用的时候再调用即可。

注意事项:在编写 roles 的时候,最好能够将一个 task 拆分为一个文件,方便后续复用「彻底打散」。

Roles 目录结构

在 roles 目录下,可以使用如下命令创建目录

ansible-galaxy init nfs roles   # 其中 nfs 为目录名称

这样创建的目录是全目录,但是我们可能只需要部分目录,因此实际应用中大多数都由我们自己创建目录,而不是用命令创建目录。

示例目录构造如下:

[ tmp]$ tree ./
./
├── sit.yml
├── webservers.yml
└── roles
    └── nfs                  # 角色名称
        ├── defaults         # 角色默认变量(最低优先级)
        │   └── main.yml
        ├── files            # 文件存放
        ├── handlers         # 触发任务
        │   └── main.yml
        ├── meta             # 依赖关系
        │   └── main.yml
        ├── README.md        # 使用说明
        ├── tasks            # 具体任务
        │   └── main.yml
        ├── templates        # 模板文件
        └── vars             # 角色其他变量
            └── main.yml

10 directories, 10 files

目录说明:

1、首先要有 roles 目录,然后在 roles 目录下创建相应的目录。

2、roles 下的目录名最好见文知意,如 common 目录表示基础目录,是必要的;nfs 目录表示安装 nfs 服务;memcached 目录表示安装 memcached 服务;等等。

3、可以根据自身需要创建 roles 下的二级目录,不需要的目录可以不创建,没需要全目录创建。

4、roles 目录下的二级目录中,有些目录必须包含一个 main.yml 文件,以便 ansible 使用。

Roles 依赖关系

roles 允许在使用 role 时自动引入其他 role。roles 的依赖关系存储在 role 目录中的 meta/main.yml 文件中。

例如:安装 WordPress 是需要先确保 Nginx 和 PHP 都能正常运行,此时都可以在 WordPress 的 role 中定义依赖 Nginx 和 php-fpm 的 role。

[ playbook]$ cat /app/roles/wordpress/meta/main.yml
---
dependencies:
  - { role: nginx }
  - { role: php-fpm }

此时 WordPress 的 role 会先执行 Nginx 的 role,然后执行 php-fpm 的 role,最后再执行 WordPress 本身的 role。

Ansible Roles 案例实战-部署 NFS 服务

整体目录结构

[ ansible_roles]$ pwd
/app/ansible_info/ansible_roles
[manager ansible_roles]$ ll
total 4
drwxrwxr-x 2 yun yun  17 Sep 15 19:41 group_vars
-rw-rw-r-- 1 yun yun 108 Sep 15 19:37 nfs_server.yml
drwxrwxr-x 4 yun yun  35 Sep 15 18:00 roles
[manager ansible_roles]$ tree  # 目录结构
.
├── group_vars
│   └── all
├── nfs_server.yml
└── roles
    ├── nfs  # 服务端
    │   ├── handlers
    │   │   └── main.yml
    │   ├── tasks
    │   │   ├── config.yml
    │   │   ├── install.yml
    │   │   ├── main.yml
    │   │   ├── mkdir.yml
    │   │   ├── start_NFS.yml
    │   │   └── start_rpcbind.yml
    │   └── templates
    │       └── exports.j2
    └── nfs_client  # 客户端
        └── tasks
            └── main.yml

9 directories, 11 files

服务端信息

目录结构

[ ansible_roles]$ pwd
/app/ansible_info/ansible_roles
[ ansible_roles]$ tree roles/nfs
roles/nfs
├── handlers
│   └── main.yml
├── tasks
│   ├── config.yml
│   ├── install.yml
│   ├── main.yml
│   ├── mkdir.yml
│   ├── start_NFS.yml
│   └── start_rpcbind.yml
└── templates
    └── exports.j2

4 directories, 8 files

tasks任务目录信息

[ ansible_roles]$ cat roles/nfs/tasks/main.yml 
- include_tasks: install.yml
- include_tasks: config.yml
- include_tasks: mkdir.yml
- include_tasks: start_rpcbind.yml
- include_tasks: start_NFS.yml

[ ansible_roles]$ cat roles/nfs/tasks/install.yml 
- name: "install package NFS "
  yum:
    name:
      - nfs-utils
      - rpcbind
    state: present

[ ansible_roles]$ cat roles/nfs/tasks/config.yml 
- name: "NFS server config and edit restart"
  template:
    src: exports.j2
    dest: /etc/exports
    owner: root
    group: root
    mode: ‘644‘
  notify: "reload NFS server"

[ ansible_roles]$ cat roles/nfs/tasks/mkdir.yml 
- name: "create NFS dir"
  file:
    path: /data
    owner: yun
    group: yun
    state: directory
    recurse: yes

[ ansible_roles]$ cat roles/nfs/tasks/start_rpcbind.yml 
- name: "rpcbind server start"
  systemd:
    name: rpcbind
    state: started
    daemon_reload: yes
    enabled: yes

[ ansible_roles]$ cat roles/nfs/tasks/start_NFS.yml 
- name: "NFS server start"
  systemd:
    name: nfs
    state: started
    daemon_reload: yes
    enabled: yes

handlers任务目录信息

[ ansible_roles]$ cat roles/nfs/handlers/main.yml 
- name: "reload NFS server"
  systemd:
    name: nfs
    state: reloaded

模板目录信息

1 [ ansible_roles]$ cat roles/nfs/templates/exports.j2 
2 {{ nfs_dir }}   172.16.1.0/24(rw,sync,root_squash,all_squash,anonuid=1050,anongid=1050)

客户端信息

客户端就比较简单了,就一个挂载任务

[ ansible_roles]$ cat roles/nfs_client/tasks/main.yml 
- name: "mount NFS server"
  mount:
    src: 172.16.1.180:{{ nfs_dir }}
    path: /mnt
    fstype: nfs
    opts: defaults
    state: mounted

变量信息

[ ansible_roles]$ pwd
/app/ansible_info/ansible_roles
[ ansible_roles]$ cat group_vars/all 
# NFS 服务端目录
nfs_dir: /data

playbook 信息

[ ansible_roles]$ cat nfs_server.yml 
---
# NFS server
- hosts: manageservers
  roles:
    - nfs

- hosts: proxyservers
  roles:
    - nfs_client

任务执行

1 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key --syntax-check nfs_server.yml  # 语法检测
2 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key -C nfs_server.yml  # 预执行,测试执行
3 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key nfs_server.yml  # 执行

Ansible Roles 案例实战-部署 memcached 服务

整体目录结构

[ ansible_roles]$ pwd
/app/ansible_info/ansible_roles
[manager ansible_roles]$ ll
total 8
-rw-rw-r-- 1 yun yun  71 Sep 16 09:05 memcached_server.yml
drwxrwxr-x 5 yun yun  52 Sep 16 08:38 roles
[ ansible_roles]$ tree roles/
roles/
└── memcached
    ├── handlers
    │   └── main.yml
    ├── tasks
    │   ├── config.yml
    │   ├── install.yml
    │   ├── main.yml
    │   └── start.yml
    └── templates
        └── memcached.j2

11 directories, 15 files

服务信息

目录结构

[ memcached]$ pwd
/app/ansible_info/ansible_roles/roles/memcached
[manager memcached]$ ll
total 0
drwxrwxr-x 2 yun yun 22 Sep 16 08:56 handlers
drwxrwxr-x 2 yun yun 76 Sep 16 08:53 tasks
drwxrwxr-x 2 yun yun 26 Sep 16 08:55 templates
[manager memcached]$ tree
.
├── handlers
│   └── main.yml
├── tasks
│   ├── config.yml
│   ├── install.yml
│   ├── main.yml
│   └── start.yml
└── templates
    └── memcached.j2

3 directories, 6 files

tasks任务目录信息

[ memcached]$ cat tasks/main.yml 
- include_tasks: install.yml
- include_tasks: config.yml
- include_tasks: start.yml

[ memcached]$ cat tasks/install.yml 
- name: " install package memcached"
  yum:
    name: memcached
    state: present

[ memcached]$ cat tasks/config.yml 
- name: "memcached server config and edit restart"
  template:
    src: memcached.j2
    dest: /etc/sysconfig/memcached
    owner: root
    group: root
    mode: ‘644‘
  notify: "restart memcached server"

[ memcached]$ cat tasks/start.yml 
- name: "memcached server start"
  systemd:
    name: memcached
    state: started
    daemon_reload: yes
    enabled: yes

handlers任务目录信息

[ memcached]$ cat handlers/main.yml 
- name: "restart memcached server"
  systemd:
    name: memcached
    state: restarted

模板目录信息

[ memcached]$ cat templates/memcached.j2 
PORT="11211"
USER="memcached"
MAXCONN="1024"
CACHESIZE="{{ ansible_memtotal_mb // 2 }}"
OPTIONS=""

playbook 信息

[ ansible_roles]$ cat memcached_server.yml 
---
# memcached server
- hosts: manageservers
  roles:
    - memcached

任务执行

1 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key --syntax-check memcached_server.yml  # 语法检测
2 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key -C memcached_server.yml  # 预执行,测试执行
3 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key memcached_server.yml  # 执行

Ansible Roles 案例实战-部署 Rsync 服务

整体目录结构

[ ansible_roles]$ pwd
/app/ansible_info/ansible_roles
[manager ansible_roles]$ ll
total 12
drwxrwxr-x 2 yun yun  17 Sep 29 09:33 group_vars
drwxrwxr-x 7 yun yun  86 Sep 29 08:49 roles
-rw-rw-r-- 1 yun yun 116 Sep 29 09:50 rsyncd_server.yml
[ ansible_roles]$ tree roles/
roles/
├── rsync_client
│   ├── tasks
│   │   └── main.yml
│   └── templates
│       └── rsync.password.j2
└── rsyncd
    ├── handlers
    │   └── main.yml
    ├── tasks
    │   ├── config.yml
    │   ├── install.yml
    │   ├── main.yml
    │   ├── mkdir.yml
    │   └── start_rsyncd.yml
    └── templates
        ├── rsyncd.conf.j2
        └── rsync.password.j2

18 directories, 25 files

服务端信息

目录结构

[ rsyncd]$ pwd
/app/ansible_info/ansible_roles/roles/rsyncd
[manager rsyncd]$ tree 
.
├── handlers
│   └── main.yml
├── tasks
│   ├── config.yml
│   ├── install.yml
│   ├── main.yml
│   ├── mkdir.yml
│   └── start_rsyncd.yml
└── templates
    ├── rsyncd.conf.j2
    └── rsync.password.j2

3 directories, 8 files

tasks任务目录信息

[ rsyncd]$ pwd
/app/ansible_info/ansible_roles/roles/rsyncd
[ rsyncd]$ cat tasks/main.yml 
- include_tasks: install.yml
- include_tasks: config.yml
- include_tasks: mkdir.yml
- include_tasks: start_rsyncd.yml

[ rsyncd]$ cat tasks/install.yml 
- name: "Install package rsync"
  yum:
    name: rsync
    state: present

[ rsyncd]$ cat tasks/config.yml 
- name: "rsyncd server config and edit restart"
  template:
    src: rsyncd.conf.j2
    dest: /etc/rsyncd.conf
    owner: root
    group: root
    mode: ‘644‘
  notify: "restart rsyncd server"

- name: "rsyncd server password file"
  template:
    src: rsync.password.j2
    dest: /etc/rsync.password
    owner: root
    group: root
    mode: ‘400‘

[ rsyncd]$ cat tasks/mkdir.yml 
- name: "create rsync business backup dir"
  file:
    path: /backup/busi_data
    owner: root
    group: root
    state: directory
    recurse: yes

- name: "create rsync database backup dir"
  file:
    path: /backup/database
    owner: root
    group: root
    state: directory
    recurse: yes

[ rsyncd]$ cat tasks/start_rsyncd.yml
- name: "rsyncd server start"
  systemd:
    name: rsyncd
    state: started
    daemon_reload: yes
    enabled: yes

handlers任务目录信息

[ rsyncd]$ cat handlers/main.yml 
- name: "restart rsyncd server"
  systemd:
    name: rsyncd
    state: restarted

模板目录信息

[ rsyncd]$ pwd
/app/ansible_info/ansible_roles/roles/rsyncd
[ rsyncd]$ cat templates/rsyncd.conf.j2  # 文件1
# 备注:更多参数与更多详解,参见  man rsyncd.conf
#rsync_config---------------start
uid = root
gid = root
use chroot = false
max connections = 200
timeout = 100
pid file = /var/run/rsyncd.pid
lock file = /var/run/rsync.lock
log file = /var/log/rsyncd.log
dont compress = *.gz *.tgz *.zip *.z *.Z *.rpm *.deb *.bz2
ignore errors = true
read only = false
list = false

## 注意为了避免困惑 hosts allow 和 hosts deny 请二选其一
hosts allow = 172.16.1.0/24,10.9.0.0/16,120.27.48.179
# hosts deny = 10.0.0.0/16
# 支持多个认证账号
auth users = {{ auth_user }}
secrets file = /etc/rsync.password


# 数据备份 注意 path 目录的权限信息
[back_data_module]
path = /backup/busi_data/

# 数据库备份 注意 path 目录的权限信息
[back_db_module]
path = /backup/database/

#rsync_config---------------end

[ rsyncd]$ cat templates/rsync.password.j2  # 文件2
{{ auth_user }}:{{ auth_pawd }}

客户端信息

[ rsync_client]$ pwd
/app/ansible_info/ansible_roles/roles/rsync_client
[manager rsync_client]$ tree  # 目录结构
.
├── tasks
│   └── main.yml
└── templates
    └── rsync.password.j2

2 directories, 2 files
[ rsync_client]$ cat tasks/main.yml  # tasks 信息
- name: "rsync passwrod file config"
  template:
    src: rsync.password.j2
    dest: /etc/rsync.password
    owner: root
    group: root
    mode: ‘400‘

[ rsync_client]$ cat templates/rsync.password.j2  # 模板信息
{{ auth_pawd }}

变量信息

[ ansible_roles]$ pwd
/app/ansible_info/ansible_roles
[ ansible_roles]$ cat group_vars/all 
# NFS 服务端目录
nfs_dir: /data
# rsync daemon 使用
auth_user: rsync_backup
auth_pawd: rsync_backup_pwd

playbook 信息

[ ansible_roles]$ cat rsyncd_server.yml 
---
# rsyncd server
- hosts: manageservers
  roles:
    - rsyncd

- hosts: proxyservers
  roles:
    - rsync_client

任务执行

1 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key --syntax-check rsyncd_server.yml  # 语法检测
2 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key -C rsyncd_server.yml  # 预执行,测试执行
3 [ ansible_roles]$ ansible-playbook -b -i ../hosts_key rsyncd_server.yml  # 执行

Ansible Galaxy

https://galaxy.ansible.com

———END———
如果觉得不错就关注下呗 (-^O^-) !

自动化运维工具Ansible之Roles测验详解

相关推荐