Ansible 之 roles使用

1  概述



角色(roles):把playbook根据功能,如handler,tasks等分门别类的放在在各自的子目录下,形成一个集合,就是角色,建议把角色放在固定的目录下,目录可以ansible的配置文件中的roles_path来定义。

role模板查看链接:https://github.com/ansible/ansible-examples



2  配置介绍



以层级结构组织Playbook的核心元素,成为roles。

核心元素包括以下几点:

Hosts:主机

Tasks:任务列表

Variables:变量

Templates:包含了模板语法的文本文件;

Handlers:由特定条件触发的任务;

在roles目录下,分别创建不同的目录,每个目录就是不同的角色,roles目录下是角色的集合:

如roles/创建如下的目录

mysql/

httpd/

nginx/

memcached/

roles模块的路径可以在配置文件/etc/ansible/ansible.cfg里roles_path定义.

vim  /etc/ansible/ansible.cfg
roles_path  = /etc/ansible/roles:/usr/share/ansible/roles

每个角色,以特定的层级目录结构进行组织,例子如下:

/roles/mysql/

files/ :存放由copy或script模块等调用的文件;

templates/:template模块查找所需要模板文件的目录;

tasks/:至少应该包含一个名为main.yml的文件;其它的文件需要在此文件中通过include进行包含;

handlers/:至少应该包含一个名为main.yml的文件;其它的文件需要在此文件中通过include进行包含;

vars/:至少应该包含一个名为main.yml的文件;其它的文件需要在此文件中通过include进行包含;

meta/:至少应该包含一个名为main.yml的文件,定义当前角色的特殊设定及其依赖关系;其它的文件需要在此文件中通过include进行包含;注意,角色和角色之间有依赖关系,如安装NT,先装nginx后装tomcat,一般不需定义,执行我们自己定义好安装顺序即可

default/:设定默认变量时使用此目录中的main.yml文件;



3  playbook调用角色



playbook调用角色有三个方法:

方法1:

- hosts: websrvs
  remote_user: root
  roles:
  - mysql
  - memcached
  - nginx

方法2:传递变量给角色,调用角色时,注意依赖关系,可以自己先考虑好先后顺序

- hosts: 
  remote_user:
  roles:
  - { role: nginx, username: nginx }  #键role用于指定角色名称;后续的k/v用于传递变量给角色;

方法3:基于条件测试实现角色调用;

roles:
- { role: nginx, when: "ansible_distribution_major_version == '7' " }


4  例子



安装nginx,并启用

创建role相关模块

mkdir -pv /usr/share/ansible/roles/nginx/{tasks,handlers,vars,files,templates}

注意,main.yml是固定的文件名,一定要存在,指明文件名即可,顶格写

如下,设定一个模块,

vim /usr/share/ansible/roles/nginx/tasks/main.yml
- name: install nginx package
  yum: name=nginx state=latest
- name: start nginx service
  service: name=nginx enabled=true state=started

调用模块,一个主机可以调用多个列表

vim /root/ansible/nginxrole.yml
- hosts: dbsrvs
  remote_user: root
  roles:
  - nginx

运行

ansible-playbook  /root/ansible/nginxrole.yml

完善role里nginx的模块,增肌子配置文件,并且设定notify,设置了tag,并且,当子配置文件发送变化,重启nginx服务

#设置任务文件,注意,配置模板文件的src使用相对路径即可,目录的相对路径是:/usr/share/ansible/roles/nginx/templates/

vim /usr/share/ansible/roles/nginx/tasks/main.yml 
- name: install nginx package
  yum: name=nginx state=latest
- name: copy nginx conf file
  tempalte: src=web.conf.j2 dest=/etc/nginx/conf.d/web.conf
  notify: reload nginx
  tags: cpfile
- name: create docroot dir 
  file: path={{ ngx_doc_root }} state=directory
  tags: cpfile
- name: start nginx service
  service: name=nginx enabled=true state=started
#设置变量,在vars目录下定义变量,变量不需要横杆引导
vim /usr/share/ansible/roles/nginx/vars/main.yml
ngx_port: 8888
ngx_server_name: www.sunny.com
ngx_doc_root: /webdata
#设置触发后执行的操作
vim /usr/share/ansible/roles/nginx/handlers/main.yml
- name: reload nginx
  service: name=nginx state=reloaded
#设置模板文件
vim /usr/share/ansible/roles/nginx/templates/web.conf.j2
server {
    listen {{ ngx_port }}; 
    server_name {{ ngx_server_name }}; 
    location / { 
        root {{ ngx_doc_root }}; 
    }   
}

#调用模块

vim /root/ansible/nginxrole.yml
- hosts: dbsrvs
  remote_user: root
  roles:
  - nginx

 测试模块

ansible-playbook  -C /root/ansible/nginxrole.yml

注意,由于测试没有实际安装nginx模块,因此测试时,启动服务会失败

执行模块

ansible-playbook  /root/ansible/nginxrole.yml

