Ansible中的角色使用

目录

ansible roles

ansible 角色简介

 roles目录结构

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

创建目录结构

控制任务执行顺序

ansible-galaxy命令工具

 安装选择的角色

示例

---

ansible roles

ansible 角色简介

Ansible roles 是为了层次化，结构化的组织Playbook

roles就是通过分别将变量、文件、任务、模块及处理器放置于单独的目录中，并可以便捷地include它们

roles一般用于基于主机构建服务的场景中，在企业复杂业务场景中应用的频率很高

以特定的层级目录结构进行组织的 tasks 、 variables 、 handlers 、 templates 、 files 等 ； 相当于函数的调用把各个功能切割成片段来执行。

 roles目录结构

files             //存放copy或script等模块调用的函数
tasks             //定义各种task，要有main.yml，其他文件include包含调用
handlers         //定义各种handlers，要有main.yml，其他文件include包含调用
vars             //定义variables，要有main.yml，其他文件include包含调用
templates             //存储由template模块调用的模板文本
meta                 //定义当前角色的特殊设定及其依赖关系，要有main.yml的文件 defaults##要有main.yml的文件，用于设定默认变量
tests                 //用于测试角色

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

roles_path = path / roles （ 默认目录 ： / etc / ansible / roles ）

创建目录结构

ansible-galaxy init httpd             //创建目录结构
ansible-galaxy list            //显示当前 Ansible Galaxy 环境中安装的角色列表

控制任务执行顺序

hosts: server2
 roles:
 - role: role1         //角色任务
 pre_tasks:             //角色执行前执行的play
 - tasks1
 tasks:                 //普通任务
 - tasks2
 post_tasks:             //在角色和普通任务执行完毕后执行的play
 - tasks3

ansible-galaxy命令工具

Ansible Galaxy 是一个免费共享和下载 Ansible 角色的网站 ， 可以帮助我们更好的定义和学习 roles

ansible - galaxy 命令默认与 https :// galaxy.ansible.com 网站 API 通信 ， 可以查找 、 下载各种社区开发的 Ansible 角色

在 galaxy.ansible.com 网站查询 roles

 安装选择的角色

install https://galaxy.ansible.com roles
ansible-galaxy install geerlingguy.nginx
install local roles
 vim install_apache_role.yml
---
- src: file:///mnt/apache.tar.gz
 name: apache
ansible-galaxy install -r install_apache_role.yml

示例

下载安装apache，根据变量更改配置文件，并在访问login.westos.org时需要用户认证

ansible-galaxy init httpd        //创建目录结构

生成认证文件

 htpasswd -cm htpasswd admin

tasks主任务

[devops@ansible1 .ansible]$ cat roles/httpd/tasks/main.yml
---
# tasks file for httpd
- name: install httpd
  yum:
    name: httpd

- name: create vhosts configure
  template:
    src: vhosts.conf.j2
    dest: /etc/httpd/conf.d/vhosts.conf
  notify: restarted httpd

- name: create auth file
  copy:
    src: htpasswd
    dest: /etc/httpd/htpasswd

- name: start service
  service:
    name: httpd
    state: restarted
    enabled: yes

vars变量模块

[devops@ansible1 .ansible]$ cat roles/httpd/vars/main.yml
---
# vars file for httpd
WEBS:
  - docroot: /var/www/html
    index: www.westos.org

  - docroot: /var/www/virtual/westos.org/bbs/html
    name: bbs.westos.org
    index: bbs.westos.org

  - docroot: /var/www/virtual/westos.org/login/html
    name: login.westos.org
    index: login.westos.org

templates模块

[devops@ansible1 .ansible]$ cat roles/httpd/templates/vhosts.conf.j2
{% for web in WEBS %}
{% if web.name is not defined %}
        
{% endif %}
{% if web.name is defined %}
        
        ServerName {{web.name}}
{% endif %}
        DocumentRoot {{web.docroot}}

{% endfor %}

        AuthUserFile /etc/httpd/htpasswd
        AuthName "Please input username and password"
        AuthType basic
        Require valid-user

触发器模块

[devops@ansible1 .ansible]$ cat roles/httpd/handlers/main.yml
---
# handlers file for httpd
- name: restarted httpd
  service:
    name: httpd
    state: restarted
    enabled: no

- name: firewalld
  firewalld:
    service: httpd
    state: enabled
    permanent: yes
    immediate: yes

启用模块

[devops@ansible1 .ansible]$ cat httpd.yml
- name: install httpd server
  hosts: all
  roles:
    - role: httpd
  pre_tasks:
    - name: show pre
      debug:
        msg: start
  post_tasks:
    - name: show post
      debug:
        msg: end

测试