1 安装和入门

1.1 ansible安装

1.1.1 rpm包安装

EPEL源

yum -y install ansible

1.1.2 编译安装1.1.3 Git方式

git clone git://github.com/ansible/ansible.git --recursive

cd ./ansible

source ./hacking/env-setup

1.1.4 pip 安装

pip安装：pip是安装python包的管理器，类似于yum

yum -y install python-pip python-devel

yum -y install gcc glib-devel zlibl-devel rpm-build openssl-devel

pip install --upgrade pip

pip install ansible --upgrade

确认安装：ansible –version

ansible 2.9.15
  config file = /etc/ansible/ansible.cfg
  configured module search path = [u'/root/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python2.7/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 2.7.5 (default, Apr  2 2020, 13:16:51) [GCC 4.8.5 20150623 (Red Hat 4.8.5-39)]

1.2 ansible 相关文件

1.2.1 配置文件

/etc/ansible/ansible.cfg 主配置文件，配置ansible工作特性

/etc/ansible/hosts 主机清单

/etc/ansible/roles/ 存放角色的目录

1.2.2 ansible主配置文件

ansible 配置文件/etc/ansible/ansible.cfg(一般保持默认), 其中大部分的配置内容无需进行修改

[defaults]
#inventory      = /etc/ansible/hosts  #主机列表配置文件
#library        = /usr/share/my_modules/ #库文件存放目录
#module_utils   = /usr/share/my_module_utils/ 
#remote_tmp     = ~/.ansible/tmp #临时py命令文件存放在远程主机目录
#local_tmp      = ~/.ansible/tmp #本机临时命令执行目录
#forks          = 5 #默认并发数（同时执行5个操作，eg五台主机五台的执行）
#poll_interval  = 15 
#sudo_user      = root #默认sudo用户
#ask_sudo_pass = True #每次执行ansible命令是否询问ssh密码
#ask_pass      = True
#transport      = smart
#remote_port    = 22
#module_lang    = C
#module_set_locale = False
#host_key_checking = False #检查对应服务的的host_key，建议取消注释

1.2.3 主机清单文件

主机清单inventory

inventory主机清单：ansible的主要功用在于批量主机操作，为了方便的使用其中的部分主机，可以在inventory file中将其分组命名

默认的inventory file为/etc/ansible/hosts

inventory file可以有多个，且也可以通过Dynamic Inventory来动态完成

/etc/ansible/hosts文件格式

inventory文件遵循INI文件风格，中括号的字符为组名。可以将同一个主机同事归并到不通的组中；此外，当如若目标主机使用了非默认的ssh端口，还可以在主机名称之后使用冒号加端口号来标明

eg：

ntp.magedu.com

[webservers]

www1.magedu.com:2222

www2.magedu.com

[dbservers]

db1.magedu.com

db2.magedu.com

如果主机名称遵相似的命名模式，还可以使用列表的方式标识个主机

[wedservers]

www[01:100].example.com

[dbservers]

db-[a:f].example.com

1.3 ansible 系列命令

ansible 系列命令

ansible ansible-doc ansible-playbook ansible-vault ansible-console ansible-galaxy ansible-pull

1、ansible-doc 显示模块帮助

ansible-doc [options][module]

-a 显示所有模块文档

-l，–list 列出可用模块

-s，–snippet 显示指定模块的playbook片段

实例：

ansible-doc -l 列出所有模块

ansible-doc ping 查看指定模块的帮助用法

ansible-doc -s ping 查看指定模块的帮助用法

ansible通过ssh实现配置管理、应用部署，任务执行等功能，建议配置ansible段能基于密钥认证的方式联系各被管理节点

2、ansible[-m module_name] [-a args]

–version 显示版本

-m module 指定模块，默认为command

-v 详细过程 -vv -vvv 更详细

–list-host 显示主机列表，可简写–list

-k ，–ask-pass 提示输入ssh连接密码。默认key验证

-K， –ask-become-pass 提示输入sudo时的口令

-C，–check 检查不执行

-T –timeout=TIMEOUT 执行命令的超时时间，默认10s

-u –user=REMOTE——USER 执行远程执行的用户

-b， –become 代替旧版本的sudo切换

3、ansible的Host-pattern 匹配主机的列表

all：表示所有Inventory中的所有主机

*：通配符

ansible “*” -m ping

ansible 192.168.1.* -m ping

ansible “*srvs” -m ping

或关系

ansible “webserver:dbserver” -m ping

ansible “webserver:dbserver” -m ping #执行在web组并且在dbserver组中的主机（忽略重复的）

与关系

ansible “webserver:&dbserver” -m ping

只执行在web组并且也在dbserver组中的主机

逻辑非

ansible ‘webserver:!dbserver’ -m ping 【注意此处只能使用单引号！】

综合逻辑

ansible ‘webserver:dbserver:&webserver:!dbserver’ -m ping

正则表达式

ansible “webserver:&dbserver” -m ping

ansible “~(web|db).*.magedu.\com” -m ping

4、ansible命令执行过程

a 加载自己的配置文件默认/etc/ansible/ansible.cfg

b 加载自己对应的模块如command

c 通过ansible将模块或命令生成对应的临时py文件，并将改文件传输至远程服务器的对应执行用户SHOME/.ansible/tmp/ansible-tmp-数字/XXX.py文件

d 文件见+x执行

e 执行并返回结果

f 删除临时py文件，sleep 0退出

5、执行状态

绿色：执行成功并且不需要做改变的操作

黄色：执行成功并且对目标主机做变更

红色：执行失败

2 ansible常用模块

2.1 command

在远程主机执行命令，默认模块。可忽略-m选项

ansible srvs -m command -a ‘systemctl restart sshd’

ansible srvs -m command -a 'echo magedu | passwd --stdin wang '不成功

此命令不支持$VRNAME< > | ; & 等，需要用shell模块实现

2.2 shell

和command相似，用shell执行命令

ansible srv -m shell -a ‘echo magedu | passwd --stdin wang’

调用bash执行命令类似cat /tmp/stanley.md | awk -F '|' '{print $1,$2}' & > /tmp/example.txt这些复杂命令，即使使用shell也可能会失败，

解决办法：写到脚本，copy到远程，执行，再把需要的结果拉回执行命令的机器

2.3 script

在远程主机上运行脚本

-a “/PATH/TO/SCRIPT_FILE”

ansible webserver -m script -a f1.sh

2.4 copy

从服务器复制文件到客户端

ansible all -m copy -a 'src=/data/test1 dest=/data/test1 backup=yes mode=000 owner=zhang'  #如目标存在，默认覆盖，此处是指先备份，并修改全向属主

ansible all -m copy -a "content='test content\n' dest=/tmo/f1.txt" #利用内容，直接生成目标文件

ansible all -m copy -a "src=/root/ops_scripts dest=/tmp/" # 把一个目录里的所有内容拷贝到目标主机

2.5 fetch

从客户端取文件至服务器端，与copy相反，目录可以先tar，默认只支持取文件

ansible all -m fetch -a ‘src=/root/a.sh dest=/data/f2.sh’

2.6 file

设置文件属性（状态，属组，属主，权限）

ansible all -m file -a “path=/root/a.sh owner=zhang mode=755”

ansible all -m file -a 'src=/data/test1 dest=/tmp/test state=link'

ansible all -m file -a ’name=/data/f3 state=touch‘  #创建文件

ansible all -m file -a ’name=/data/f3 state=absent‘ #删除文件

ansible all -m file -a ’name=/data state=directory‘ #创建目录

ansible all -m file -a ’src=/etc/fstab dest=/data/fstab.link state=link‘

2.7 unarchive

功能:解包解压缩

实现有两种用法:

将ansible主机上的压缩包传到远程主机后解压缩至特定目录,设置copy-yes
将远程主机上的某个压缩包解压缩到指定路径下,设置copy=no

常见参数

copy: 默认为yes,当copy=yes,拷贝的文件是从ansible主机复制到远程主机上,如果设置为copy=no,会在远程主机上寻找src源文件
remote_src:和copy功能一样且互斥, yes表示在远程主机,不在ansible主机, no表示文件在ansible主机上src:源路径,可以是ansible主机上的路径,也可以是远程主机上的路径,如果是远程主机上的路径,则需要设置copy=no
dest:远程主机上的目标路径
mode:设置解压缩后的文件权限

范例：

ansible all -m unarchive -a 'src=/data/foo.tgz dest=/var/1ib/foo'

ansible all -m unarchive -a 'src=/tmp/foo.zip dest=/data copy=no mode=0777'

ansible all -m unarchive -a 'src=https://example.com/example.zip dest=/data copy=no'

2.8 Archive

功能：打包压缩

ansible all -m archieve -a 'path=/var/log/ dest=/data/log.tar.bz2 format=bz2 owner=wang mode=0600'

2.9 hostname

管理主机名

ansible 192.168.10.24 -m hostname -a “name=kso-bj6-zw-zhangwei”#永久生效（但hosts文件需要手动更改）

2.10 cron

计划任务

支持时间：minute，hour，day，month，weekday

ansible all -m cron -a "minute=*/5 weekday=1,3,5 job='/usr/sbin/ntpfata 172.16.0.1 & >/dev/null' name=Synctime" 创建任务
ansible all -m cron -a "disabled=true job='/usr/sbin/ntpfata 172.16.0.1 & >/dev/null' name=Synctime" 禁用任务（加#号注释）

ansible all -m cron -a "disabled=no  job='/usr/sbin/ntpfata 172.16.0.1 & >/dev/null' name=Synctime" 启用任务

ansible all -m  cron -a 'state=absent name=Synctime' 删除任务

2.11 yum

管理包(支持Red-Hat 系列)

ansible all -m yum -a 'name=httpd state=latest'安装

ansible all -m yum -a 'name=httpd state=ansent' 卸载

ansible all -m yum  -a 'name=dstat update_cache=yes' 更新缓存

【注：dstat--监控工具https://www.jianshu.com/p/49b259cbcc79】

2.12 service

管理服务

ansible all -m service -a 'name=httpd state=stopped'

ansible all -m service -a 'name=httpd state=started enabled=yes'

ansible all -m service -a 'name=httpd state=reload'

ansible all -m service -a 'name=httpd state=restart'

2.13 user

管理用户

ansible all -m user -a 'name=user1 comment="test user" uid=2048 home=/data/home/user1 group=root'  创建用户，以及uid，家目录，并描述（comment）

ansible all -m user -a 'name=zhangwei shell=/sbin/nologin  system=yes home=/data/home/zhangwei'    创建不可登陆的系统用户

ansible all -m user -a 'name=zhangwei state=absent remove=yes'删除用户及家目录(remove表示是否删除家目录)

2.14 group

管理组

ansible all -m group -a "name=testgroup system=yes"

ansible all -m group -a "name=testgroup state=absent"

2.15 lineinfile

文件内容替换

ansible在使用sed进行替换时,经常会遇到需要转义的问题,而且ansible在遇到特殊符号进行替换时,存在问题,无法正常进行替换。其实在ansible自身提供了两个模块: lineinfile模块和replace模块,可以方便的进行替换功能:相当于sed,可以修改文件内容

ansible all-m lineinfile -a "path=/etc/selinux/config regexp='ASELINUX=line=' SELINUX=enforcing."
ansible al1-m lineinfile -a 'dest=/etc/fstab state=absent regexp="^#".

2.16 replace

类似于se d命令，主要也是基于正则进行匹配和替换

ansible all -m replace -a "path=/etc/fstab regexp='^(UUID.*)' replace='#\1'"

2.17 setup

用来收集主机的系统信息，这些facts信息可以直接以变量的形式使用，但是如果主机较多，会影响执行速度，可以使用gather_facts: no 来禁止ansible收集facts信息

ansible all -m setup 查看所有信息
ansible all -m setup -a "filter=ansible_processor" 查看指定信息

3 playbook

3.1 介绍

playbook

playbook是由一个或者多个“play”组成的列表

play的主要功能在于将事先归并为一组的主机装扮成事先通过ansible中的task定义好的角色。从根本上来讲，所谓task无非是调用ansible的一个module。将多个play组织在一个playbook中，即可以让他们联同起来按照事先编排的机制同唱一台大戏。

palybook采用YAML语言编写

yaml

YAML是一个可读性高用来表达资料序列的格式。YAML参考了其他多种语言，包括：XML、C语言、Python、Perl以及电子邮件格式RFC2822等。Clark Evans在2001年在首次发表了这种语言，另外Ingy dot Net与Oren Ben-Kiki也是这种语言的共同设计者。

YAML Ain’t Markup Language，即TAML不是XML。不过，在开发这种语言时，YAML的意思其实是：Yet Another Markup Language（仍是一种标记语言）

特性

YAML的可读性好
YAML和脚本语言的交互性好
YAML使用实现语言的数据类型
YAML有一个一致的信息模型
YAML易于实现
YAML可以基于流来处理
YAML表达能力强，扩展性好

更多内容及规范参见http://www.yaml.org

yaml 语法简介

注意

在单一档案中，可以连续三个连字号（—）区分多个档案。另外，还有选择性的连续三个点号（…）用来表示档案结尾

次行动开始正常些playbook的内容，一般建议些明该playbook的功能

使用#号注释代码

缩进必须是统一的，不能空格和tab混用

缩进的级别也必须是一致的，同样的缩进代表同样的级别，程序判断配置的级别是通过缩进结合换行来实现的

YAML文件内容和linux系统大小写判断方式保持一致，是区别大小写的，k/v的值均需大小写敏感

k/v的值可同行写也可换行写。同行的话，使用：号分割

v可是一个字符串，也可是另一个列表

一个完成的代码块功能需最少元素包括 name: task

一个name只能包括一个task

YAML文件扩展名通常为yml或者yaml
list：列表，其所有元素均使用“-”打头

示例：

# Alist of tasty fruits

- Apple

- Orange

- Strawberry

- Mango
Dictionary：字典，通常由说个key与value构成

示例：

-–

# An employee record

name:Example Developer

job:Developer

skill:Elite

也可将key:value放置于{}中进行表示，用“，”分隔多个key:value

示例：

-–

# An employee record

{name:Example Developer,job:Developer,skill:Elite}

YAML的语法和其他高阶语言类似，并且可以简单表达清单，散列表、标量等数据结构。其机构（Structure）通过空格来展示，序列（Sequence）里的项目“-”来代表，Map李的键值对用“：”分割。

3.2 playbook核心元素

hosts 执行的远程主机列表
tasks 任务集
varniables 内置变量或自定义变量在playbook中调用
templates 模板，可替换模板文件中的变量并实现一些简单逻辑文件
hanslers 和notity结合使用，有特定条件出发操作，满足条件方可执行，否则不执行
tags 标签指定某条任务执行，用于选择运行playbook中部分代码。ansible具有幂等性，因此会自动化跳过没有变化的部分，即便如此，有些代码为此时其确实没有发生变化的时间依然会非常的长。此时，确信其没有变化，就可以通过tags跳过此些代码片段。

3.3 playbook基础组件

hosts

playbook中的每一个play的目的都是为了让某个或某些主机以某个指定的用户身份执行任务。hosts用于指定要执行指定任务的主机，须事先定义在主机清单中

可以是如下形式：

one.example.com

one.example.com:two.example.com

192.168.1.50

192.168.1.*

webserver:dbserver 两个组的并集

webserver:&dbserver 两个组的交集

webserver:!dbserver 在webserver组中  但不在dbserver组中

示例：

- hosts：webserver:sbserver

remote_user

可用于Host和task中。也可以通过制定其通过sudo的方式在远程主机上执行任务，其可用于play全局或某任务；此外；甚至可以在sudo时使用sudo_user: root时切换到用户。

- hosts: web
  remote_user: root
  tasks:
    - name: test connection
      ping
      remote_user: zhangwei
      sudo: yes   #默认sudo为root
      sudo_user: wang   #sudo为wang

tasks

任务列表

格式：（1）action: module arguments

          (2) module: arguments 【建议使用】

          注意：shell和command模块后面跟命令，而非key=value

某任务的状态在运行后为change时，可通过‘notify’通知给相应的handlers

某任务可以通过‘tags’打标签，而后可在ansible-playbook命令上使用-t指定进行调用

示例：

tasks：
  - name: disable selinux
    command: /sbin/setenforce 0

如果命令或脚本的退出码不为零，可以使用如下方式替代

tasks:
  - name: run this conamnd and ignore the result
    shell : /usr/bin/sommecommand || /bin/true

或者使用ignore_errors来忽略错误信息：

tasks:
  - name: run this conamnd and ignore the result
    shell : /usr/bin/sommecommand
    ignore_errors: True

运行playbook方式

ansible-playbook <filename.yml> … [options]

常见选项

–check (-C)只检测可能会发生的改变，但不真正执行操作

–list-hosts 列出运行任务的主机

–limit 主机列表只针对主机列表中的主机执行

-v 显示过程 -vv -vvv更详细

示例：

ansible-playbook file.yml --check 只检测

ansible-playbook file.yml

ansible-playbook file.yml --limit webserver

ansible-playbook file.yml --list-hosts  # 查看主机

ansible-playbook file.yml --list-tasks  #查看任务列表

ansible-playbook file.yml --list-tags  # 查看标签

3.4 playbook中的handler和notify

handlers

是tasks列表，这些task与前述的task并没有本质上的不同，用于当关注的资源发生变化时，才会采取一定的操作
notify

此action可用于在每个play的最后被触发，这样可以避免多次有改变发生时，每次都执行指定的操作，仅在所有的变化发生完后一次性执行指定的操作。在notify中列出的操作称为handler，也即notify中调用handler中定义的操作

- hosts: all
  remote_user: root
  tasks:
    - name: install httpd package
      yum: name=httpd state=present
    - name: install configuration file for httpd
      copy: src=/root/conf/httpd.conf dest=/etc/httpd/conf/httpd.conf
      notify:
        - restart httpd
        - Check Nginx Process
    - name: start httpd service
      service: enabled=true name=httpd state=started
  handlers:
    - name: restart httpd
      service: name=httpd state=restarted
    - name: Check Nginx process
      shell: killall -O nginx > /tmp/nginx.log

3.5 playbook中tags的使用

ansible-playbook -t conf httpd.yml 【使用-t 指定标签名字】

ansible-playbook -t conf,service httpd.yml

ansible-playbook httpd.yml –list-tsgs #查看标签列表

注意：tags标签命名可以相同，不通模块下写入相同tags标签，执行时，打入标签的模块会同时执行

3.6 playbook中变量的使用

变量名：仅能由字母、数字和下划线组成，且只能以字母开头

变量来源：

ansible setup facts 远程主机的所有变量都可以直接调用

ansible all -m setup #查看远程主机的所有变量
ansible all -m setup -a 'filter=ansible_hostname'#过滤主机中的变量
ansible all -m setup -a 'filter=ansible_hostname' ##过滤主机的主机全名

这里查找到的变量可以直接在playbook中调用

在/etc/ansible/hosts中定义

普通变量：主机组中主机单独定义，优先级高与公共变量

公共组变量：针对主机组中所有主机定义统一变量
[websrvs] 10.0.0.8 hostname=node1 10.0.0.7 hostname=node2 [websrvs:vars] domain=mageedu.org
注：主机变量的优先级高于公共变量

通过命令行指定变量，优先级最高

ansible-playbook -e varname=value

例子：

---
- hosts: web
  remote_user: root

  tasks:
    - name: install pkname
      yum: name={{ pkname }}
    - name: start serivece
      service: name={{ pkname }} state=started enabled=yes

在命令行中调用：

ansible-playbook -e 'pkname=httpd'   test.yml

在playbook中定义

- hosts: web
  remote_user: root
  vars:
    - pkname1: httpd
    - pkname2: telnet
  tasks:
    - name: install pkname1
      yum: name={{ pkname1 }}
    - name: install pkname2
      yum: name={{ pkname2 }}

在role中定义

使用变量文件

- name: Play the template module
  hosts: localhost
  vars:
    env: "development"
  vars_files:  # 变量定义在相对路径的文件中
    - vars/test.yml
    - vars/development.yml
    - vars/production.yml
  tasks:
    - name: generation the hello_world.txt file
      template:
        src: ./files/hello_world.txt.j2
        dest: /tmp/hello_world2.txt

3.7 模板templates

文本文件，嵌套有脚本（使用模板编程语言编写）
jinja2语言，使用字面量，有下面形式:
字符串：使用单引号或者双引号
数字：整数，浮点数
列表：[item1，itme2,…]
元组：（item1，itme2,…）
字典：{key1:value1,key2:value2,…}
布尔型：true/false
算术运算：+，-，，/，//，%，*
比较操作：==,！=,>,>=,<,<=
逻辑运算：and,or,not
流表达式：For If When（循环语句）

小记：在模板目录template下写入模板文件，文件中可以直接调用setup变量（src可以直接书写模板目录下的文件）

# 修改文件nginx.conf.j2
mkdir templates
vim templates/nginx.conf.j2
worker_processes {{ ansible_processor_vcpus }}

vim temnginx2.yml
---
- hosts: websrvs
  remote_user: root
  tasks: 
    - name: template config to

3.7.1 for和if

template中也可以使用流程控制for循环和if条件判断，实现动态生成文件功能

for条件判断

# tplnginx.yml
---
- hosts: websrvs
  remote_user: root
  vars:
    nginx_vhosts:
      - listen: 8080
  tasks: 
    - name: config file
      template: src=nginx.conf.j2 dest=/data/nginx.conf

# nginx.conf.j2
{% for host in nginx_vhosts %}
server {
  listen {{ vhost.listen }}
}
{% endfor %}

# 生成的结果
server {
  listen 8080;
}

if条件判断

---
- hosts: web
  remote_user: root
  vars:
    ports:
      - web1:
        port: 81
        name: web1.magedu.com
        rootdir: /data/website1
      - web2:
        port: 82
        #name: web2.magedu.com
        rootdir: /data/website2

  tasks:
    - name: copy conf
      template: src=if.conf.j2 dest=/data/if.conf

模版文件

{% for p in ports %}
server{
        listen {{ p.port }}
{% if p.name is defined %} #如果p.name被定义就执行下面的servername，否则不执行
        servername {{ p.name }}
{% endif %}
        documentroot {{ p.rootdir }}
}
{% endfor %}

3.7.2 when语句

条件测试：如果需要根据变量，facts或此前任务的执行结果来作为某task执行与否的前提时需要用到条件测试，通过w hen语句实现，在task中使用，jinja2的语法格式

在task后添加when子句即可使用条件测试，when语句支持jinja2表达式语法

---
- name: set vim package
  hosts: all
  tasks:
    - name: install apt packages
      apt: name=vim state=present
      when: ansible_pkg_mgr == "apt" # 如果是Debian系统使用apt安装

    - name: install yum packages
      yum: name=vim-minimal state=present
      when: ansible_pkg_mgr == "yum"  # 如果是RedHat系列系统使用yum安装

4 roles

roles（角色）是ansible自1.2版本引入的新特性，用于层次性，结构化地组织playbook。roles能够根据层次结构自动装载变量文件、tasks以及handlers等。要使用roles只需要在playbook中使用include指令即可。简单来讲，roles就是通过分别将变量、文件、任务、模板及处理器放置于单独的目录中，并可以便捷地include它们的一种机制。角色一般用于主机构建服务的场景中，但也可以使用于构建守护进程等场景中

复杂场景：建议使用roles，代码复用度高

变更指定主机或主机组
如命令不规范，维护和传承成本大
某些功能需要多个playbook，通过includes可以实现

4.1 roles目录编排

roles目录结构

playbook.yml
  roles
  project/
  tasks/
  files/
  vars/  不常用
  defaults/  不常用
  templates/
  handlers/
  meta/  不常用

roles各目录的作用

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

4.2 实战案例

实验: 创建httpd角色

1> 创建roles目录
   mkdir roles/{httpd,mysql,redis}/tasks -pv
   mkdir  roles/httpd/{handlers,files}

查看目录结构
tree roles/
    roles/
    ├── httpd
    │   ├── files
    │   ├── handlers
    │   └── tasks
    ├── mysql
    │   └── tasks
    └── redis
        └── tasks

2> 创建目标文件
   cd roles/httpd/tasks/
   touch install.yml config.yml service.yml

3> vim install.yml
   - name: install httpd package
     yum: name=httpd
     
   vim config.yml
   - name: config file  
     copy: src=httpd.conf dest=/etc/httpd/conf/ backup=yes 
   
   vim service.yml
   - name: start service 
     service: name=httpd state=started enabled=yes
     
4> 创建main.yml主控文件,调用以上单独的yml文件,
   main.yml定义了谁先执行谁后执行的顺序
   vim main.yml
   - include: install.yml
   - include: config.yml
   - include: service.yml
   
5> 准备httpd.conf文件,放到httpd单独的文件目录下
   cp /app/ansible/flies/httpd.conf ../files/
   
6> 创建一个网页
   vim flies/index.html
   <h1> welcome to weixiaodong home <\h1>

7> 创建网页的yml文件
   vim tasks/index.yml
   - name: index.html
     copy: src=index.html dest=/var/www/html 

8> 将网页的yml文件写进main.yml文件中
   vim mian.yml
   - include: install.yml
   - include: config.yml
   - include: index.yml
   - include: service.yml

9> 在handlers目录下创建handler文件main.yml
   vim handlers/main.yml
   - name: restart service httpd
     service: name=httpd state=restarted

10> 创建文件调用httpd角色
    cd /app/ansidle/roles
    vim role_httpd.yml
    ---
    # httpd role
    - hosts: appsrvs
      remote_user: root 

      roles:       #调用角色
        - role: httpd  
        
11> 查看目录结构
    tree 
    .
    httpd
    ├── files
    │   ├── httpd.conf
    │   └── index.html
    ├── handlers
    │   └── main.yml
    └── tasks
        ├── config.yml
        ├── index.yml
        ├── install.yml
        ├── main.yml
        └── service.yml

12> ansible-playbook role_httpd.yml

针对大型项目使用Roles进行编排

roles目录结构：
playbook.yml
roles/
  project/
    tasks/
    files/
    vars/
    templates/
    handlers/
    default/ # 不经常用
    meta/    # 不经常用

示例：
nginx-role.yml
roles/
└── nginx
    ├── files
    │ └── main.yml
    ├── tasks
    │ ├── groupadd.yml
    │ ├── install.yml
    │ ├── main.yml
    │ ├── restart.yml
    │ └── useradd.yml
    └── vars
        └── main.yml

示例

roles的示例如下所示：
site.yml
webservers.yml
dbservers.yml
roles/
  common/
    files/
    templates/
    tasks/
    handlers/
    vars/
    meta/
  webservers/
    files/
    templates/
    tasks/
  handlers/
    vars/
    meta/

实验：创建一个nginx角色

建立nginx角色在多台主机上来部署nginx需要安装 创建账号
1> 创建nginx角色目录
     cd /app/ansible/role
     mkdir nginx{tesks,templates,hanslers} -pv

2> 创建任务目录
     cd tasks/
     touch insatll.yml config.yml service.yml file.yml user.yml
   创建main.yml文件定义任务执行顺序
     vim main.yml
     - include: user.yml
     - include: insatll.yml
     - include: config.yml
     - include: file.yml
     - include: service.yml

  
3> 准备配置文件(centos7、8)
   ll /app/ansible/role/nginx/templates/
   nginx7.conf.j2
   nginx8.conf.j2


4> 定义任务
   vim tasks/install.yml
   - name: install
     yum: name=nginx
     
   vim tasks/config.yml
    - name: config file
      template: src=nginx7.conf.j2 dest=/etc/nginx/nginx.conf
      when: ansible_distribution_major_version=="7"
      notify: restrat
      
    - name: config file
      template: src=nginx8.conf.j2 dest=/etc/nginx/nginx.conf
      when: ansible_distribution_major_version=="8"
      notify: restrat
      
    vim tasks/file.yml   跨角色调用file.yum文件,实现文件复用
    - name: index.html
      copy: src=roles/httpd/files/index.html dest=/usr/share/nginx/html/ 
   
    vim tasks/service.yml
    - nmae: start service
      service: name=nginx state=started enabled=yes
      
    vim handlers/main.yml
    - name: restrat
      service: name=nginx state=restarted
      
    vim roles/role_nginix.yml
    --- 
    #test rcle
    - hosts: appsrvs
    
      roles: 
        - role: nginx
        
5> 测试安装
   ansible-playbook role_nginx.yml

Roles案例

Roles目录编排

Playbook中调用

playbook调用角色

调用角色方法1：
- hosts: websrvs
  remote_user: root
  
  roles:
    - mysql
    - memcached
    - nginx
    
调用角色方法2：
传递变量给角色
- hosts:
  remote_user:
  roles:
    - mysql
    - { role: nginx, username: nginx }   #不同的角色调用不同的变量  
    键role用于指定角色名称
    后续的k/v用于传递变量给角色

调用角色方法3：还可基于条件测试实现角色调用
roles:
  - { role: nginx, username: nginx, when: ansible_distribution_major_version == '7' }

通过roles传递变量

通过roles传递变量
当给一个主机应用角色的时候可以传递变量，然后在角色内使用这些变量
示例：
- hosts: webservers
  roles:
    - common
    - { role: foo_app_instance, dir: '/web/htdocs/a.com', port: 8080 }

向roles传递参数

而在playbook中，可以这样使用roles：
---
- hosts: webservers
  roles:
    - common
    - webservers

也可以向roles传递参数
示例：
---
- hosts: webservers
  roles:
    - common
    - { role: foo_app_instance, dir: '/opt/a', port: 5000 }
    - { role: foo_app_instance, dir: '/opt/b', port: 5001 }

条件式地使用roles

甚至也可以条件式地使用roles
示例：
---
- hosts: webservers
  roles:
    - { role: some_role, when: "ansible_os_family == 'RedHat'" }

Roles条件及变量等案例

When条件
    roles:
      - {role: nginx, when: "ansible_distribution_major_version == '7' " ,username: nginx }
变量调用
- hosts: zabbix-proxy
  sudo: yes
  roles:
    - { role: geerlingguy.php-mysql }
    - { role: dj-wasabi.zabbix-proxy, zabbix_server_host: 192.168.37.167 }

完整的roles架构

// nginx-role.yml 顶层任务调用yml文件
---
- hosts: testweb
  remote_user: root
  roles:
    - role: nginx
    - role: httpd 可执行多个role

cat roles/nginx/tasks/main.yml
---
- include: groupadd.yml
- include: useradd.yml
- include: install.yml
- include: restart.yml
- include: filecp.yml

// roles/nginx/tasks/groupadd.yml
---
- name: add group nginx
  user: name=nginx state=present

cat roles/nginx/tasks/filecp.yml
---
- name: file copy
  copy: src=tom.conf dest=/tmp/tom.conf

以下文件格式类似：
useradd.yml,install.yml,restart.yml

ls roles/nginx/files/
tom.conf

roles playbook tags使用

roles playbook tags使用
    ansible-playbook --tags="nginx,httpd,mysql" nginx-role.yml  对标签进行挑选执行

// nginx-role.yml
---
- hosts: testweb
  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: marridb ,tags: [ 'mysql', 'db' ] }
    - { role: php }

