ansible复习笔记_role-从零到无

--创建时间:2021年3月9日

--修改时间:2021年3月9日

--作者:飞翔的小胖猪

roles是各个单独功能性模块的集合,通过分别将变量、文件、任务、模板及处理器放置于单独的目录中,并可以便捷地include它们的一种机制。

简介

roles:多个角色的集合, 可以将多个的role,分别放至roles目录下的独立子目录中

文件夹说明

roles/project/ :项目名称,有以下子目录
    - files/ :存放由copy或script模块等调用的文件
    - templates/:template模块查找所需要模板文件的目录
- tasks/:定义task,role的基本元素,至少应该包含一个名为main.yml的文件;其它的文件需要在此文件中通过include进行包含 - handlers/:至少应该包含一个名为main.yml的文件;其它的文件需要在此文件中通过include进行包含 - vars/:定义变量,至少应该包含一个名为main.yml的文件;其它的文件需要在此文件中通过include进行包含 - meta/:定义当前角色的特殊设定及其依赖关系,至少应该包含一个名为main.yml的文件,其它文件需在此文件中通过include进行包含 - default/:设定默认变量时使用此目录中的main.yml文件,比vars的优先级低

以上的文件夹包含了一个role整的目录结构,在使用role时可以不全部都创建,可即用及建。也可以先行创建,文件夹下可以为空。

编写流程

1.创建roles的目录结构

mkdir roles/功能名自定义/{files,tasks,templates,vars,handlers,meta,default}

2.编写主的main.yml文件

[root@135 playbook]# cat roles/功能名自定义/tasks/main.yml 
- include: touch_file.yml 
- include: user.yml
- include: copy_file.yml

tasks目录下的main.yml文件时整个role的模块入口。其中include行表示单独的模板,置于tasks/目录下。

此处的include有顺序要求,执行次序是从上至下。请根据自身软件逻辑调整功能模块的调用顺序。

3.编写各个单独的功能性模块

根据tasks/main.yml文件中的include行有序的编写单个功能性模块。

[root@135 tasks]# cat copy_file.yml 
- name: copy file
  copy: src=test.txt dest=/tmp/ backup=yes
  notify: test11

单个模块编写时,需要把这个模块涉及的所有东西都编写完再进行下一个模块的编写。

(有些模块会用到变量,hander,文件等,需要在专用的文件夹中进行相关资源的编写)

 3.1  准备文件

[root@135 playbook]# cat roles/功能名自定义/files/test.txt 
lvan test hhahahaha
asfassf

  3.2 编写对应的handler

[root@135 playbook]# cat roles/功能名自定义/handlers/main.yml 
- name: test11
  shell: echo "`date` test_lvan" >> /var/log/message

4.  编写调用的playbook文件

在roles目录同级目录下创建一个playbook文件用作调用role模块。

[root@135 playbook]# cat http_role.yml 
---
- hosts: oracle_11g
  remote_user: root
  gather_facts: no
  
  roles:
  - http

调用文件是整个role编写的最后一步,要确定所有单个功能性模块都编写完成后再编写调用的playbook文件。

5.测试role的功能性

使用ansible-playbook -C 命令检测编写的role是否正常。该步骤不是必须的,但是检测一下总是好的。

[root@135 playbook]# ansible-playbook -C http_role.yml

检测有时候会因为逻辑错误出现检测不通过,但又确定没有语法和参数的错误。

一般出现在某一个模块需要依赖上一个模块的执行结果。而-C参数是检测不会真实执行,则会出现依赖性的报错。此时不用管这类报错,一般提示有:没有该用户   文件路径不存在等。

role调用

role在编写调用的playbook时可以给role设置标签和条件用来控制筛选待执行的role。

基本调用

[root@135 playbook]# cat http_role_base.yml 
---
- hosts: websrvs
  remote_user: root
  roles:
    - mysql
    - memcached
    - nginx  

条件调用

[root@135 playbook]# cat http_role_term.yml 
---
- hosts: all
  remote_user: root
  roles:
    - { role: nginx, username: nginx, when: ansible_distribution_major_version == '7'  }

传参调用

[root@135 playbook]# cat http_role_args.yml 
---
- hosts: all
  remote_user: root
  roles:
    - mysql
    - { role: nginx, username: nginx }

tags调用

[root@135 playbook]# cat http_role_tags.yml 
---
- hosts: websrvs
  remote_user: root
  roles:
    - { role: nginx ,tags: [ 'nginx', 'web' ] ,when: ansible_distribution_major_version == "6“ }
    - { role: httpd ,tags: [ 'httpd', 'web' ]  }
    - { role: mysql ,tags: [ 'mysql', 'db' ] }
    - { role: mariadb ,tags: [ 'mariadb', 'db' ] }

执行命令:ansible-playbook  --tags="nginx,httpd,mysql"  http_role_tags.yml

模块展示

不同文件夹下各个文件配置模版展示。

tasks

tasks目录下存放的是整个role的所有模块,至少包含一个main.yml文件和一个功能性yml文件。

main.yml

cat  main.yml
- include: user.yml

单个功能模块

cat  user.yml
- name: create user
  user: name=test_lvan  system=yes shell=/sbin/nologin

vars

变量存放路径。

cat  main.yml 
user: lvan
name_test: lvan11

handlers

cat  main.yml 
- name: restart
  service: name=nginx state=restarted

default

 存放变量的目录,优先级比vars目录中的低,如果vars中的main.yml没有匹配的变量再来这里找。

cat  main.yml
user: nginx
group: nginx
tarball_name: nginx-1.6.3.tar.gz
nginx_configuration: nginx.conf.j2
nginx_dir: nginx-1.6.3

files

该文件夹下保存的是tasks文件夹下模块要用到的文件,没有特殊格式就只是单个普通文件。

templates

该文件夹下保存的是tasks文件夹下模块要用到的文件,ansible专用模版文件。就是可以包含变量的文件。每个模版文件的定义均不一样,只展示较简单的格式。

cat  nginx.conf.j2 
worker_processes {{ ansible_processor_vcpus }}

其中{{ ansible_processor_vcpus }}就是变量。

原文地址:https://www.cnblogs.com/Pigs-Will-Fly/p/14504129.html