执行tag cpfile对应的代码,如果文件web.conf.j2 发生变化,包括定义变量的文件发送变化,就会重新服务该文件到对应机器,同时,notify生效,重启nginx服务

ansible-playbook -t cpfile /root/ansible/nginxrole.yml

在执行命令中执行变量,注意,命令里的变量优先级比配置再模块vars下的优先级高

ansible-playbook -t cpfile -e "ngx_port=8899" /root/ansible/nginxrole.yml


Ansible 之 roles使用

时间: 2024-09-29 17:38:39

Ansible 之 roles使用的相关文章

Ansible的roles功能(五)

针对大型项目使用Roles进行编排,更便利 目录结构编排 一键安装httpd并提供服务 创建目录结构 [[email protected] ansible]# mkdir -p roles/httpd/{tasks,files,vars} [[email protected] ansible]# cd roles/httpd/tasks [[email protected] roles]#touch httpd/{files/main.yml,tasks/{groupadd.yml,instal

ansible之roles

软件lamp目录结构: files:存文件的,ansible默认就会到这里目录去找文件,对应task里面的copy模块 tasks:存放tasks的 handlers:存放handlers templates:存放模板,对应task里面的模块template vars:这里面定义的变量,只对当前role有作用 meta:定义role和role直接的依赖关系. [[email protected]_2 ~]# tree /root/lamp/ /root/lamp/ ├── hosts ├── r

掌握Ansible角色(Roles)自动化部署配置LAMP架构

Roles简介: Ansible为了层次化.结构化地组织Playbook,使用了角色(roles).Roles能够根据层次型结构自动装载变量文件.task以及handlers等.简单来讲,roles就是通过分别将变量.文件.任务.模块及处理器放置于单独的目录中,并可以便捷地include它们,roles一般用于基于主机构建服务的场景中,但也可以用于构建守护进程等场景中.? 在一个playbook中创建使用Roles的步骤: 1.创建以roles命令的目录. * mkdir /etc/ansibl

ansible的roles介绍和实战

roles 用于层次性.结构化地组织playbook.roles 能够根据层次型结构自动装载变量文件.tasks以及handlers等.要使用roles只需要在playbook中使用include指令即可.简单来讲,roles就是通过分别将变量(vars).文件(file).任务(tasks).模块(modules)及处理器(handlers)放置于单独的目录中,并可以便捷地include它们的一种机制.角色一般用于基于主机构建服务的场景中,但也可以是用于构建守护进程等场景中. 创建 roles

Ansible 使用roles安装服务

创建所需要的目录 [[email protected] nginx]# mkdir /etc/ansible/roles/nginx/{files,handlers,meta,vars,tasks,templates,default} -pv 新建tasks任务 [[email protected] nginx]# cd /etc/ansible/roles/nginx/  //进入nginx的roles目录[[email protected] nginx]# cat tasks/main.ym

Ansible中Roles的使用

Roles的介绍 Roles是ansible自1.2版本引入的新特性,用于层次性,结构化地组织playbook,roles能够根据层次型结构自动自动装在变量文件.tasks以及handlers 等.要使用roles只需要在playbook中使用include指令即可.简单来讲,roles就是通过分别将变量.文件.任务.模板及处理器放置于单独的目录中 并可以便捷地include他们的一种机制,角色一般用于主机构建服务的场景中,但也可以是用于构建守护进程等场景中. 创建roles的步骤 创建以rol

Ansible Playbook Roles and Include Statements

介绍 虽然可以在一个非常大的文件中编写一个playbook(您可能会以这种方式开始学习playbook),但最终您将需要重新使用文件并开始组织事情. 在基本级别,饱含任务的文件允许您将配置策略分解成较小的文件. 任务包括从其他文件中拉入任务. 由于处理程序也是任务,您还可以从"handler"部分中include处理程序文件. 如果您需要查看这些概念,请参阅" Playbooks" . Playbook还可以包括其他Playbook文件的plays. 当这样做完成时

Ansible之roles使用

ansible roles 一. roles作用 主要作用是重用playbook,例如我们无论安装什么软件都会安装时间同步服务,那么每个playbook都要编写ntp task.我们可以将ntp task写好,等到用的时候再调用就行了.ansible中将其组织成role,他有着固定的组织格式.以便playbook调用 二. relos介绍 以特定的层级目录结构进行组织的tasks.variables.handlers.templates.files等:相当于函数的调用把各个功能切割成片段来执行

Ansible中Roles的实战使用

项目实现功能 用playbook调用roles实现编译安装httpd服务 使用rools搭建,代码复用,便于日常维护管理 1. 在服务器端生成公钥,将公钥文件导入到客户端主机 注:同步过程需要输入yes和各自的root密码即可; 完成后可直接ssh [email protected] 就可以无密码登录上去了 ssh-keygen -P "" -f "/root/.ssh/id_rsa" ssh-copy-id 192.168.109.142 ssh-copy-id