ansible roles

roles（角色）

ansible 自1.2版本引入的新特性，用于层次性、结构化地组织playbook。roles能苟根据层次型结构自动装载变量文件、tasks以及handlers等。要使用roles只需要在playbook中使用include指令即可。
简单来讲，roles就是通过分别讲变量、文件、任务模版及处理器防止与单独的目录中，并可以便捷地include它们的一种机制。角色一般用于基于主机构建服务的场景中，但也可以是用于构建守护进程等场景中

• 复杂场景：建议使用roles，代码复用率高

  • 变更指定主机或主机组
  • 如命名不规范维护和传承成本大
  • 某些功能需多个playbook，通过includes即可实现

• 角色集合

roles/
	mysql/
	httpd/
	nginx/
	memcached/

roles 目录结构

# 生成test项目roles的目录结构
ansible-galaxy init test

$ ls test
README.md defaults  files     handlers  meta      tasks     templates tests     vars

# 每个角色，以特定的层级目录结构进行组织
# 剧本文件(xxx.yml)放在 roles 平级的文件夹中
# roles目录结构：
playbook.yml
roles/
	project/
		tasks/
		files/
		vars/		不常用
		default/		不常用
		templates/
		handlers/
		meta/		不常用

nginx role 例子

$ tree roles/nginx
roles/nginx
├── README.md
├── defaults
│   └── main.yml
├── files
├── handlers
│   └── main.yml
├── meta
│   └── main.yml
├── tasks
│   ├── group.yml
│   ├── main.yml
│   ├── restart.yml
│   ├── start.yml
│   ├── templates.yml
│   ├── user.yml
│   └── yum.yml
├── templates
│   └── nginx.conf.j2
├── tests
│   ├── inventory
│   └── test.yml
└── vars
    └── main.yml

8 directories, 15 files

# 文件内容
$ cat roles/nginx/tasks/main.yml
---
# tasks file for nginx
- include: group.yml
- include: user.yml
- include: yum.yml
- include: templates.yml
- include: start.yml
- include: restart.yml
- include: roles/httpd/tasks/copyfile.yml

$ cat roles/nginx/tasks/group.yml
- name: create group
  group: name=nginx gid=80

$ cat roles/nginx/tasks/user.yml
- name: create user
  user: name=nginx uid=80 group=nginx system=yes shell=/sbin/nologin

$ cat roles/nginx/tasks/yum.yml
- name: install package
  yum: name=nginx

$ cat roles/nginx/tasks/templates.yml
- name: copy config
  template: src=nginx.conf.j2 dest=/etc/nginx/nginx.conf backup=yes

$ cat roles/nginx/tasks/start.yml
- name: start service
  service: name=nginx state=started enabled=yes

$ cat roles/nginx/tasks/restart.yml
- name: restart service
  service: name=nginx state=restarted

$ cat roles/httpd/tasks/copyfile.yml
- name: copy conf
  copy: src=/usr/local/etc/httpd/httpd.conf dest=/data/ owner=apache


$ cat install_nginx_httpd.yml
---
- hosts: web
  remote_user: ec2-user
  become: yes
  become_method: sudo
  become_user: root
  roles:
    - {role: nginx, when: ansible_distribution=="Amazon" and ansible_distribution_version=="2" }
    #    - { role: httpd, tags: ['web','httpd'] }
    #    - { role: nginx, tags: ['web','nginx'], when: ansible_distribution_major_version=="7" }
    #    - { role: app, tags: ['app'] }

yaml 源文件

可参考如下链接：https://s3.wcf.net.cn/wfc/ansible/yml/