Ansible-role

共计 3561 个字符，预计需要花费 9 分钟才能阅读完成。

假设我们要写一个 playbook 来安装管理 lamp 环境，那么这个 playbook 就会写很长。所以我们希望把这个很大的文件分成多个功能拆分, 分成 apache 管理,php 管理,mysql 管理，然后在需要使用的时候直接调用就可以了，以免重复写。就类似编程里的模块化的概念，以达到代码复用的效果。

一、roles 介绍

roles： ansible 模块，类似于函数，完成一个任务的指令。每一个 roles 都有自己特定的目录结构，就是通过分别将 variables, tasks 及 handlers 等放置于单独的目录中, 并可以便捷地调用它们的一种机制。

roles 优点：

​ 1）模块中指令较少，方便编写

​ 2）重复调用方便

3）排错方便

二、创建 roles 的目录结构

files：用来存放由 copy 模块或 script 模块调用的文件。tasks：至少有一个 main.yml 文件，定义各 tasks。handlers: 有一个 main.yml 文件，定义各 handlers。templates：用来存放 jinjia2 模板。vars：有一个 main.yml 文件，定义变量。meta：有一个 main.yml 文件，定义此角色的特殊设定及其依赖关系。

注意: 在每个角色的目录中分别创建 files, tasks,handlers,templates,vars 和 meta 目录，用不到的目录可以创建为空目录.

三、案例：通过 roles 实现 lamp

分析： 需定制三个角色: httpd,mysql,php

3.1）创建 roles 目录及文件, 并确认目录结构

roles/
├── httpd
│ ├── files
│ ├── handlers
│ │ └── main.yml
│ ├── meta
│ │ └── main.yml
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ └── vars
│ └── main.yml
├── mysql
│ ├── files
│ ├── handlers
│ │ └── main.yml
│ ├── meta
│ │ └── main.yml
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ └── vars
│ └── main.yml
└── php
├── files
├── handlers
│ └── main.yml
├── meta
│ └── main.yml
├── tasks
│ └── main.yml
├── templates
└── vars
└── main.yml

[root@manage01 ansible]# mkdir -p roles/{httpd,mysql,php}/{files,tasks,handlers,templates,vars,meta}
[root@manage01 ansible]# touch roles/{httpd,mysql,php}/{tasks,handlers,vars,meta}/main.yml
[root@manage01 ansible]# tree roles/
roles/
├── httpd
│   ├── files
│   ├── handlers
│   │   └── main.yml
│   ├── meta
│   │   └── main.yml
│   ├── tasks
│   │   └── main.yml
│   ├── templates
│   └── vars
│       └── main.yml
├── mysql
│   ├── files
│   ├── handlers
│   │   └── main.yml
│   ├── meta
│   │   └── main.yml
│   ├── tasks
│   │   └── main.yml
│   ├── templates
│   └── vars
│       └── main.yml
└── php
    ├── files
    ├── handlers
    │   └── main.yml
    ├── meta
    │   └── main.yml
    ├── tasks
    │   └── main.yml
    ├── templates
    └── vars
        └── main.yml

21 directories, 12 files

3.2）准备 httpd 服务器的主页文件,php 测试页和配置文件等

[root@manage01 files]# ls
httpd.conf  phpinfo.php

3.3）编写 httpd 角色的 main.yml 文件

[root@manage01 roles]# cat httpd/tasks/main.yml 
- name: httpd httpd-devel httpd-manual 软件包安装
  yum: name={{item}} state=latest
  with_items:
    - httpd
    - httpd-devel
    - httpd-manual

- name: 创建 apache 管理用户 www
  user: name={{user}} state=present


- name: 设置 apache 开机启动，并启动服务
  service: name=httpd enabled=yes state=started

- name: 拷贝配置文件，初始化业务
  copy: src=/etc/ansible/roles/httpd/files/httpd.conf dest=/etc/httpd/conf/httpd.conf
  # 定义通知调用，当配置文件更新, 需要重启服务 
  notify: 
    - restart apache

- name: 拷贝 php 测试页面
  copy: src=/etc/ansible/roles/httpd/files/phpinfo.php dest=/var/www/html/

[root@manage01 roles]# cat httpd/vars/main.yml
user: www


[root@manage01 roles]# cat httpd/handlers/main.yml 
- name: restart apache
  service: name=httpd state=restarted

3.4）编写 mysql 角色的 main.yml 文件

[root@manage01 ansible]# ls roles/php/files/
www.conf

[root@manage01 roles]# cat mysql/tasks/main.yml 
- name: mysql 用户创建
  user: name={{user}} state=present

- name: mysql 软件安装
  yum: name={{item}} state=latest
  with_items:
    - mariadb
    - mariadb-server

- name: 启动服务，并设置开机启动
  service: name=mariadb enabled=yes state=started

- name: 改变 mysql 文件的所有者为 mysql
  file: path='/usr/lib/mysql' owner={{user}} group={{user}} recurse=yes


[root@manage01 roles]# cat mysql/vars/main.yml 
user: mysql

3.5）: 编写 php 角色的 main.yml 文件

[root@manage01 ansible]# cat roles/php/tasks/main.yml 
- name: 安装 php
  yum: name={{item}} state=latest
  with_items:
    - php
    - php-mysqlnd
    - php-gd
    - php-ldap
    - php-odbc
    - php-pear
    - php-xml
    - php-xmlrpc
    - php-mbstring
    - php-snmp
    - php-soap
    - curl
    - curl-devel 
    - php-bcmath
    - php-fpm

- name: copy www.conf to /etc/php-fpm.d
  copy: src=/etc/ansible/roles/php/files/www.conf dest=/etc/php-fpm.d force=yes
  notify:
    - restart php-fpm


[root@manage01 ansible]# cat roles/php/handlers/main.yml 
- name: restart php-fpm
  service: name=php-fpm state=restarted
    

3.6）编写 lamp 的 playbook 文件调用前面定义好的三个角色

[root@manage01 yaml]# cat lamp.yml 
---
- hosts: group1
  remote_user: root
  roles:
  - httpd
  - mysql
  - php

3.7）执行 lamp 的 playbook 文件

[root@manage01 yaml]# ansible-playbook -C lamp.yml
[root@manage01 yaml]# ansible-playbook lamp.yml

3.8）测试业务机器