想上传个ansible目录结构图的,但是不知道咋的就上传图片就失败,所以各位自行百度ansible的目录结构图吧,不过下边的文字解释也足够让你理解ansible的目录结构即日常使用了。
ansible 各目录含义解释
roles: <--所有的角色必须放在roles目录下,这个目录可以自定义位置,默认的位置在/etc/ansible/roles
project: <---具体的角色项目名称,比如nginx、tomcat、php
files: <--用来存放由copy模块或script模块调用的文件。
templates: <--用来存放jinjia2模板,template模块会自动在此目录中寻找jinjia2模板文件。
tasks: <--此目录应当包含一个main.yml文件,用于定义此角色的任务列表,此文件可以使用include包含其它的位于此目录的task文件。
main.yml
install.yml ... #根据实际情况编写 这里只是示例
user.yml ... #根据实际情况编写 这里只是示例
handlers: <--此目录应当包含一个main.yml文件,用于定义此角色中触发条件时执行的动作。
main.yml
vars: <--此目录应当包含一个main.yml文件,用于定义此角色用到的变量。
main.yml
defaults: <--此目录应当包含一个main.yml文件,用于为当前角色设定默认变量。
main.yml
meta: <--此目录应当包含一个main.yml文件,用于定义此角色的特殊设定及其依赖关系。
main.yml
Roles 安装httpd服务
roles的路径使用默认的/etc/ansible/roles
一、创建基础目录
[root@ansible ~]# cd /etc/ansible/roles/
[root@ansible roles]# mkdir -p httpd/{handlers,tasks,templates,vars} # 创建需要用到的目录
[root@ansible roles]# cd httpd/
[root@ansible httpd]# tree .
.
├── handlers #此目录应当包含一个main.yml文件,用于定义此角色中触发条件时执行的动作。
├── tasks #存放具体的执行任务 比如安装 启动等
├── templates #用来存放jinjia2模板,template模块会自动在此目录中寻找jinjia2模板文件。 那么这里这次存放的是httpd的配置文件
└── vars #存放变量
4 directories, 0 file
二、编写变量文件 vars/main.yml
[root@ansible httpd]# vim vars/main.yml
PORT: 8088 #指定httpd监听的端口
USERNAME: www #指定httpd运行用户
GROUPNAME: www #指定httpd运行组
三、配置文件模板准备 templates/httpd.conf.j2
# copy一个本地的配置文件放在templates/下并已j2为后缀
[root@ansible httpd]# cp /etc/httpd/conf/httpd.conf templates/httpd.conf.j2
# 进行一些修改,调用上面定义的变量
[root@ansible httpd]# vim templates/httpd.conf.j2
Listen {{ PORT }}
User {{ USERNAME }}
Group {{ GROUPNAME }}
四、任务剧本编写,包括创建用户,创建用户组,安装软件,配置,启动等
创建组的task
[root@ansible httpd]# vim tasks/group.yml
- name: Create a Startup Group
group: name=www gid=60 system=yes
创建用户的task
[root@ansible httpd]# vim tasks/user.yml
- name: Create Startup Users
user: name=www uid=60 system=yes shell=/sbin/nologin
安装软件的task
[root@ansible httpd]# vim tasks/install.yml
- name: Install Package Httpd
yum: name=httpd state=installed
配置软件的task
[root@ansible httpd]# vim tasks/config.yml
- name: Copy Httpd Template File
template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
notify: Restart Httpd
启动软件的task
[root@ansible httpd]# vim tasks/start.yml
- name: Start Httpd Service
systemd: name=httpd state=started enabled=yes
编写main.yml,将上面的这些task引入进来
[root@ansible httpd]# vim tasks/main.yml
- include: group.yml
- include: user.yml
- include: install.yml
- include: config.yml
- include: start.ym
五、编写重启httpd的handlers, handlers/main.yml
[root@ansible httpd]# vim handlers/main.yml
# 这里的名字需要和task中的notify保持一致
- name: Restart Httpd
systemd: name=httpd state=restarted
六、编写主的httpd_roles.yml 文件调用httpd角色
[root@ansible httpd]# cd ..
[root@ansible roles]# vim httpd_roles.yml
---
- hosts: all
remote_user: root
roles:
- role: httpd #指定角色名称
七、整体的一个目录结构查看
[root@ansible roles]# tree .
.
├── httpd
│ ├── handlers
│ │ └── main.yml
│ ├── tasks
│ │ ├── config.yml
│ │ ├── group.yml
│ │ ├── install.yml
│ │ ├── main.yml
│ │ ├── start.yml
│ │ └── user.yml
│ ├── templates
│ │ └── httpd.conf.j2
│ └── vars
│ └── main.yml
└── httpd_roles.yml
5 directories, 10 files
八、测试执行角色
[root@ansible roles]# ansible-playbook -C httpd_roles.yml
九、正式执行
[root@ansible roles]# ansible-playbook httpd_roles.yml
安装完成总结:
1.中间测试的时候有报几个错,都是因为粗心大意造成,比如创建用户和创建用户组的system模块,我写成了systemctl,还有开机自启动enabled 我写成了enable 这个报错的话,测试执行的时候会报出来,可以先翻译为中文的,再看一遍英文的,有时候会明显的看出来你哪个写错了。
2.跟写单独的剧本不一样的是,编写任务(task)下的所有文件,都不用指定执行的主机,且一个文件一个任务,安装就是安装,启动就是启动,单独做一件事即可,这样看文件名即可一目了然,且方便后期维护和复制到其他地方复用,最后通过main.yml 将这些单独的任务安装执行顺序include进来即可。
3、定义handlers时候,直接在handlers/main.yml文件中写需要做什么事情即可,多可的话可以全部写在该文件里面,也可以像task那样分开来写,通过include引入一样的可以。在task调用notify时直接写与handlers名字对应即可(二者必须高度一直)。
4、模板文件一样放在templates目录下即可,task调用的时后直接写文件名字即可,会自动去到templates里面找。注意:如果是一个角色调用另外一个角色的单个task时后,那么task中如果有些模板或者文件,就得写绝对路径了。