ansible使用roles

1320503165 · 发表于 2019-10-17 21:25:19

ansible roles

  在实际的工作当中，一个完整的项目实际上是很多功能体的组合，如果将所有的功能写在一个playbook中会存在如代码耦合程度高、playbook长而维护成本大、灵活性低等一系列的问题。使用roles能巧妙的解决这一系列的问题。roles是ansible1.2版本后加入的新功能，适合于大项目playbook的编排架构。

1、ansible playbook中使用includes

include在ansible中起引用功能，不仅可以引用ansible的playbook文件，也可以引用vars、handlers、file等文件。

（1）includes的使用场景

      大量的playbook内容需要重复编写

      各tasks之间的功能需要相互调用

      playbook中的内容过多

（2）include的用法

      用法：

            tasks:

            - include: playbookname.yaml

      修改主机名并添加用户admin，在修改主机名的playbook中使用include导入添加用户的playbook。

#修改主机名的playbook
---
- hosts: test
  remote_user: root
  tasks:
  - name: change hostname
hostname: name={{ servername }}
  - include: useradd.yaml
#添加用户的playbook
---
- name: user add
  user: name=admin state=present

(3)动态includes

动态的includes是指在满足一定的条件时，加载includes。

编写安装配置zabbix-agent的ansible playbook如下：

---
- hosts: "*"
  remote_user: root
  tasks:
# 将安装文件拷贝到远程主机的/tmp目录下
  - name: copy zabbix-agent
copy: src=/tmp/zabbix-agent-3.0.9-1.el6.x86_64.rpm dest=/tmp/
# 安装zabbix-agent
  - name: install zabbix_agent
yum: name=/tmp/zabbix-agent-3.0.9-1.el6.x86_64.rpm state=present
# 启动zabbix-agent
  - name: start zabbix_agent
service: name="zabbix-agent" state=started
# 导入配置zabbix-agent的playbook
  - include: configzabbix.yaml
# 只有当系统为centos6时才导入configzabbix.yaml
when: ansible_distribution_major_version == "6"
# 导入重启zabbix-agent 的playbook
  - include: zabbix_agent_restart.yaml
congfigzabbix.yaml的文件内容如下：
---
- name: configure zabbix_agent
  template: src=/home/dayi123/ansible/0418/zabbix_agent.conf.j2 dest=/etc/zabbix/zabbix_agent.conf
重启zabbix_agent的配置文件zabbix_agent_restart.yaml内容如下：

---
- name: restart zabbix_agent
  service: name=zabbix-agent state=restarted
2、ansible roles
通过includes可以在playbook中导入playbook，在一定程度上解决了将代码写入一个playbook中耦合性低及维护困难等一些列的问题。如果使用include导入大量的playbook及模板文件时，没有规范及统一的存放目录及命名规范，也不利于维护，roles正好解决了这一问题。

      roles主要依赖于目录的命名和摆放，默认tasks/main.yml是所有任务的人口，使用roles的过程也可以认为是目录规范化命名的过程。roles每个目录下均由main.yml定义该功能的任务集，tasks/main.yml默认执行所有定义的任务；roles目录建议放在ansible.cfg中”roles_path”定义的目录下。

（1）ansible roles目录结构

一个完整的roles是由task、handlers、files、vars、templates、meta等一系列目录组成，各目录存放不同的文件实现不同的功能，在调用时直接下文件名即可调用。ansible roles目录结构图如下：

ansible roles 目录结构

1）tasks目录

   tasks目录用于存放ansible执行的任务，tasks目录下必须存在main.yml文件，main.yml为主函数，用于导入需要执行的任务。

2）handlers 目录

   handlers经常和notify搭配使用，当文件、进程及返回状态发生变化时，notify通过handlers做响应的变更。handlers目录下也需要包含main.yml，包含在在main.yml中的handlers将被执行

3）templates及file目录

   templates目录及file目录均用于ansible目录文件处理，两个目录下均用于存放传输的文件，但templates目录下存放的是”.j2”格式的文件模板，文件中可以写变量。

4）vars目录

   vars目录下用于定义当前roles执行时使用的变量，应当存在main.yml文件。

5）default目录

  为当前角色定义默认变量时使用此目录，应该包含一个main.yml文件

