分享交流
合作共赢！
        找回密码
当前位置：琼杰笔记 Ansible 正文

Ansible之roles角色的使用方法总结

2019-11-17 分类：Ansible 阅读(4443) 评论(0)

一、Roles简介

ansible自1.2版本开始引入的新特性，用于层次性，结构化地组织playbook。roles能够根据层次型结构自动装载变量文件、tasks以及handlers等。要使用roles只需要再playbook中使用include指令即可。简单的说，roles就是通过分别将变量、文件、任务、模块及处理器放置于单独的目录中、并可以便捷地include他们的一种机制。角色一般用于基于主机构建服务的场景中、但也可以是用于构建守护进程等场景中。
一个roles的案例如下所示：
ansible_playbooks/
└── roles
├── dbservers
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
└── webservers
├── files
├── handlers
├── meta
├── tasks
├── templates
└── vars
在palybook中，也就是在ansible_playbooks目录下创建xxx.yml，可以这样使用roles

---
- hosts: webservers（/etc/ansible/hosts里定义的主机组）
roles:
- common
- webservers

也可以向roles传参：

- hosts: webservers（/etc/ansible/hosts里定义的主机组）
roles:
- common
- { role: foo_app_instance,dir: "/tmp/a", port: 8080}

还可以设置条件使用roles：

- hosts: webservers（/etc/ansible/hosts里定义的主机组）
roles:
- common
- { role: some_role, when: "ansible_os_family == 'RadHat'"}

二、创建roles

创建已roles命名的目录
在roles目录中分别创建已各角色名称命名的目录，如dbservers，webservers等。
在每个角色命名的目录中分别创建files、hadlers、meta、tasks、templates以及vars目录；用不到的目录可以创建为空目录，也可以不创建；
在playbook文件中，调用各角色；

1.方式一：
[root@hejianlai-jenkins ~]# mkdir -p ansible_playbooks/roles/{dbservers,webservers}/{tasks,files,templates,meta,handlers,vars}
[root@hejianlai-jenkins ~]# tree ansible_playbooks/
ansible_playbooks/
└── roles
├── dbservers   # playbook调用时role的名称
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
└── webservers
├── files
├── handlers
├── meta
├── tasks
├── templates
└── vars
2.方式二：（单独创建）
mkdir -p roles/{dbservers,webservers}/{tasks,files,templates,meta,handlers,vars}
3.方式三：（借助工具创建）
命令格式：ansible-galaxy init 角色名称
ansible-galaxy init nodes
tree nodes/
nodes/
├── defaults
│   └── main.yml
├── files
├── handlers
│   └── main.yml
├── meta
│   └── main.yml
├── README.md
├── tasks
│   └── main.yml
├── templates
├── tests
│   ├── inventory
│   └── test.yml
└── vars
└── main.yml

8 directories, 8 files

三、各目录作用解释

  • tasks目录：至少应该包含一个名为main.yml的文件，其定义了此角色的任务列表；此文件可以使用include包含其他的位于此目录中的task文件；
  • files目录：存放由copy或script等模块调用的文件；
  • templates目录：templates模块会自动在此目录中寻找Jinja2模板文件；
  • handlers目录：此目录中应当包含一个main；
  • yml文件，用于定义此角色用到的各handler：在handler中使用include包含的其他的handler文件也应该位于此目录中；
  • vars目录：应当包含一个main.yml文件，用于定义此角色用到的变量；
  • meta目录：应当包含一个main.yml文件，用于定义此角色的特殊设定及其依赖关系；ansible 1.3及其以后的版本才支持；
  • default目录：为当前角色设定默认变量时使用此目录；应当包含一个main.yml文件；
[root@hejianlai-jenkins ~]# cd ansible_playbooks/roles/webservers/
#拷贝配置文件到files目录下
[root@hejianlai-jenkins webservers]# cp /root/conf/httpd.conf files/
[root@hejianlai-jenkins webservers]# ll files/httpd.conf
-rw-r--r-- 1 root root 11754 Jul 6 01:31 files/httpd.conf
#编写tasks
[root@hejianlai-jenkins webservers]# cat tasks/main.yml
- name: install httpd package
yum: name=httpd
- name: install configuration file
copy: src=httpd.conf dest=/etc/httpd/conf/httpd.conf
tags:
- conf
notitf:
- restart httpd
- name: start httpd
service: name=httpd state=started
#编写handlers
[root@hejianlai-jenkins webservers]# cat handlers/main.yml
- name: restart httpd
service: name=httpd state=restarted
#编写playbook
[root@hejianlai-jenkins webservers]# cd ..
You have new mail in /var/spool/mail/root
[root@hejianlai-jenkins roles]# ll
total 8
drwxr-xr-x 8 root root 89 Jul 6 01:26 dbservers
-rw-r--r-- 1 root root 16 Jul 6 01:41 httpd.retry
-rw-r--r-- 1 root root 64 Jul 6 01:39 httpd.yml
drwxr-xr-x 8 root root 89 Jul 6 01:26 webservers
[root@hejianlai-jenkins roles]# cat httpd.yml
- hosts: webservers
remote_user: root
roles:
- webservers
#运行playbook
[root@hejianlai-jenkins roles]# ansible-playbook httpd.yml
[WARNING]: Ignoring invalid attribute: notitf
PLAY [webservers] **************************************************************************************************************************************
TASK [Gathering Facts] *********************************************************************************************************************************
ok: [192.168.247.133]
TASK [webservers : install httpd package] **************************************************************************************************************
ok: [192.168.247.133]
TASK [webservers : install configuration file] *********************************************************************************************************
ok: [192.168.247.133]
TASK [webservers : start httpd] ************************************************************************************************************************
ok: [192.168.247.133]
PLAY RECAP *********************************************************************************************************************************************
192.168.247.133 : ok=4 changed=0 unreachable=0 failed=0