实验: 创建角色memcached

memcacched 当做缓存用,会在内存中开启一块空间充当缓存
cat /etc/sysconfig/memcached 
    PORT="11211"
    USER="memcached"
    MAXCONN="1024"
    CACHESIZE="64"    # 缓存空间默认64M 
    OPTIONS=""


1> 创建对用目录
   cd /app/ansible
   mkdir roles/memcached/{tasks,templates} -pv
   
2> 拷贝memcached配置文件模板
   cp /etc/sysconfig/memcached  templates/memcached.j2
   vim templates/memcached.j2
   CACHESIZE="{{ansible_memtotal_mb//4}}"   #物理内存的1/4用做缓存
   
3> 创建对应yml文件,并做相应配置
   cd tasks/
   touch install.yml config.yml service.yml
   创建main.yml文件定义任务执行顺序
   vim main.yml
   - include: install.yml
   - include: config.yml
   - include: service.yml  
   
   vim install.yml
   - name: install 
     yum: name=memcached
     
   vim config.yml
   - name: config file
     template: src=memcached.j2 dets=/etc/sysconfig/memcached

   vim service.yml
   - name: service
     service: name=memcached state=started enabled=yes

4> 创建调用角色文件
   cd /app/ansible/roles/
   vim role_memcached.yml
    ---
    - hosts: appsrvs
    
      roles: 
        - role: memcached

5> 安装
   ansible-playbook  role_memcached.yml 
   memcached端口号11211

其它功能

委任（指定某一台机器做某一个task）
    delegate_to
    local_action (专指针对ansible命令执行的机器做的变更操作)
交互提示
    prompt
*暂停（java）
    wait_for
Debug
    debug: msg="This always executes."
Include
Template 多值合并
Template 动态变量配置

Ansible Roles

委任
    delegate_to
交互提示
    prompt
暂停
    wait_for
Debug
    debug: msg="This always executes."
Include
Template 多值合并
Template 动态变量配置