6）meta目录

  应当包含一个main.yml文件，用于定义此角色的特殊设定及其依赖关系。

（2）ansible roles的执行方法

   roles的执行方法同ansible-playbook执行方法一样，需要调用roles的调用文件Rolesname.yml文件

rolesname.yml文件格式如下：

---
- hosts: all
  remote_user: root
  roles:
  - Rolename
如果存在不同版本的操作系统是，roles调度文件可以根据不同的操作系统类型执行不同的roles。

---
- hosts: all
  remote_user: root
  roles:
  - { role: rolename1, when: when: ansible_distribution_major_version == "6" }
  - { role: rolename1, when: when: ansible_distribution_major_version == "7" }
roles执行方式如下：

ansible-playbook rolesname.yml
3、创建roles初始化系统
（1）系统出书化的roles目录结构：

[root@ansible-server ansible]# tree roles/
roles/
├── init_system6
│ ├── files
│ │ └── zabbix-agent-3.0.9-1.el6.x86_64.rpm
│ ├── tasks
│ │ ├── init_system.yml
│ │ ├── installpack.yaml
│ │ ├── install_zabbixagent.yml
│ │ └── main.yml
│ ├── templates
│ │ └── zabbix_agent.conf.j2
│ └── vars
│    └── main.yml
└── initsystem.yml
（2）各配置文件内容

roles/initsystem.yml 中的内容：

---
- hosts: 10.0.0.13
  remote_user: root
  roles:
- init_system
roles/init_system/tasks/main.yml 中的内容：

---
   - include: init_system.yml
   - include: installpack.yaml
   - include: install_zabbixagent.yml
roles/init_system/tasks/init_system.yml 中的内容（变量”servername”是配置在/etc/ansible/hosts中）：

---
- name: hostname
hostname: name={{ servername }}

- name: disabled iptables
service: name=iptables state=started enabled=no

- name: shutdown selinux
replace: dest=/etc/selinux/config regexp=^SELINUX=enforcing replace=SELINUX=disabled
tags: selinux

- name: install ntpdate
yum: name=ntpdate state=present
- name: lock-in time
shell: ntpdate {{ timeserver }} && hwclock -w
- name: crontab ntpdate
cron: minute=1 hour=*/2 job='/usr/bin/ntpdate {{ timeserver }}' name=ntpdate

- name: Change nofile limits.
lineinfile: dest=/etc/security/limits.conf line={{ item }}
with_items:
   - '* - nofile 65535'
   - '* soft nofile 65535'
   - '* hard nofile 65535'
roles/init_system/tasks/installpack.yaml 中的内容：

- name: Install RPM package
yum: name={{ item }} state=present
with_items:
- gcc
- gcc-c++
- make
- lrzsz
- vim
roles/init_system/tasks/install_zabbixagent.yml 中配置：

---
- name: mkdir /tmp/tools
shell: mkdir /tmp/tools -p
- name: copy zabbix-agent
copy: src=zabbix-agent-3.0.9-1.el6.x86_64.rpm dest=/tmp/tools/
- name: install zabbix_agent
yum: name=/tmp/tools/zabbix-agent-3.0.9-1.el6.x86_64.rpm state=present
- name: configure zabbix_agent
template: src=zabbix_agent.conf.j2 dest=/etc/zabbix/zabbix_agent.conf
- name: start zabbix_agent
service: name="zabbix-agent" state=started
roles/init_system/vars/main.yml 中的内容：

---
timeserver: time.windows.com
roles/init_system/templates/zabbix_agent.conf.j2为zabbix的模板文件，其中部分配置了使用了模板：

[root@ansible-server ansible]# egrep ^Hostname roles/init_system/templates/zabbix_agent.conf.j2
Hostname={{ servername }}
4、ansible galaxy
   ansible galaxy主要用于管理galaxy.ansible.com上的roles,默认下载的roles存放在/etc/ansible/roles目录下，也可在ansible的配置文件中自动以存放目录。在ansible使用过程中，我们可以下载别人写好的roles直接使用，也可将自己的roles上传于galaxy.ansible.com上，在下载使用别人的roles前最好能将下载好的roles代码查看一遍，然后再去使用。

		自动登录	找回密码
密码			注册