四、在playbook中调用role

role存放的路径在配置文件/etc/ansible/ansible.cfg中定义

roles_path    = /etc/ansible/roles:/usr/share/ansible/roles
第一种：
- hosts: HOSTS
  remote_user: root
  roles:
    - ROLE_NAME1
    - ROLE_NAME2

第二种：除了字典第一个元素指明调用的role，后面是传递给role的变量
- hosts: HOSTS
  remote_user: root
  roles:
  - { role: ROLE_NAME1, VARIABLE1: VALUE1, ...}

第三种：when指明role调用的条件
- hosts: HOSTS
  remote_user: root
  roles:
  - { role: ROLE_NAME1, when: CONDITIONS}

补充：

1.目录名同角色名；

2.目录结构有固定格式；

  •     files：静态文件
  •     templates：Jinja2模板文件
  •     tasks：至少有main.yml文件，定义各tasks：
  •     handlers：至少有一个main.yml文件，定义各handlers
  •     vars：至少有一个main.yml，定义各变量
  •     meta：定义依赖关系等信息

3.httpd.yml文件中定义playbook，简单说就是你想定义哪个组调什么角色模块，也可以有其他的yml文件。

五、Roles使用实例

作用：配置linux集群基本的网络和主机名信息，操作步骤如下：

1.安装ansible

参考琼杰笔记文档：Ansible安装及playbook的使用方法总结

2.创建相关目录和文件，在/etc/ansible/roles下创建角色常用目录和文件：

~]# mkdir -p /etc/ansible/roles/base/{tasks,files,templates,meta,handlers,vars}
~]# touch /etc/ansible/roles/base/tasks/main.yaml
~]# touch /etc/ansible/roles/base/vars/main.yaml

3.配置hosts主机信息，配置文件/etc/hosts

[allCentOS]
127.0.0.1
192.168.239.131
192.168.239.132
192.168.239.133
[allCentOS:vars]
ansible_ssh_user=root
ansible_ssh_pass=Zqjsyl12345

4.编写yaml文件，在/etc/ansible目录下创建base.yaml文件，并编辑如下内容：

[root@master01 ansible]# more base.yaml 
- hosts: 192.168.239.137
  roles:
  - base

编辑文件/etc/ansible/roles/bash/vars/main.yaml配置变量：

---
myipaddr: 192.168.239.132
mynetmask: 255.255.255.0
mygateway: 192.168.239.254
mydns1: 114.114.114.114
mydns2: 192.168.239.254

编辑文件/etc/ansible/roles/base/tasks/main.yaml创建playbook任务：

---
- name: config machine name
  shell: hostnamectl set-hostname master01
- name: BOOTPROTO="dhcp"
  replace: path=/etc/sysconfig/network-scripts/ifcfg-ens33 regexp='BOOTPROTO="dhcp"' replace='BOOTPROTO="static"'
- name: add ip
  blockinfile: path=/etc/sysconfig/network-scripts/ifcfg-ens33 marker="#{mark} edit ip info" block="IPADDR={{ myipaddr }} \nNETMASK={{ mynetma
sk }} \nGATEWAY={{ mygateway }} \nDNS1={{ mydns1 }} \nDNS2={{ mydns2 }}\n" state=present
- name: restart network
  shell: systemctl restart network

5.执行playbook

ansible-playbook base.yaml

Playbook的编写需要用到很多模块，常用playbook模块的使用请参考琼杰笔记文档：Ansible文件操作的常用模块使用方法总结【珍藏版】

参考：Ansible之roles使用

赞(3) 打赏
未经允许不得转载：琼杰笔记 » Ansible之roles角色的使用方法总结
分享到

相关推荐

评论 抢沙发

评论前必须登录！

 

2024年 4月
一 二 三 四 五 六 日
 1
2345678
9101112131415
16171819202122
23242526272829
3031  
吐血推荐

wordpress转型docker运行，数据持久化并定期与github更新同步

将wordpress传统的lnmp等部署架构转型为docker容器化，所有数据包括mysql数据库、wordpress站点静态资源全部托管到github，并实现一键部署，数据持久化。另外这些数据会通过cronjob定期和github自动同步，目前所访问的站点极为容器托管。

分类

分享交流，合作共赢！

联系我们加入QQ群

觉得文章有用就打赏一下文章作者

非常感谢你的打赏，我们将继续给力更多优质内容，让我们一起创建更加美好的网络世界！

支付宝扫一扫打赏

微信扫一扫打赏

登录

找回密码

注册