Ansible-playbook 运维笔记

 

之前详细介绍了Ansible的安装, 配置, 以及Ansible常用模块的使用. 下面对Ansible的playbook用法做一小结。

为什么引入playbook?
一般运维人员完成一个任务, 比如安装部署一个httpd服务会需要多个模块(一个模块也可以称之为task)提供功能来完成。而playbook就是组织多个task的容器,它的实质就是一个文件,有着特定的组织格式,它采用的语法格式是YAML(Yet Another Markup Language)。YAML语法能够简单的表示散列表,字典等数据结构。简单来说, playbook是由一个或多个模块组成的,使用多个不同的模块,完成一件事情。 

Ansible核心功能
-  pyYAML用于ansible编写剧本所使用的语言格式(saltstack---python);
-  rsync-ini语法, sersync-xml语法, nsible-pyYAML语法;
-  paramiko远程连接与数据传输;
-  Jinja2用于编写ansible的模板信息;

YAML三板斧
缩进: YAML使用一个固定的缩进风格表示层级结构,每个缩进由两个空格组成, 不能使用tabs;
冒号: 以冒号结尾的除外,其他所有冒号后面所有必须有空格;
短横线: 表示列表项,使用一个短横杠加一个空格。多个项使用同样的缩进级别作为同一列表;

YAML基本语法
Ansible-playbook采用YAML语法编写。连续的项目(即列表)用 -减号来表示,key/value(字典)用冒号:分隔。

列表:每一个列表成员前面都要有一个短横线和一个空格

fruits:
    - Apple
    - Orange
    - Strawberry
    - Mango

或者:
fruits: ['Apple', 'Orange', 'Strawberry', 'Mango']

字典:每一个成员由键值对组成,注意冒号后面要有空格

martin:
    name: Martin D'vloper
    job: Developer
    skill: Elite
或者
martin: {name: Martin D'vloper, job: Developer, skill: Elite}

列表和字典可以混合使用

-  martin:
    name: Martin D'vloper
    job: Developer
    skills:
      - python
      - perl
      - pascal
-  tabitha:
    name: Tabitha Bitumen
    job: Developer
    skills:
      - lisp
      - fortran
      - erlang

示例如下:
[root@localhost ~]# cat httpd.yaml

---
- hosts: control-node    #将要执行任务的主机,已经在hosts文件中定义好了,可是单个主机或主机组
  remote_user: root      #在目标主机上执行任务时的用户身份
  vars:
    - pkg: httpd
  tasks:
    - name: "install httpd package."
      yum: name={{ pkg }}  state=installed
    - name: "copy httpd configure file to remote host."
      copy: src=/root/conf/httpd.conf dest=/etc/httpd/conf/httpd.conf
      notify: restart httpd     #当这个任务执行状态发生改变时,触发handlers执行.
    - name: "boot httpd service."
      service: name=httpd state=started
  handlers:                     #handlers与tasks是同一级别
    - name: restart httpd
      service: name=httpd state=restarted

playbook语法特性
1.  以 --- (三个减号)开始,必须顶行写;
2. 次行开始写Playbook的内容,但是一般要求写明该playbook的功能;
3. 严格缩进,并且不能用Tab键缩进;
4. 缩进级别必须是一致的,同样的缩进代表同样的级别,程序判别配置的级别是通过缩进结合换行来实现的;
5. K/V的值可同行写,也可换行写。同行使用 :分隔,换行写需要以 - 分隔;

playbook基础组件
Hosts:运行执行任务(task)的目标主机
remote_user:在远程主机上执行任务的用户
tasks:任务列表
handlers:任务,与tasks不同的是只有在接受到通知时才会被触发
templates:使用模板语言的文本文件,使用jinja2语法。
variables:变量,变量替换{{ variable_name }}

整个playbook是以task为中心,表明要执行的任务。hosts和remote_user表明在远程主机以何种身份执行,其他组件让其能够更加灵活。下面介绍插件:

1.  variable
变量定义在资产 (inventory) 中, 默认就是/etc/ansible/hosts文件中

主机变量:
192.168.200.136 http_port=808 maxRequestsPerChild=808
192.168.200.137 http_port=8080 maxRequestsPerChild=909

主机组变量:
[websers]
192.168.200.136
192.168.200.137

[websers:vars]  
ntp_server=ntp.exampl.com
proxy=proxy.exampl.com

变量定义在playbook中

- hosts: webservers
  vars:
    http_port: 80

使用facts变量

facts变量是由setup模块获取远程主机的信息。

用法:
# ansible 192.168.200.136 -m setup

在roles中定义变量, 这个后面会介绍到.

ansible-playbook 命令中传入参数

使用 -e选项传入参数
# ansible-playbook 192.168.200.136 -e "httpd_port=808" httpd04.yml

变量的引用

{{ var_name }}

2.  templates
它是一个模块功能,与copy不同的是他的文本文件采用了jinga2语法,jinga2基本语法如下:

字面量:
  字符串:使用单引号或双引号
  数字:整型,浮点数
  列表:{item1,item2,...}
  字典:{key1:value1,key2:value2,...}
  布尔型:true/false
算术运算:
  +,-,*,/,//,%,**
比较运算:
  ==,!=,>,>=,<,<=
逻辑运算:
  and,or,not

注意:template只能在palybook中使用。

3.  tasks
执行的模块命令

格式:
  action:模块参数(此种方式只在较新的版本中出现)
  module:参数(已键值对的形式出现)

每一个task都有一个名称,用于标记此任务。任务示例:
  name: install httpd
  yum: name=httpd state=present

注意:shell和command没有参数,可在后面直接跟命令
  shell: ss -tnl | grep :80

1)某任务的运行状态为changed后,可通过相应的notify通知相应的handlers
2)任务可以通过tags打标签,然后通过palybook命令-t选项调用.

playbook命令及调用方式

用法:
ansible-playbook  <filename.yml> ... [options]

<filename.yml>: yaml格式的playbook文件路径,必须指明
[options]: 选项

Options:
--ask-vault-pass     
             #ask for vault password
             #加密playbook文件时提示输入密码
  -C, --check          
             #don't make any changes; instead, try to predict some of the changes that may occur
             #模拟执行,不会真正在机器上执行(查看执行会产生什么变化)。即并不在远程主机上执行,只是测试。
  -D, --diff           
             #when changing (small) files and templates, show the differences in those files; works great with --check
             #当更新的文件数及内容较少时,该选项可显示这些文件不同的地方,该选项结合-C用会有较好的效果
  -e EXTRA_VARS, --extra-vars=EXTRA_VARS
             #set additional variables as key=value or YAML/JSON
             #在Playbook中引入外部参数变量
  --flush-cache        
             #clear the fact cache
             #清理fact缓存,将fact清除到的远程主机缓存
  --force-handlers     
             #run handlers even if a task fails
             #强制运行handlers的任务,即使在任务失败的情况下
  -f FORKS, --forks=FORKS
             #specify number of parallel processes to use(default=5)
             #并行任务数。FORKS被指定为一个整数,默认是5
  -h, --help           
             #show this help message and exit
             #打开帮助文档API
  -i INVENTORY, --inventory-file=INVENTORY
             #specify inventory host path (default=/etc/ansible/hosts) or comma separated host list.
             #指定要读取的Inventory清单文件
  -l SUBSET, --limit=SUBSET
             #further limit selected hosts to an additional pattern
             #限定执行的主机范围
  --list-hosts         
             #outputs a list of matching hosts; does not execute anything else
             #列出执行匹配到的主机,但并不会执行任何动作。
  --list-tags          
             #list all available tags
             #列出所有可用的tags
  --list-tasks         
             #list all tasks that would be executed
             #列出所有即将被执行的任务
  -M MODULE_PATH, --module-path=MODULE_PATH
             #specify path(s) to module library (default=None)
             #要执行的模块的路径
  --new-vault-password-file=NEW_VAULT_PASSWORD_FILE
             #new vault password file for rekey
             #
  --output=OUTPUT_FILE 
             #output file name for encrypt or decrypt; use - for stdout
             #
  --skip-tags=SKIP_TAGS
             #only run plays and tasks whose tags do not match these values
             #跳过指定的tags任务
  --start-at-task=START_AT_TASK
             #start the playbook at the task matching this name
             #从第几条任务(START_AT_TASK)开始执行
  --step               
             #one-step-at-a-time: confirm each task before running
             #逐步执行Playbook定义的任务,并经人工确认后继续执行下一步任务
  --syntax-check       
             #perform a syntax check on the playbook, but do not execute it
             #检查Playbook中的语法书写,并不实际执行
  -t TAGS, --tags=TAGS 
             #only run plays and tasks tagged with these values
             #指定执行该tags的任务
  --vault-password-file=VAULT_PASSWORD_FILE
             #vault password file
             #
  -v, --verbose        
             #verbose mode (-vvv for more, -vvvv to enable connection debugging)
             #执行详细输出
  --version            
             #show program's version number and exit
             #显示版本
 
  ############Connection Options,即下面时连接权限############
    control as whom and how to connect to hosts
 
    -k, --ask-pass     
             #ask for connection password
             #
    --private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE
             #use this file to authenticate the connection
             #
    -u REMOTE_USER, --user=REMOTE_USER
             #connect as this user (default=None)
             #指定远程主机以USERNAME运行命令
    -c CONNECTION, --connection=CONNECTION
             #connection type to use (default=smart)
             #指定连接方式,可用选项paramiko (SSH)、ssh、local,local方式常用于crontab和kickstarts
    -T TIMEOUT, --timeout=TIMEOUT
             #override the connection timeout in seconds(default=10)
             #SSH连接超时时间设定,默认10s
    --ssh-common-args=SSH_COMMON_ARGS
             #specify common arguments to pass to sftp/scp/ssh (e.g.ProxyCommand)
             #
    --sftp-extra-args=SFTP_EXTRA_ARGS
             #specify extra arguments to pass to sftp only (e.g. -f, -l)
             #
    --scp-extra-args=SCP_EXTRA_ARGS
             #specify extra arguments to pass to scp only (e.g. -l)
             #
    --ssh-extra-args=SSH_EXTRA_ARGS
             #specify extra arguments to pass to ssh only (e.g. -R)
             #
 
  ############Privilege Escalation Options, 即下面时权限提升权限############
    control how and which user you become as on target hosts
 
    -s, --sudo         
             #run operations with sudo (nopasswd) (deprecated, use become)
             #相当于Linux系统下的sudo命令
    -U SUDO_USER, --sudo-user=SUDO_USER
             #desired sudo user (default=root) (deprecated, use become)
             #使用sudo,相当于Linux下的sudo命令
    -S, --su           
             #run operations with su (deprecated, use become)
             #
    -R SU_USER, --su-user=SU_USER
             #run operations with su as this user (default=root)(deprecated, use become)
    -b, --become       
             #run operations with become (does not imply password prompting)
             #
    --become-method=BECOME_METHOD
             #privilege escalation method to use (default=sudo),valid choices: [ sudo | su | pbrun | pfexec | doas |dzdo | ksu | runas ]
             #
    --become-user=BECOME_USER
             #run operations as this user (default=root)
             #
    --ask-sudo-pass    
             #ask for sudo password (deprecated, use become)
             #传递sudo密码到远程主机,来保证sudo命令的正常运行
    --ask-su-pass      
             #ask for su password (deprecated, use become)
             #
    -K, --ask-become-pass
             #ask for privilege escalation password
             #

ansible-playbook需要注意的两个命令
1)检查语法,只检查是否是yaml语法格式。并不做逻辑校验。(记住这个要经常使用, 它是判断语法是否正确!!!)
# ansible-playbook --syntax-check kevin.yml
2)模拟执行(不是真的执行)
# ansible-playbook -C kevin.yml

关闭Facts
如果不需要使用主机的任何fact数据,可以选择关闭fact数据的获取,这样有利于增强Ansible面对大量系统的push模块。
在playbook中关闭Facts方法(gather_facts: no):

---
- hosts: webserver
  gather_facts: no

palybook书写格式

---                                   # 也可以不使用这一行。可以省略。
- hosts: 172.16.60.211                #处理指定服务器.   - (空格)hosts:(空格)172.16.20.211
  task:                               #剧本所要干的事情; (空格)(空格)task:
  - name:                             #(两个空格)-(空格)name。
    command: echo hello clsn linux    #(四个空格)command:(空格) 

需要注意:
Task任务里的name可以省略不写,将-(空格)放到下一行模块墙面。例如:
---                                   
- hosts: 172.16.60.211               
  task:                             
  - command: echo hello clsn linux

小示例:
[root@localhost ansible]# cat haha.yaml 
---
- hosts: test_host
  remote_user: root
  gather_facts: no
  tasks:
     - file: path=/opt/task1.txt state=touch

palybook格式示例

[root@ansible-server ~]# vim /etc/ansible/test.yaml
- hosts: 172.16.60.213
  tasks:
    - name: Install Rsync
      yum: name=rsync state=installed

playbook检查方法
[root@ansible-server ~]# ansible-playbook --syntax-check /etc/ansible/test.yaml

playbook: /etc/ansible/test.yaml
[root@ansible-server ~]# ansible-playbook -C /etc/ansible/test.yaml

PLAY [172.16.60.213] *******************************************************************************************************************

TASK [Gathering Facts] *****************************************************************************************************************
ok: [172.16.60.213]

TASK [Install Rsync] *******************************************************************************************************************
ok: [172.16.60.213]

PLAY RECAP *****************************************************************************************************************************
172.16.60.213              : ok=2    changed=0    unreachable=0    failed=0  

上面两个检查命令, 第一个是进行playbook剧本配置信息语法检查; 第二个是模拟playbook剧本执行(彩排)

palybook剧本文件示例

ansible-playbook编写内容扩展剧本任务编写多个任务

- hosts: all
  tasks:
    - name: restart-network
      cron: name='restart network' minute=00 hour=00 job='/usr/sbin/ntpdate time.nist.gov >/dev/null 2>&1'
    - name: sync time
      cron: name='sync time' minute=*/5 job="/usr/sbin/ntpdate pool.ntp.com >/dev/null 2>&1"

剧本编写内容扩展:剧本任务编写多个主机

- hosts: 172.16.60.7
  tasks:
    - name: restart-network
      cron: name='restart network' minute=00 hour=00 job='/usr/sbin/ntpdate time.nist.gov >/dev/null 2>&1'
    - name: sync time
      cron: name='sync time' minute=*/5 job="/usr/sbin/ntpdate pool.ntp.com >/dev/null 2>&1"

- hosts: 172.16.60.31
  tasks:
    - name: show ip addr to file
      shell: echo $(hostname -i) >> /tmp/ip.txt

playbook剧本编写方式
-  多主机单任务编写方式
-  多主机多任务编写方式
-  不同主机多任务编写方式

来看一个比较完整的ansible的yml文件写法:

---
- host: webservers       ###要管理的远程服务器组名称, 服务器地址维护在/etc/ansible/hosts 里, 也可以直接写地址
  vars:
    port: 8081           ###定义了一个变量 端口号
  remote_user: root      ###远程登录后用什么用户执行
 
  pre_tasks:             ###执行正式 task 之前执行的任务
  - name: pre task       ###任务名称
    shell: echo 'execute pre task'      ###执行一行 shell 命令, 支持 >> 等符号
 
  roles:            ###引入 roles, 可以理解为引用了一个其他项目 ansible 包, 引用的 roles 可以是另一个完整的 ansible 脚本
  - role: my_role   ###要引用的 role 名称
    when: "ansible_os_family == 'RedHat'"   ###判断条件, ansible_os_family 是一个内置变量, 可直接使用
 
  tasks:           ###按顺序执行以下 task
  - include: my_tasks/some_task.yml       ###可以引入其他 yml 文件
  - name: get hostname        ###这是一个 task, 名称
    command: cat log.log      ###执行一行 command , 和 shell 类似, 但是不支持 >> 等操作符
    register: result          ###执行的结果, 设到 result 这个变量中, 后面可以使用
  - name: set hostname 
    shell: cat {{result.stdout}} >> host.text
  - name: task1
    command: echo 'execute task1'
  - name: task2 start apache
    service:             ###启动 httpd 服务器, service 是一个 ansible 内置模块, 读者可以自行查看更多模块, 包括下载复制等等
      name: httpd
      state: started
      tags:
        - apache        ###这是一个标签, 可以用 ansible-playbook main.yml --tags "apache" 指定只执行这个任务
  - name: copy and set value of index.html
    template:           ###这是一个复制方法, 也叫模块, 并且.j2文件中可以使用{{}}来设置需要替换的变量 
      src: templates/index.html.j2
      dest: /etc/httpd/index.html
    notify:             ###唤醒执行后面的 handlers 中名字叫 restart apache 的任务
    - restart apache
 
  post_tasks:           ###最后需要执行的任务
  - name: posy task
    shell: echo 'execute post task'
 
  handlers:
  - name: restart apache
    debug:              ###这是一个打印模块
      msg: start restart apche

palybook剧本中的方法

1.  handlers 任务触发
在需要被监控的任务(tasks)中定义一个notify,只有当这个任务被执行时,才会触发notify对应的handlers去执行相应操作。例如配置文件被修改后,有可能需要重启程序,此时我们可以配置一个handlers,类似触发器。注意:handlers下的name名称必须要和它对应的notify名称相同!否则不会执行!!

[root@localhost ~]# cat httpd.yaml 
---
- hosts: control-node
  remote_user: root
  vars:
    - pkg: httpd
  tasks:
    - name: "install httpd package."
      yum: name={{ pkg }}  state=installed
    - name: "copy httpd configure file to remote host."
      copy: src=/root/conf/httpd.conf dest=/etc/httpd/conf/httpd.conf
      notify: restart httpd
    - name: "boot httpd service."
      service: name=httpd state=started
  handlers:
    - name: restart httpd
      service: name=httpd state=restarted

########  在使用handlers的过程中,需要注意下面几点  ########
1. handlers只有在其所在的任务被执行完时,它才会被运行;如果一个任务中定义了notify调用Handlers,但由于条件判断等原因,该任务未被执行,则Handlers同样不会被执行。
2. handlers只会在Play的末尾运行一次;如果想在一个Playbook的中间运行handlers,则需要使用meta模块来实现,例如:-meta: flush_handlers。
3. 可以直接在Handlers中使用notify选项,实现Handlers调用Handlers。
4. 可以使用listen关键字,在一个tasks任务中一次性notify多个handler。即将多个handler分为"一组",使用相同的"组名"即可,当notify对应的值为"组名"时,"组"内的所有handler都会被notify。
5. 如果一个Play在运行到调用handlers的语句之前失败了,那么这个handlers将不会被执行。但是可以使用mega模块的--force-handlers选项来强制执行handlers,即使在handlers所在Play中途运行失败也能执行。需要注意:--force-handlers参数主要针对即使playbook执行失败,也要执行代码块成功了的handlers(即执行成功的task任务), 如果代码块本身执行失败(即执行失败的task任务),那么它所对应的handlers应当不会被执行!

handlers可以理解成另一种tasks,handlers是另一种"任务列表",可以理解handlers和tasks是"平级关系",所以他们的缩进相同。handlers的任务会被tasks中的任务进行"调用",但是,被"调用"并不意味着一定会执行,只有当tasks中的任务"真正执行"以后,handlers中被调用的任务才会执行,如果tasks中的任务并没有做出任何实际的操作,那么handlers中的任务即使被"调用",也并不会执行。handlers中可以有多个任务,被tasks中不同的任务notify。

场景1:headlers在所有tasks任务被执行完时才执行。

[root@localhost ansible]# cat haha.yaml
---
- hosts: test_host
  remote_user: root
  become: yes
  become_method: sudo
  tasks:
    - name: make file task1
      file: path=/opt/task1.txt state=touch
      notify: task1
    - name: make file task2
      file: path=/opt/task2.txt state=touch
      notify: task2
  handlers:
    - name: task1
      file: path=/opt/task1.txt mode=777 owner=root group=root
    - name: task2
      file: path=/opt/task2.txt src=/opt/task2.txt dest=/opt/heihei state=link force=yes

执行结果:
[root@localhost ansible]# ansible-playbook haha.yaml 

PLAY [test_host] *********************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.233]
ok: [172.16.60.234]

TASK [make file task1] ***************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

TASK [make file task2] ***************************************************************************************************************************
changed: [172.16.60.233]
changed: [172.16.60.234]

RUNNING HANDLER [task1] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

RUNNING HANDLER [task2] **************************************************************************************************************************
changed: [172.16.60.233]
changed: [172.16.60.234]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.233              : ok=5    changed=4    unreachable=0    failed=0   
172.16.60.234              : ok=5    changed=4    unreachable=0    failed=0

从上面运行结果看出,Handlers执行的顺序与Handlers在playbook中定义的顺序是相同的,与"handler"被notify的顺序无关。

场景2:使用meta模块,headlers会在它所对应的task任务执行完后立即被触发并执行,即在playbook的中间环节运行。
默认情况下,所有的task执行完毕后,才会执行各个handles,并不是执行完某个task后,立即执行相应的handler,如果想要在执行完某些task以后立即执行对应的handlre,那么需要使用meta模块。

[root@localhost ansible]# cat haha.yaml
---
- hosts: test_host
  remote_user: root
  become: yes
  become_method: sudo
  tasks:
    - name: make file task1
      file: path=/opt/task1.txt state=touch
      notify: task1
    - meta: flush_handlers
    - name: make file task2
      file: path=/opt/task2.txt state=touch
      notify: task2
  handlers:
    - name: task1
      file: path=/opt/task1.txt mode=777 owner=root group=root
    - name: task2
      file: path=/opt/task2.txt src=/opt/task2.txt dest=/opt/heihei state=link force=yes

执行结果:
[root@localhost ansible]# ansible-playbook haha.yaml 

PLAY [test_host] *********************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.234]
ok: [172.16.60.233]

TASK [make file task1] ***************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

RUNNING HANDLER [task1] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

TASK [make file task2] ***************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

RUNNING HANDLER [task2] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.233              : ok=5    changed=4    unreachable=0    failed=0   
172.16.60.234              : ok=5    changed=4    unreachable=0    failed=0 

上面使用了meta模块后,注意它的执行顺序于场景1做下对比!

场景3:Handlers调用Handlers
若实现Handlers调用Handlers,则直接在Handlers中使用notify选项即可以。

[root@localhost ansible]# cat haha.yaml
---
- hosts: test_host
  remote_user: root
  become: yes
  become_method: sudo
  tasks:
    - name: make file task1
      file: path=/opt/task1.txt state=touch
      notify: task1
    - name: make file task2
      file: path=/opt/task2.txt state=touch
       
  handlers:
    - name: task1
      file: path=/opt/task1.txt mode=777 owner=root group=root
      notify: task2
    - name: task2
      file: path=/opt/task2.txt src=/opt/task2.txt dest=/opt/heihei state=link force=yes
 
执行结果:
[root@localhost ansible]# ansible-playbook haha.yaml             
 
PLAY [test_host] *********************************************************************************************************************************
 
TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.234]
ok: [172.16.60.233]
 
TASK [make file task1] ***************************************************************************************************************************
changed: [172.16.60.233]
changed: [172.16.60.234]
 
TASK [make file task2] ***************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]
 
RUNNING HANDLER [task1] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]
 
RUNNING HANDLER [task2] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]
 
PLAY RECAP ***************************************************************************************************************************************
172.16.60.233              : ok=5    changed=4    unreachable=0    failed=0  
172.16.60.234              : ok=5    changed=4    unreachable=0    failed=0


注意:上面执行的顺序是:make file task1 > make file task2 > task1 > task2

====================================================================
也可以改成下面的方式:实现Handlers调用Handlers

[root@localhost ansible]# cat haha.yaml 
---
- hosts: test_host
  remote_user: root
  become: yes
  become_method: sudo
  tasks:
    - name: make file task1
      file: path=/opt/task1.txt state=touch
      notify: task1

  handlers:
    - name: task1
      file: path=/opt/task1.txt mode=777 owner=root group=root
      notify: task2
    - name: task2
      file: path=/opt/task2.txt state=touch
      notify: task3
    - name: task3
      file: path=/opt/task2.txt src=/opt/task2.txt dest=/opt/heihei state=link force=yes

执行结果:
[root@localhost ansible]# ansible-playbook haha.yaml 

PLAY [test_host] *********************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.233]
ok: [172.16.60.234]

TASK [make file task1] ***************************************************************************************************************************
changed: [172.16.60.233]
changed: [172.16.60.234]

RUNNING HANDLER [task1] **************************************************************************************************************************
changed: [172.16.60.233]
changed: [172.16.60.234]

RUNNING HANDLER [task2] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

RUNNING HANDLER [task3] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.233              : ok=5    changed=4    unreachable=0    failed=0   
172.16.60.234              : ok=5    changed=4    unreachable=0    failed=0  

注意:上面的执行顺序是:make file task1 > task1 > task2 > task3

场景4:使用listen关键字,在一个tasks任务中一次性notify多个handler
怎么才能一次性notify多个handler呢?如果尝试将多个handler使用相同的name呢?其实这样并不可行!因为当多个handler的name相同时,只有一个handler会被执行。要想实现一次notify多个handler,需要借助一个关键字,它就是"listen",可以把listen理解成"组名",可以把多个handler分成"组",当需要一次性notify多个handler时,只要将多个handler分为"一组",使用相同的"组名"即可,当notify对应的值为"组名"时,"组"内的所有handler都会被notify。需要注意:listen的名称要和notify名称保持一致!

[root@localhost ansible]# cat haha.yaml
---
- hosts: test_host
  remote_user: root
  become: yes
  become_method: sudo
  tasks:
    - name: make file task1
      file: path=/opt/task1.txt state=touch
      notify: group1_handler
  handlers:
    - name: task1
      listen: group1_handler
      file: path=/opt/task1.txt mode=777 owner=root group=root
    - name: task2
      listen: group1_handler
      file: path=/opt/task1.txt src=/opt/task1.txt dest=/opt/heihei state=link force=yes
    - name: task3
      listen: group1_handler
      shell: echo "this is test,haha...." >> /opt/task1.txt

执行结果:
[root@localhost ansible]# ansible-playbook haha.yaml 

PLAY [test_host] *********************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.233]
ok: [172.16.60.234]

TASK [make file task1] ***************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

RUNNING HANDLER [task1] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

RUNNING HANDLER [task2] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

RUNNING HANDLER [task3] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.233              : ok=5    changed=4    unreachable=0    failed=0   
172.16.60.234              : ok=5    changed=4    unreachable=0    failed=0

场景5:使用--force-handlers选项来强制执行handlers
当playbook剧本执行失败以后,handlers可能并没有被触发,也就不会执行了!如果想不管task任务是否成功执行,都强制执行handlers。在这个时候,可以在执行playbook的时候,添加--force-handlers来强制执行handlers!但是必须要注意的是:--force-handlers参数主要针对即使playbook执行失败,也要执行代码块成功了的handlers(即执行成功的task任务), 如果代码块本身执行失败(即执行失败的task任务),那么它所对应的handlers应当不会被执行!

[root@localhost ansible]# cat haha.yaml 
---
- hosts: test_host
  remote_user: root
  become: yes
  become_method: sudo
  tasks:
    - name: make file task1
      file: path=/opt/task1.txt state=touch
      notify: task1
    - name: make file task2
      file: path=/opt/kevin/task2.txt state=touch
      notify: task2
  handlers:
    - name: task1
      file: path=/opt/task1.txt mode=777 owner=root group=root
    - name: task2
      shell: ln -s /opt/task1.txt /opt/task2.txt

执行结果:
[root@localhost ansible]# ansible-playbook haha.yaml 

PLAY [test_host] *********************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.234]
ok: [172.16.60.233]

TASK [make file task1] ***************************************************************************************************************************
changed: [172.16.60.233]
changed: [172.16.60.234]

TASK [make file task2] ***************************************************************************************************************************
fatal: [172.16.60.234]: FAILED! => {"changed": false, "module_stderr": "", "module_stdout": "Traceback (most recent call last):\r\n  File \"/tmp/ansible_iNMDpU/ansible_module_file.py\", line 474, in <module>\r\n    main()\r\n  File \"/tmp/ansible_iNMDpU/ansible_module_file.py\", line 448, in main\r\n    open(b_path, 'wb').close()\r\nIOError: [Errno 2] No such file or directory: '/opt/kevin/task2.txt'\r\n", "msg": "MODULE FAILURE", "rc": 0}
fatal: [172.16.60.233]: FAILED! => {"changed": false, "module_stderr": "", "module_stdout": "Traceback (most recent call last):\r\n  File \"/tmp/ansible_OvTacW/ansible_module_file.py\", line 474, in <module>\r\n    main()\r\n  File \"/tmp/ansible_OvTacW/ansible_module_file.py\", line 448, in main\r\n    open(b_path, 'wb').close()\r\nIOError: [Errno 2] No such file or directory: '/opt/kevin/task2.txt'\r\n", "msg": "MODULE FAILURE", "rc": 0}

RUNNING HANDLER [task1] **************************************************************************************************************************
        to retry, use: --limit @/etc/ansible/haha.retry

PLAY RECAP ***************************************************************************************************************************************
172.16.60.233              : ok=2    changed=1    unreachable=0    failed=1   
172.16.60.234              : ok=2    changed=1    unreachable=0    failed=1 

如上执行结果,由于/opt/kevin目录不存在,导致task的第二个任务执行失败,这个时候handler根本没有被触发,也就不会执行。
即使第一个任务执行成功,但是它对应的第一个handler也不会被执行!!

###################################################################################
接下来使用--force-handlers选项来强制执行handlers(强制执行的是:成功执行的task对应的handler)
[root@localhost ansible]# ansible-playbook haha.yaml --force-handlers

PLAY [test_host] *********************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.234]
ok: [172.16.60.233]

TASK [make file task1] ***************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]

TASK [make file task2] ***************************************************************************************************************************
fatal: [172.16.60.233]: FAILED! => {"changed": false, "module_stderr": "", "module_stdout": "Traceback (most recent call last):\r\n  File \"/tmp/ansible_rEJQHm/ansible_module_file.py\", line 474, in <module>\r\n    main()\r\n  File \"/tmp/ansible_rEJQHm/ansible_module_file.py\", line 448, in main\r\n    open(b_path, 'wb').close()\r\nIOError: [Errno 2] No such file or directory: '/opt/kevin/task2.txt'\r\n", "msg": "MODULE FAILURE", "rc": 0}
fatal: [172.16.60.234]: FAILED! => {"changed": false, "module_stderr": "", "module_stdout": "Traceback (most recent call last):\r\n  File \"/tmp/ansible_7CDxpp/ansible_module_file.py\", line 474, in <module>\r\n    main()\r\n  File \"/tmp/ansible_7CDxpp/ansible_module_file.py\", line 448, in main\r\n    open(b_path, 'wb').close()\r\nIOError: [Errno 2] No such file or directory: '/opt/kevin/task2.txt'\r\n", "msg": "MODULE FAILURE", "rc": 0}

RUNNING HANDLER [task1] **************************************************************************************************************************
changed: [172.16.60.234]
changed: [172.16.60.233]
        to retry, use: --limit @/etc/ansible/haha.retry

PLAY RECAP ***************************************************************************************************************************************
172.16.60.233              : ok=3    changed=2    unreachable=0    failed=1   
172.16.60.234              : ok=3    changed=2    unreachable=0    failed=1 

如上执行结果,即使playbook执行中有task任务执行失败,但是执行成功的task任务所调用的handler依然会被强制触发并执行!但是执行失败的task任务所调用的handler依然不会被执行。
即handlers中的task1会被执行,task2不会被执行!

2.  tags任务标签
tags用于让用户选择运行playbook中的部分代码。ansible具有幂等性,因此会自动跳过没有变化的部分,即便如此,有些代码为测试其确实没有发生变化的时间依然会非常地长。此时如果确信其没有变化,就可以通过tags跳过此些代码片断。tags可以看作是ansible的任务控制!

ansible的标签(Tags)功能可以给角色(Roles)、文件、单独的任务,甚至整个Playbook打上标签,然后利用这些标签来指定要运行Playbook中的个别任务,或不执行指定的任务。如果有一个很大的playbook剧本,而只想运行playbook其中的某个或部分task任务,而不是运行playbook中所有的任务,这个时候tags是你的最佳选择。

2.1  ansible支持"tags:"属性,执行playbook时,可以通过两种方式根据"tags"过滤任务:
1. 在命令行上,使用或选项"--tags--skip-tags",后面使用空格或"="都可以。
2. 在ansible配置设置中,使用和选项"TAGS_RUNTAGS_SKIP";
3. 可以使用"--list-tags"查看playbook中有哪些tags会被执行;

2.2  ansible系统中内置的特殊tags(目前有5个特殊的tags)
到ansible 2.5版本以后,目前系统内置的tags有以下几个:
always: 除非--skip-tags指定这个标签,否则该标记为always的task一直都会执行。"--tags always"只执行标记了always的tasks;
never: 除非--tags指定了这个标签,否则该标记为never的task一直都不会执行。"--tags never"执行标记了always和never的tasks;
tagged: --tags tagged表示执行所有有tags标签的tasks任务,但不包括tags标签是never的tasks任务;--skip-tags tagged表示所有有tags标签的tasks任务都跳过,即不会执行。
untagged: --tags untagged表示执行所有没有tags标签的tasks任务和tags标签为always的tasks任务;--skip-tags untagged效果相反!
all:--tags all表示执行所有的tags标签为非never的task,包括有tags标签和无tags标签的tasks。

执行ansible-playbook命令时,使用下面两个参数的含义(自定义的tags可以是单个,也可以是多个,多个之间使用逗号隔开):
"--tags 自定义的tag" 表示执行tags为指定的标签名的tasks和tags为always的tasks。如果执行命令ansible-playbook site.yml 时不指定tags,则会执行所有tags为非never的tasks
"--skip-tags 自定义tag" 表示执行所有非指定tag和非never的tasks

2.3  tags标签配置语法有下面三种:

语法一:
tags:
  - tag_test
 
语法二:
tags: tag_test
 
语法三:
tags: ['tag_test']

2.3  ansible的tags使用
1)最常见的使用形式。一个task任务添加一个tags标签。

官方示例如下:
[root@localhost ansible]# vim example.yml
---
- hosts: all
  remote_user: root
  gather_facts: no
  tasks:
    - yum: name={{ item }} state=installed
      with_items:
         - httpd
         - memcached
      tags:
         - packages
    - template: src=templates/src.j2 dest=/etc/foo.conf
      tags:
         - configuration

此时如果希望只run其中的某个task,则run的时候指定tags即可。可以运行多个tags,中间使用逗号隔开;也可以运行单个tags。

[root@localhost ansible]# ansible-playbook example.yml --tags "configuration,packages"   
[root@localhost ansible]# ansible-playbook example.yml --tags configuration   
[root@localhost ansible]# ansible-playbook example.yml --tags packages
或者
[root@localhost ansible]# ansible-playbook example.yml --tags="configuration,packages"   
[root@localhost ansible]# ansible-playbook example.yml --tags=configuration   
[root@localhost ansible]# ansible-playbook example.yml --tags=packages

相反,也可以使用--skip-tags跳过某个task任务。

[root@localhost ansible]# ansible-playbook example.yml --skip-tags configuration
或者
[root@localhost ansible]# ansible-playbook example.yml --skip-tags=configuration

具体看下面示例(tags三种语法都用上):

[root@localhost ansible]# cat haha.yaml
---
- hosts: test_host
  remote_user: root
  gather_facts: no
  tasks:
    - name: task1
      file: path=/opt/task1.txt state=touch
      tags: make_task1
    - name: task2
      file: path=/opt/task2.txt state=touch
      tags:
         - make_task2
    - name: task3
      file: path=/opt/task2.txt src=/opt/task2.txt dest=/opt/heihei state=link force=yes
      tags: ['link_task3']

只运行make_task1标签的task任务
[root@localhost ansible]# ansible-playbook haha.yaml --tags make_task1

PLAY [test_host] *********************************************************************************************************************************

TASK [task1] *************************************************************************************************************************************
changed: [172.16.60.234]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.234              : ok=1    changed=1    unreachable=0    failed=0   

运行多个tags
[root@localhost ansible]# ansible-playbook haha.yaml --tags make_task1,make_task2

PLAY [test_host] *********************************************************************************************************************************

TASK [task1] *************************************************************************************************************************************
changed: [172.16.60.234]

TASK [task2] *************************************************************************************************************************************
changed: [172.16.60.234]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.234              : ok=2    changed=2    unreachable=0    failed=0

跳过make_task2标签的任务,其他任务正常执行
[root@localhost ansible]# ansible-playbook haha.yaml --skip-tags make_task2

PLAY [test_host] *********************************************************************************************************************************

TASK [task1] *************************************************************************************************************************************
changed: [172.16.60.234]

TASK [task3] *************************************************************************************************************************************
changed: [172.16.60.234]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.234              : ok=2    changed=2    unreachable=0    failed=0 

2)一个task任务添加多个tags标签。
上面是一个task任务添加一个tags标签,其实一个task任务可以添加多个标签,而且不同的task任务可以使用相同的tags标签。

一个任务添加多个tags标签的语法仍然也有三种:
语法1:
tags:
  - tag1
  - tag2

语法2:
tags: tag1,tag2

语法3:
tags: ['tag1,tag2']

========================================================
具体示例如下:
[root@localhost ansible]# vim https.yml
---
- hosts: test_host
  remote_user: root
  tasks:
     - name: install httpd package
       tags: 
         - httpd
         - package
       yum:
         name=httpd
         state=latest
 
     - name: start up httpd service
       tags: httpd,service
       service:
         name: httpd
         state: started


上面例子中每个任务都有多个标签,而且上例中两个任务都有一个共同的标签,就是httpd标签。
所以当执行"ansible-playbook httpd.yml --tags=httpd"时,上面两个task任务都会被执行。

由于上面例子中的所有任务都有共同的httpd标签,所以像这种情况,可以把httpd标签提取出来并写在play剧本中,示例如下:
[root@localhost ansible]# vim https.yml
---
- hosts: test_host
  remote_user: root
  tags:httpd
  tasks:
     - name: install httpd package
       tags: 
          - package
       yum:
         name=httpd
         state=latest
 
     - name: start up httpd service
       tags: ['service']
       service:
         name: httpd
         state: started

需要注意:当tags写在play剧本中而非写在task任务中时,play中的所有task任务都会继续当前paly中的tags,就像上例中,两个任务都会继承httpds的tag标签,同时还拥有自己的tag标签。

3)内置的特殊tags的用法
上面已经介绍了5个内置的特殊的tags,每个都有其自身的用意。如下以always关键字的tags为例:如果把任务的tags值指定为always时,那么这个任务就总是被执行,除非使用"--skip-tags"选项明确指定不执行对应任务的tags标签。

[root@localhost ansible]# cat haha.yaml 
---
- hosts: test_host
  remote_user: root
  gather_facts: no
  tasks:
    - name: task1
      file: path=/opt/task1.txt state=touch
      tags: make_task1
    - name: task2
      file: path=/opt/task2.txt state=touch
      tags:
         - always
    - name: task3
      file: path=/opt/task2.txt src=/opt/task2.txt dest=/opt/heihei state=link force=yes
      tags: ['link_task3']

执行1:如下,虽然tags指定了执行标签为make_task1的任务,但是由于任务2的标签有关键字always,所以任务2也会被执行,这就是always的作用!
[root@localhost ansible]# ansible-playbook haha.yaml --tags=make_task1

PLAY [test_host] *********************************************************************************************************************************

TASK [task1] *************************************************************************************************************************************
changed: [172.16.60.234]

TASK [task2] *************************************************************************************************************************************
changed: [172.16.60.234]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.234              : ok=2    changed=2    unreachable=0    failed=0  

执行2: 只执行标签为always的任务
[root@localhost ansible]# ansible-playbook haha.yaml --tags always
或者
[root@localhost ansible]# ansible-playbook haha.yaml --tags=always

PLAY [test_host] *********************************************************************************************************************************

TASK [task2] *************************************************************************************************************************************
changed: [172.16.60.234]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.234              : ok=1    changed=1    unreachable=0    failed=0

执行3: 跳过标签为always关键字的任务,这里明确指出跳过执行always标签。
[root@localhost ansible]# ansible-playbook haha.yaml --skip-tags always    

PLAY [test_host] *********************************************************************************************************************************

TASK [task1] *************************************************************************************************************************************
changed: [172.16.60.234]

TASK [task3] *************************************************************************************************************************************
ok: [172.16.60.234]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.234              : ok=2    changed=1    unreachable=0    failed=0   

其他四个特殊的tags标签在这里就不做示例说明了。特殊tags标签可以在ansible-playbook命令执行时直接使用。

4)tags标签可以和role 结合使用

[root@localhost ansible]# cat test.yml
---
roles:
  - { role: webserver, port: 5000, tags: [ 'web', 'foo' ] }

5)tags和include结合使用。

[root@localhost ansible]# cat test.yml
---
- include: kevin.yml tags=web,foo

如上,对一个include任务打了两个tags标签,直接执行"ansible_playbook test.yml" 或 "ansible_playbook test.yml --tags=web" 或 "ansible_playbook test.yml --tags=foo" 命令则会将kevin.yml文件中所有task任务都执行。

再来看看一个include结合tags的示例:通过指定标签(tags),来说明是安装tomcat7还是tomcat8

tomcat.yml文件

---
- include: install_tomcat7.yml
  tags: tomcat7
- include: install_tomcat8.yml
  tags: tomcat8

install_tomcat7.yml文件

---
- name: "复制文件到远程主机"
  copy:
    src={{ item.src }}
    dest={{ item.dest }}
  with_items:
    - src: jdk-7u79-linux-x64.rpm
      dest: /usr/local/src/
    - src: java17.sh
      dest: /etc/profile.d/
- name: "安装jdk"
  yum:
    name: /usr/local/src/jdk-7u79-linux-x64.rpm
    state: present
- name: "重新加载环境变量"
  shell: "source /etc/profile.d/java17.sh"
- name: "复制tomcat文件到远程服务器并解压"
  unarchive:
    src=apache-tomcat-7.0.64.zip
    dest=/data/
    copy=yes
    owner=staplesapp
    group=admin
- name: "对解压后的文件重命名"
  shell: mv /data/apache-tomcat-7.0.64 /data/tomcat7
- name: "对tomcat进行相关配置"
  shell: find /data/tomcat7/bin -name "*.sh" | xargs chmod +x
- name: "启动tomcat"
  shell: 'nohup /data/tomcat7/bin/startup.sh &'

install_tomcat8.yml文件

---
- name: "复制文件到远程主机"
  copy:
    src={{ item.src }}
    dest={{ item.dest }}
  with_items:
    - src: jdk-8u111-linux-x64.rpm
      dest: /usr/local/src/
    - src: java18.sh
      dest: /etc/profile.d/
- name: "安装jdk"
  yum:
    name: /usr/local/src/jdk-8u111-linux-x64.rpm
    state: present
- name: "配置java环境变量"
  shell: "source /etc/profile.d/java18.sh"
- name: "安装tomcat"
  unarchive:
      src=apache-tomcat-8.0.30.tar.gz
      dest=/data/
      copy=yes
      owner=staplesapp
      group=admin
- name: "对解压后的文件重命名"
  shell: mv /data/apache-tomcat-8.0.30 /data/tomcat8
- name: "启动tomcat"
  shell: 'nohup /data/tomcat8/bin/startup.sh &'

下面开始执行命令:

安装tomcat7:
[root@localhost ansible]# ansible-playbook tomcat.yml --tags tomcat7

安装tomcat8:
[root@localhost ansible]# ansible-playbook tomcat.yml --tags tomcat8

这里需要特别注意:
在之前ansible版本中使用include 整合多个roles至统一入口结合tags标签来管理roles剧本,但在ansible2.8版本之后将会删除include语法,更改为import_playbook。如果还使用include语法也可以,只不过ansible-playbook执行结果中会有告警信息:"DEPRECATION WARNING]:'include' for playbook includes. You should use 'import_playbook' instead. This feature will be removed in version 2.8. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg."。所以,最好将上面tomcat.yml文件中的include语法改成import_playbook,如下:

[root@localhost ansible]# cat tomcat.yml
---
- import_playbook: install_tomcat7.yml
  tags: tomcat7
- import_playbook: install_tomcat8.yml
  tags: tomcat8

3.  include用法
如果想在playbook中重复使用任务列表,则可以使用include文件来执行此操作。 使用include的任务列表是定义系统将要实现的角色的好方法。主要清楚:ansible2.8版本之后include语法变成了import_playbook。如果还是使用include,则不会影响执行结果,只不过是有告警信息。ansible也可以将变量传递给include。示例如下:

示例1: 通过Include,可以在playbook中引用另一个playbook或者tasks
==============================================================
[root@localhost ansible]# cat install_MysqlAndPhp.yml
- yum:
    name: mysql
    state: present
- yum:
    name: php-fpm
    state: present

[root@localhost ansible]# cat lamp.yml
---
- hosts: test_host
  remote_user: root
  gather_facts: no
  tasks:
  - include: install_MysqlAndPhp.yml
  - yum:
      name: httpd
      state: present
 
[root@localhost ansible]# cat lnmp.yml
---
- hosts: test_host
  remote_user: root
  gather_facts: no
  tasks:
    - include: install_MysqlAndPhp.yml
    - yum:
        name: nginx
        state: present


示例2: 可以在handler中引用include
==============================================================
[root@localhost ansible]# cat test_include.yml
---
- hosts: test_host
  remote_user: root
  gather_facts: no
  tasks:
    - file:
        path: /opt/ttt
        state: touch
      notify: test include handlers
 
  handlers:
    - name: test include handlers
      include: include_handler.yml
 
[root@localhost ansible]# cat include_handler.yml
- debug:
    msg: "task1 of handlers"
- debug:
    msg: "task2 of handlers"
- debug:
    msg: "task3 of handlers"

示例3: when在include中使用
==============================================================
[root@localhost ansible]# cat /etc/ansible/hosts
[db]
192.168.24.10
[app]
192.168.24.11

[root@localhost ansible]# cat install_client.yml
---
- hosts: '` hosts `'
  user: ansible
  sudo: yes
  sudo_user:root
  roles:
    - install_client

[root@localhost ansible]# cat roles/install_client/tasks/main.yml  
---
- include: db.yml
  when: "hosts == 'db'"
- include: app.yml
  when: "hosts == 'app'"

[root@localhost ansible]# cat roles/install_client/tasks/db.yml
---
  - name: Touchdb file
    shell: touch /tmp/db.txt

[root@localhost ansible]# cat roles/install_client/tasks/app.yml
---
  - name: Touchdb file
    shell: touch /tmp/db.txt

执行命令:
[root@localhost ansible]# ansible-playbook -i hosts install_client.yml --extra-vars "hosts=db"
[root@localhost ansible]# ansible-playbook -i hosts install_client.yml --extra-vars "hosts=app"

示例4: 可以在include中使用tags标签,这个在上面已经介绍过了
==============================================================

4.  role用法
角色(roles)是ansible自1.2版本开始引入的新特性,用于层次性,结构化地组织playbook。roles能够根据层次型结构自动装载变量文件、tasks以及handlers等。要使用roles只需要在playbook中使用include指令即可。简单的说,roles就是通过分别将变量、文件、任务、模块及处理器放置于单独的目录中、并可以便捷地include他们的一种机制。角色一般用于基于主机构建服务的场景中、但也可以是用于构建守护进程等场景中。role主要作用是重用playbook,例如无论安装什么软件都会安装时间同步服务,那么每个playbook都要编写ntp task,可以将ntp task写好,等到用的时候再调用就行了。ansible中将其组织成role,它有着固定的组织格式,以便playbook调用。

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

roles/
    role_name/:定义的role的名字
    file/:     用于存放copy或script等模块调用的函数
    tasks/:     用于定义各种task,此目录一定要有main.yml;其他文件需要main.yml包含调用
    handlers/: 用于定义各种handlers,此目录一定要有main.yml;其他文件需要main.yml包含调用
    vars/:      用于定义variables,此目录一定要有main.yml;其他文件需要main.yml包含调用
    templates/:存储由template模块调用的模板文本;
    meta/:     定义当前角色的特殊设定及其依赖关系,此目录中至少应该有一个名为main.yml的文件;其它的文件需要由main.yml进行"包含"调用;
    default/:  此目录中至少应该有一个名为main.yml的文件,用于设定默认变量;

[root@localhost ansible]# ll roles/
total 40
drwkebor-kebor-kebo 8 root root 4096 Jul 29 22:13 web_Deploy
drwkebor-kebor-kebo 8 root root 4096 May  7  2019 web_Deploy_af

[root@localhost ansible]# ll roles/web_Deploy                   
total 25
-rw-r--r-- 1 root root   45 May  7  2019 web_Deploy.yml
drwkebor-kebor-kebo 2 root root 4096 Jul 10 19:09 defaults
drwkebor-kebor-kebo 2 root root 4096 May  7  2019 handlers
drwkebor-kebor-kebo 2 root root 4096 May  7  2019 meta
drwkebor-kebor-kebo 2 root root 4096 Dec 26 19:42 tasks
drwkebor-kebor-kebo 2 root root 4096 May  7  2019 templates
drwkebor-kebor-kebo 2 root root 4096 May  7  2019 vars

[root@localhost ansible]# ll roles/web_Deploy/tasks/
total 35
-rwkebor-kebor-kebo 1 root root 1542 Jun 24  2019 Auth.yml
-rwkebor-kebor-kebo 1 root root 1482 Oct 11 16:13 StartService.yml
-rwkebor-kebor-kebo 1 root root  963 Jun 18  2019 main.yml
-rwkebor-kebor-kebo 1 root root 1415 May  7  2019 StopService.yml

[root@localhost ansible]# cat roles/web_Deploy/tasks/main.yml 
---
- include_tasks: Auth.yml
  tags: userauth
  
- include_tasks: StopService.yml 
  tags: stopservice
- include_tasks: StartService.yml 
  tags: startservice 

[root@localhost ansible]# cat roles/web_Deploy/web_Deploy.yml 
---
- hosts: all
  roles:
    - web_Deploy

===================================================================================
再如下一个项目的role目录结构:
site.yml
webservers.yml
fooservers.yml
roles/
   common/
     files/
     templates/
     tasks/
     handlers/
     vars/
     defaults/
     meta/
   webservers/
     files/
     templates/
     tasks/
     handlers/
     vars/
     defaults/
     meta/


再看下目录解释:
yml文件:用于定义此角色用到的各handler:在handler中使用include包含的其他的handler文件也应该位于此目录中;
files目录:存放由copy或script等模块调用的文件;
templates目录:templates模块会自动在此目录中寻找Jinja2模板文件;
tasks目录:至少应该包含一个名为main.yml的文件,其定义了此角色的任务列表;此文件可以使用include包含其他的位于此目录中的task文件;
handlers目录:此目录中应当包含一个main;
vars目录:应当包含一个main.yml文件,用于定义此角色用到的变量;
meta目录:应当包含一个main.yml文件,用于定义此角色的特殊设定及其依赖关系;ansible 1.3及其以后的版本才支持
default目录:为当前角色设定默认变量时使用此目录;应当包含一个main.yml文件;


那么一个playbook就可以这样写:
---
 - hosts: webservers
  roles:
     - common
     - webservers

这个playbook为一个角色"kebo"指定了如下的行为:
如果 roles/kebo/tasks/main.yml 存在, 其中列出的tasks将被添加到play中
如果roles/kebo/handlers/main.yml 存在, 其中列出的handlers将被添加到play中
如果roles/kebo/vars/main.yml 存在, 其中列出的variables将被添加到play中
如果roles/kebo/meta/main.yml 存在, 其中列出的 "角色依赖"将被添加到roles列表中 (1.3 andlater)
所有 copy tasks 可以引用 roles/kebo/files/ 中的文件,不需要指明文件的路径。
所有 scripttasks 可以引用 roles/kebo/files/ 中的脚本,不需要指明文件的路径。
所有 template tasks 可以引用roles/kebo/templates/ 中的文件,不需要指明文件的路径。
所有 include tasks 可以引用roles/kebo/tasks/ 中的文件,不需要指明文件的路径。

如果roles目录下有文件不存在,这些文件将被忽略。比如 roles目录下面缺少了"vars/"目录,这也没关系。

需要注意:
仍然可以在playbook中松散地列出tasks,vars_files 以及 handlers,这种方式仍然可用,但是roles是一种很好的具有组织性的功能特性,强烈建议使用它。
如果在playbook中同时使用roles和tasks,vars_files 或者 handlers,roles 将优先执行。

而且也可以使用参数化的roles,这种方式通过添加变量来实现,比如:
--
- hosts: webservers
  roles:
    - common
    - { role: foo_app_instance, dir: '/opt/a',  port: 5000 }
    - { role: foo_app_instance, dir: '/opt/b',  port: 5001 }

当一些事情不需要频繁去做时,也可以为 roles 设置触发条件,像这样:
---
- hosts: webservers
  roles:
    - { role: some_role, when: "ansible_os_family == 'RedHat'" }
它的工作方式是:将条件子句应用到 role 中的每一个 task 上。

也可以给role分配指定的标签,比如:
---
- hosts: webservers
  roles:
    - { role: foo, tags: ["bar", "baz"] }

如果play仍然包含有 "tasks" section,这些 tasks 将在所有 roles 应用完成之后才被执行。也可定义一些tasks,让它们在roles之前以及之后执行,可以这样做:
---
- hosts: webservers
  pre_tasks:
    - shell: echo 'hello'
  roles:
    - { role: some_role }
  tasks:
    - shell: echo 'still busy'
  post_tasks:
    - shell: echo 'goodbye'

注意:
pre_tasks: 执行正式 task 之前执行的任务
post_tasks:最后需要执行的任务

4.2  在playbook中调用role

role存放的路径在配置文件/etc/ansible/ansible.cfg中定义。如下,发现ansible的roles目录定义到/root/app/script/ansible/roles路径下了!!
[root@localhost ansible]# cat /etc/ansible/ansible.cfg |grep roles_path
roles_path    = /etc/ansible/roles:/root/app/script/ansible/roles

在playbook中调用role的方式有三种,如下:
第一种:
- hosts: HOSTS
  remote_user: root
  roles:
    - ROLE_NAME1
    - ROLE_NAME2

第二种:除了字典第一个元素指明调用的role,后面是传递给role的变量
- hosts: HOSTS
  remote_user: root
  roles:
  - { role: ROLE_NAME1, VARIABLE1: VALUE1, ... }

第三种:when指明role调用的条件
- hosts: HOSTS
  remote_user: root
  roles:
  - { role: ROLE_NAME1, when: CONDITIONS }

4.3  调用role示例

0) 先来看看role的路径定义
[root@localhost ansible]# cat /etc/ansible/ansible.cfg|grep roles_path
roles_path    = /etc/ansible/roles:/etc/ansible/roles

1)目录结构
[root@localhost ansible]# tree /etc/ansible/roles
/etc/ansible/roles
└── httpd                   #palybook调用时role的名称
    ├── defaults
    ├── files
    └── handlers
    │   └── main.yml       #所有的目录文件,并不一定要有,用时才创建
    └── mata
    └── tasks
    │   └── main.yml
    └── tamplates
        └── httpd.conf.c6.j2  #centos6,centos7的配置文件
        └── httpd.conf.c7.j2

2)tasks文件
[root@localhost ansible]# cat /etc/ansible/roles/httpd/tasks/main.yml
- name: install httpd package
  yum: name=httpd state=present
- name: install configure file
  template: src=httpd.conf.c{{ ansible_distribution_major_version }}.j2 dest=/etc/httpd/conf/httpd.conf
  tags: instconf
  notify: restart httpd service
- name: start httpd service
  service: name=httpd state=started enabled=true

3) handlers文件
[root@localhost ansible]# cat /etc/ansible/roles/httpd/handlers/main.yml
- name: restart httpd service
  service: name=httpd state=restarted

4) 模板文件
[root@localhost ansible]# grep ^Listen /etc/ansible/roles/httpd/templates/httpd.conf.c6.j2
Lister {{ httpd_port }}

5) 变量
[root@localhost ansible]# cat /etc/ansible/roles/httpd/vars/main.yml
httpd_port: 8088

6) playbook文件
[root@localhost ansible]# cat /etc/ansible/httpd_conf.yml
---
- hosts: webservers
  remote_user: root
  roles:
  - { role: httpd }

7) 执行playbook文件,并查看httpd端口
[root@localhost ansible]# ansible-playbook -i /etc/ansible/hosts /etc/ansible/httpd_conf.yml
[root@localhost ansible]# ansible -i /etc/ansible/hosts webservers -m shell -a "ss -tnlp|grep :80"

========================================================================================================
再来看一例:
1.group: 创建用户组nginx
2.user: 创建用户nginx
3.yum: 安装nginx
4.template: 配置文件更新nginx.conf
5.service: 启动nginx

[root@localhost ~]# cat /etc/ansible/ansible.cfg|grep roles_path
roles_path    = /etc/ansible/roles:/root/ansible/roles

[root@localhost ~]# cd /root/ansible/roles/nginx
[root@localhost nginx]# mkdir tasks templates
[root@localhost nginx]# cd tasks

[root@localhost tasks]# vim group.yml
- name: create group nginx
    group: name=nginx gid=80

[root@localhost tasks]# vim user.yml
-name: create user nginx
    user: name=nginx uid=80 group=nginx system=yes shell=/sbi/nologin

[root@localhost tasks]# vim install.yml
- name: install package
    yum: name=nginx
   
[root@localhost tasks]# vim start.yml
- name: start service
    service: name=nginx state=started enabled=yes
    
[root@localhost tasks]# vim restart.yml
- name: restart service
    service: name=nginx state=restarted
    
[root@localhost tasks]# vim templ.yml
- name: copy conf
    template: src=nginx.conf.j2 dest=/etc/nginx/conf/nginx.conf
    
[root@localhost tasks]# vim main.yml
- include: group.yml
- include: user.yml
- include: install.yml
- include: templ.yml
- include: start.yml
      
[root@localhost tasks]# cd ../templates  && ls
nginx.conf.j2

[root@localhost tasks]# cd /root/ansible
[root@localhost ansible]# vim nginx_role.yml
- hosts: websrvs
  remote_user: root
  roles:
    - role: nginx

执行命令:
[root@localhost ansible]# ansible-playbook nginx_role.yml

5. loop列表循环用法
在ansible 2.5版本之前,大多数人习惯使用"with_X"风格的关键字操作循环,从ansible 2.6版本开始,官方开始推荐使用"loop"关键字代替"with_X"风格关键字。下面通过一些小示例来说明使用loop关键字进行的列表循环操作。[loop、with_items、with_list 三者等同,效果是一样的!]。ansible的循环使用,可以参考下面"循环变量"以及参考这里

playbook中的变量设置

########   变量的优先级   ########
1.  extra vars变量(在命令行中使用 -e);优先级最高
2.  在inventory中定义的连接变量(比如ansible_ssh_user);优先级第二
3.  大多数的其他变量(命令行转换,play中的变量,include的变量,role的变量等);优先级第三
4.  在inventory定义的其他变量;优先级第四
5.  有系统发现的facts;优先级第五
6.  "role默认变量",这个是最默认的值,很容易丧失优先权。优先级最小。

另外:在inventory清单列表里定义的变量:单个主机定义的变量优先级高于主机组定义的变量
经过实验,ansible使用inventory定义变量的优先级顺序从高到低为:
1. host_vars下定义变量
2. inventory中单个主机定义变量
3. group_vars下定义变量
4. inventory中组定义变量

playbook中定义变量,如下:

- hosts: webservers
  vars:
    http_port: 80

YAML陷阱
YAML语法要求如果值以{{ foo }}开头的话,那么就需要将整行用双引号包起来,这是为了确认你不是想声明一个YAML字典。
如下面配置是不行的!!!

---
- hosts: app_servers
  vars:
    app_path: {{ base_path }}/data/web

应该改成下面这样:

---
- hosts: app_servers
  vars:
    app_path: "{{ base_path }}/data/web"

########   Ansbile-playbook变量配置方法   ########

1.  在inventory主机清单文件中定义变量
可以直接定义在主机清单文件/etc/ansible/hosts中,表明该变量只对对应的主机或者组有效,对其余的主机和组无效。

有针对单个主机定义变量和组定义变量两种方式。
1)向不同的单个主机传递不同的变量;
IP/HOSTNAME  var1=value1 var2=value2

2)向组中的主机传递相同的变量;
[groupname:vars]
var1=value1
var2=value2

但是注意:
组定义变量的作用范围是组下的所有主机。
当两种定义方式同时存在时,ansible会优先采用单个主机定义的变量值!

[root@ss-server ansible]# pwd
/etc/ansible
[root@ss-server ansible]# cat hosts|egrep -v "^#|^$"
[kevin]
172.16.60.20 key=20180101
172.16.60.22 ansible_ssh_port=22288 key="niubility"
 
[root@ss-server ansible]# cat ansi.yml
---
- hosts: kevin
  gather_facts: False
  tasks:
    - name: haha
      debug: msg="the {{ inventory_hostname }} value is {{ key }}"
 
执行结果(注意inventory_hostname代表inventory列表列表里被控节点的主机名):
[root@ss-server ansible]# ansible-playbook ansi.yml
 
PLAY [kevin] *************************************************************************************************************************************
 
TASK [haha] **************************************************************************************************************************************
ok: [172.16.60.20] => {
    "msg": "the 172.16.60.20 value is 20180101"
}
ok: [172.16.60.22] => {
    "msg": "the 172.16.60.22 value is niubility"
}
 
PLAY RECAP ***************************************************************************************************************************************
172.16.60.20             : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0  
172.16.60.22             : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0  

再看下面一示例
[root@ss-server ansible]# tail -n 10 /etc/ansible/hosts
[webserver]
172.16.60.51 dir=/root/node2
172.16.60.80 dir=/root/node1

[node1]
172.16.60.80

[webserver:vars]
file=hostname.txt

[root@ss-server ansible]# cat playbook.yml
---
- hosts: webserver
  remote_user: root
  tasks:
    - name: Create New Folder
      file: name={{ dir }} state=directory
    - name: Create New Folder
      shell: echo `hostname` > {{dir}}/{{ file }}

执行结果:
[root@ss-server ansible]# ansible-playbook playbook.yml    

PLAY [webserver] ************************************************************************

TASK [Gathering Facts] ***************************************************************
ok: [172.16.60.80]
ok: [172.16.60.51]

TASK [Create New Folder] *************************************************************
changed: [172.16.60.51]
changed: [172.16.60.80]

TASK [Create New Folder] *************************************************************
changed: [172.16.60.51]
changed: [172.16.60.80]

PLAY RECAP ***************************************************************************
172.16.60.51              : ok=3    changed=2    unreachable=0    failed=0   
172.16.60.80              : ok=3    changed=2    unreachable=0    failed=0 

此外:ansible还内置了一些固定的主机变量名,在inventory中定义其值, 在另一篇文章中介绍过。

2.  通过host_vars和group_vars目录来定义变量
/etc/ansible/目录是linux系统上ansible默认的配置文件目录(Mac系统上的话,其默认配置目录是在/usr/local/etc/ansible/),在该目录下创建host_vars和group_vars两个目录用来存放定义变量的文件。

1)针对单个主机的变量  
[root@ss-server ansible]# pwd
/etc/ansible
[root@ss-server ansible]# cat host_vars/172.16.60.20
---
user: root
pass: root@123

2)针对test组的变量 
[root@ss-server ansible]# cat group_vars/kevin
---
user: work
pass: work@123

############ 在inventory清单列表文件里,单个主机定义的变量优先级高于主机组定义的变量 ############
############ 经过实验,ansible使用变量的优先级顺序从高到低为 #############
1. host_vars下定义变量
2. inventory中单个主机定义变量
3. group_vars下定义变量
4. inventory中组定义变量

示例如下:
[root@ss-server ~]# cat /root/ansible/hosts
[kevin]
172.16.60.20 ansible_ssh_port=22222
172.16.60.21 ansible_ssh_port=22288

[root@ss-server ~]# cat /root/ansible/group_vars/kevin
key=20191010

[root@ss-server ~]# cat /root/ansible/bo.yml
---
- hosts: kevin
  remote_user: root
  tasks:
    - debug: msg='The key is {{key}} '

[root@ss-server ~]# ansible-playbook /root/ansible/bo.yml
 
PLAY [kevin] *************************************************************************************************************************************
 
TASK [haha] **************************************************************************************************************************************
ok: [172.16.60.20] => {
    "msg": "The key is 20191010"
}
ok: [172.16.60.22] => {
    "msg": "The key is 20191010"
}
 
PLAY RECAP ***************************************************************************************************************************************
172.16.60.20             : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0  
172.16.60.22             : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0 

3.  通过var_files定义变量

[root@ss-server ansible]# cat laoji.yml
---
key: jiayou

[root@ss-server ansible]# cat bo.yml
---
- hosts: kevin
  gather_facts: False
  vars_files:
      - laoji.yml
  tasks:
    - name: display
      debug: msg="the {{ inventory_hostname }} valus is {{ key }}"
 
执行结果:
[root@ss-server ansible]# ansible-playbook bo.yml
PALY [kevin] ****************************************************
 
TASK [display] ****************************************************
ok: [172.16.60.20] => {
    "changed": false
    "msg":"the 172.16.60.20 value is jiayou"
}
 
PLAY RECAP ****************************************************
172.16.60.20         : ok=1  changed=0  unreachable=0  failed=0

4.  通过vars_prompt交互式传入变量
在playbook中定义vars_prompt的变量名和交互式提示信息,就可以实现在运行playbook时,通过交互的传入变量值。
private字段:用来定义交互时是否回显输入的值,默认private为yes;
default字段:用来定义变量的默认值。

[root@ss-server ansible]#  cat prom.yml
---
- hosts: kevin
  remote_user: root
  vars_prompt:
      - name: "var1"
        prompt: "please input you name"
        private: no
      - name: "var2"
        prompt: "please input you age"
        private: yes
        default: 'kevin var'
  tasks:
      - name: display var1
        debug: msg="your name of var1 is {{ var1 }}"
      - name: display var2
        debug: msg="you age of var2 is {{ var2 }}"
 
执行结果:
[root@ss-server ansible]# ansible-playbook prom.yml
your name of var1: wangzhaojun       #把输入的内容传递给变量var1。输入的值显示出来!!
you age of var2 [kevin var]:         #把输入的内容传递给默认变量kevin var。但是输入的值不显示出来!! 比如这里输入的30
 
PALY [kevin] ****************************************************
 
TASK [Gathering Facts] ****************************************************
OK: [172.16.60.20]
 
TASK [display var1] ****************************************************
ok: [172.16.60.20] =>{
    "msg": "youn name of var1 is wangzhaojun"
}
 
TASK [display var2] ****************************************************
ok: [172.16.60.20] =>{
    "msg": "youn name of var2 is 30"
}
 
PLAY RECAP ****************************************************
172.16.60.20         : ok=3  changed=0  unreachable=0  failed=0
 
接下来再来看一个"ansible 中prompt 交互变量的使用"的示例
[root@ss-server ansible]# cat haha.yml
---
- hosts: kevin
  remote_user: root
  vars_prompt:
     - name: "your_name"
       prompt: "what is your name"
       private: no
     - name: "your_age"
       prompt: "how old are you"
       private: no
     - name: "solution"
       prompt: "Choose the solution you want \n
       A: solutionA\n
       B: solutionB\n
       C: solutionC\n"
       private: no
       default: A
     - name: "user_name"
       prompt: "Enter user name"
       private: no
     - name: "user_password"
       prompt: "Enter user password"
       private: no
       encrypt: "sha512_crypt"
       confirm: yes
  tasks:
     - name: "output vars"
       debug: msg="your name is {{ your_name }},you are {{ your_age }} years old"
     - name: "output solution"
       debug: msg="the final solution is {{solution}}"
     - name: "create_user"
       user:
         name: "{{user_name}}"
         password: "{{user_password}}"
     - name: "debug_create user"
       debug: msg="create user {{user_name}} in"
 
执行结果为:
[root@ss-server ansible]# ansible-playbook haha.yml
what is your name: wangshibo
how old are you: 29
Choose the solution you want
 A: solutionA
 B: solutionB
 C: solutionC
 [A]: C
Enter user name: bobo
Enter user password: bobo123
confirm Enter user password: bobo123
 
PLAY [kevin] *************************************************************************************************************************************
 
TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.20]
 
TASK [output vars] *******************************************************************************************************************************
ok: [172.16.60.20] => {
    "msg": "your name is wangshibo,you are 29 years old"
}
 
TASK [output solution] ***************************************************************************************************************************
ok: [172.16.60.20] => {
    "msg": "the final solution is C"
}
 
TASK [create_user] *******************************************************************************************************************************
changed: [172.16.60.20]
 
TASK [debug_create user] *************************************************************************************************************************
ok: [172.16.60.20] => {
    "msg": "create user bobo in"
}
 
PLAY RECAP ***************************************************************************************************************************************
172.16.60.20                  : ok=5    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

5.  通过ansible-playbook命令行定义变量!即参数传入变量
除了"vars_prompt"和"vars_files",也可以通过Ansible命令行发送变量。如果想要编写一个通用的发布playbook时则特别有用!你可以传递应用的版本以便部署。例如下面命令(注意: --extra-vars 相等于 -e)

[root@ss-server ~]# ansible-playbook release.yml --extra-vars "version=1.78.34 other_variable=fos"
 
其他场景中,通过参数传入变量也是很有用的。比如为playbook设置主机群组或用户。如下:
[root@ss-server ~]# vim exap.yml
---
- hosts: '{{hosts}}'
  remote_user: '{{user}}'
  tasks:
    - name: "一个测试"
      debug: msg="your hosts is {{hosts}}, user is {{user}}"
 
执行的时候,通过参数传入变量(-e)。变量{{hosts}}可以是主机群组名称,也可以是主机ip。
[root@ss-server ansible]# ansible-playbook exap.yml -e "hosts=kevin user=root"   
[WARNING]: Found variable using reserved name: hosts
 
 
PLAY [kevin] *************************************************************************************************************************************
 
TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.20]
 
TASK [一个测试] **************************************************************************************************************************************
ok: [172.16.60.20] => {
    "msg": "your hosts is kevin, user is root"
}
 
PLAY RECAP ***************************************************************************************************************************************
172.16.60.20                  : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
 
在命令行里面传值的方法:
[root@ss-server ansible]# ansible-playbook amp.yml --extra-vars "hosts=webserver user=root"
 
还可以使用json格式传递参数:
[root@ss-server ansible]# ansible-playbook amp.yml --extra-vars "{'hosts':'webserver', 'user':'root'}"
 
还可以将参数放在文件里面进行传递(注意命令行里要是用"@文件名"):
[root@ss-server ansible]# ansible-playbook amp.yml --extra-vars "@anhui.yml"
[root@ss-server ansible]# cat anhui.yml
---
hosts: webserver
user: root

例如下面这个添加用户的plakbook剧本配置,用传递了json文件:
[root@ss-server ansible]# cat useradd.yml
---
- hosts: "{{ host }}"
    gather_facts: no
    remote_user: root
    vars:
      UserName: "{{ user }}"
      UserPassword: "{{ pass }}"
    tasks:
      - name: create new user {{ UserName }}
        user: name={{ UserName }} shell=/bin/bash  password={{ UserPassword |password_hash('sha512') }} update_password=always append=yes
      - name: Config /etc/sudoers
        lineinfile: dest=/etc/sudoers state=present  line='{{ item }}' validate='visudo -cf %s'
        with_items:
          - "{{ user }} ALL=(ALL) NOPASSWD:ALL,!/bin/rm,!/bin/su,!/usr/bin/passwd,!/usr/sbin/visudo,!/sbin/shutdown,!/sbin/reboot,!/sbin/halt"
          - "Defaults: {{ user }}  !requiretty"

[root@ss-server ansible]# ansible-playbook useradd.yml -e "host=172.16.60.20 user=kevin_bo pass=kevin@bo123"

在上例中,变量pass是密码,如果变量pass里有特殊的字符,或者变量pass是一串数组的话,它将被转义。若不想被转义,可以使用如下方法:
[root@ss-server ansible]# cat user.json
host: webserver                     #ansible里面定义的主机组或者直接配置主机ip,如172.16.60.20
user: kevin_bo                      #添加的用户名
pass: 'Fxx6unM$R%I$Jna&'            #添加的用户的密码,可以用百度上随机密码生成器生成

指定user,json文件执行剧本 (使用JSON格式的文件即可,-e 传递变量,优先级最高) 
[root@ss-server ansible]# ansible-playbook useradd.yml -e "@user.json"        

删除web组中所有用户
[root@ss-server ansible]# ansible webserver -m user -a 'name=zhangsan state=absent remove=yes'

6.  在playbook剧本中定义变量

在playbook中定义变量需要用到Ansible的vars模块,可以将所有需要用到的变量统一在vars模块下定义,定义格式需要遵循YAML语言格式:
vars:
  - var1: value1
  - var2: value2
  - var3: value3
  - ....: .....

示例如下:
[root@ss-server ansible]# cat playbook.yml
---
- hosts: kevin
  remote_user: root
  vars:
    - dir1: /root/Ansible
    - dir2: /root/Ansible/test1
    - dir3: /root/Ansible/test2
  tasks:
    - name: Create New Folder
      file: name={{ dir1 }} state=directory
    - name: Create New Folder
      file: name={{ dir2 }} state=directory
    - name: Create New Folder
      file: name={{ dir3 }} state=directory

[root@ss-server ansible]# ansible-playbook playbook.yml    

PLAY [kevin] *************************************************************************

TASK [Gathering Facts] ***************************************************************
ok: [172.16.60.20]

TASK [Create New Folder] *************************************************************
changed: [172.16.60.20]

TASK [Create New Folder] *************************************************************
changed: [172.16.60.20]

TASK [Create New Folder] *************************************************************
changed: [172.16.60.20]

PLAY RECAP ***************************************************************************
[172.16.60.20]              : ok=4    changed=3    unreachable=0    failed=0 

7.  通过roles角色定义变量

在Ansible的roles中定义变量,需要将变量及值的键值对形式写到roles的vars目录下的main.yml文件中,同样适用YAML语言格式,格式如下:
var1: value1
var2: value2
var3: value3

但是请注意:
通过Roles定义的变量只适用于当前roles。如下是roles文件组织结构:
[root@ss-server roles]# tree test/                  
test/
├── files
├── handlers
├── playbook.retry
├── playbook.yml
├── tasks
│   └── main.yml
├── templates
└── vars
    └── main.yml
5 directories, 4 files

[root@ss-server roles]# cat test/tasks/main.yml         #任务文件
- name: Get IP Address
  shell: echo `{{ cmd }}` >> {{ dir }}/{{ file }}

[root@ss-server roles]# cat test/vars/main.yml          #定义变量cmd
cmd: hostname -I

[root@ss-server roles]# cat test/playbook.yml
---
- hosts: webserver
  remote_user: root
  roles:
    - test

hosts清单列表里定义的变量,适用于所有roles。
[root@ss-server roles]# cat /etc/ansible/hosts
[webserver]
172.16.60.51 dir=/root/node2
172.16.60.80 dir=/root/node1

[node1]
172.16.60.80

[webserver:vars]
file=hostname.txt

playbook调用Roles,执行结果为:
[root@Centos7T test]#ansible-playbook playbook.yml    

PLAY [websvr] ************************************************************************

TASK [Gathering Facts] ***************************************************************
ok: [172.16.60.80]
ok: [172.16.60.51]

TASK [test : Get IP Address] *********************************************************
changed: [172.16.60.51]
changed: [172.16.60.80]

PLAY RECAP ***************************************************************************
172.16.60.51              : ok=2    changed=1    unreachable=0    failed=0   
172.16.60.80              : ok=2    changed=1    unreachable=0    failed=0 

8.  使用Facts获取的信息
还有其它地方可以获取变量, 这些变量是自动发现的,而不是用户自己设置的。Facts通过访问远程系统获取相应的信息,一个很好的例子就是远程主机的IP地址或者操作系统是什么。

使用以下命令可以查看哪些信息是可用的(kevin是上面在/etc/ansible/hosts列表文件中配置的主机群组):
[root@ss-server ansible]# ansible kevin -m setup
 
[root@ss-server ansible]# ansible kevin -m setup|grep "ansible_python_version"
        "ansible_python_version": "2.7.5",
可以在playbook中这样引用上面被控制主机的python版本: {{ ansible_python_version }}
 
[root@ss-server ansible]# ansible kevin -m setup|grep "ansible_nodename"
        "ansible_nodename": "ss-server",
可以在playbook中这样引用上面被控制主机的主机名: {{ ansible_nodename }}
 
[root@ss-server ansible]# ansible kevin -m setup|grep "ansible_hostname"
        "ansible_hostname": "ss-server",
被控制主机的主机名变量还可以是: {{ ansible_hostname }}

访问复杂变量数据
有些提供的facts, 比如网络信息等, 是一个嵌套的数据结构。访问它们使用简单的 {{ foo }} 语法并不够用,
但是也仍然很容易.如下所示:
{{ ansible_eth0["ipv4"]["address"] }}

或者这样写:
{{ ansible_eth0.ipv4.address }}
 
############ 如果关闭Facts,可以大大提高ansible的执行速度 ###########
关闭方法如下:
[root@ss-server ansible]# cat anhui.yml
---
- hosts: kevin
  gather_facts: no

9.  register注册变量
变量的另一个主要用途是在运行命令时,把命令结果存储到一个变量中,不同模块的执行结果是不同的。运行playbook时使用-v选项可以看到可能的结果值,ansible执行任务的结果值可以保存在变量中,以便稍后使用它。register方式主要用于在task之间传递变量。

示例如下:
[root@ss-server ansible]# cat /etc/ansible/hosts
[kevin]
172.16.60.237
172.16.60.238
 
[root@ss-server ansible]# cat /root/register.yml
---
- hosts: kevin
  remote_user: root
  tasks:
      - name: register bo_test
        shell: hostname -I
        register: info
      - name: display info
        debug: msg="this host ip is {{ info }}"
 
[root@ss-server ansible]# ansible-playbook /root/register.yml
 
PLAY [kevin] *************************************************************************************************************************************
 
TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.238]
ok: [172.16.60.237]
 
TASK [register bo_test] **************************************************************************************************************************
changed: [172.16.60.238]
changed: [172.16.60.237]
 
TASK [display info] ******************************************************************************************************************************
ok: [172.16.60.237] => {
    "msg": "this host ip is {'stderr_lines': [], u'changed': True, u'end': u'2019-12-15 22:07:18.431549', 'failed': False, u'stdout': u'172.16.60.237 ', u'cmd': u'hostname -I', u'rc': 0, u'start': u'2019-12-15 22:07:18.408235', u'stderr': u'', u'delta': u'0:00:00.023314', 'stdout_lines': [u'172.16.60.237 ']}"
}
ok: [172.16.60.238] => {
    "msg": "this host ip is {'stderr_lines': [], u'changed': True, u'end': u'2019-12-15 22:07:18.430108', 'failed': False, u'stdout': u'172.16.60.238 ', u'cmd': u'hostname -I', u'rc': 0, u'start': u'2019-12-15 22:07:18.407184', u'stderr': u'', u'delta': u'0:00:00.022924', 'stdout_lines': [u'172.16.60.238 ']}"
}
 
PLAY RECAP ***************************************************************************************************************************************
172.16.60.237              : ok=3    changed=1    unreachable=0    failed=0  
172.16.60.238              : ok=3    changed=1    unreachable=0    failed=0
 
这里注意下:
register定义的info变量在第二个task中用来查看前一个task中执行的hostname命令的结果。
可以看到playbook运行后的结果中,info返回的是一段python字典数据,如果只想看到stdout部分的信息的话,可以通过info[‘stdout’]来引用。
 
[root@ss-server ansible]# cat /root/register.yml
---
- hosts: kevin
  remote_user: root
  tasks:
      - name: register bo_test
        shell: hostname -I
        register: info
      - name: display info
        debug: msg="this host ip is {{ info['stdout'] }}"
 
[root@ss-server ansible]# ansible-playbook /root/register.yml
 
PLAY [kevin] *************************************************************************************************************************************
 
TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.238]
ok: [172.16.60.237]
 
TASK [register bo_test] **************************************************************************************************************************
changed: [172.16.60.237]
changed: [172.16.60.238]
 
TASK [display info] ******************************************************************************************************************************
ok: [172.16.60.237] => {
    "msg": "this host ip is 172.16.60.237 "
}
ok: [172.16.60.238] => {
    "msg": "this host ip is 172.16.60.238 "
}
 
PLAY RECAP ***************************************************************************************************************************************
172.16.60.237              : ok=3    changed=1    unreachable=0    failed=0  
172.16.60.238              : ok=3    changed=1    unreachable=0    failed=0

10.  hostvars 变量
该变量用于引用其他主机上收集的facts中的数据,或者引用其他主机的主机变量、主机组变量。即从一台远程主机获取另一台远程主机的变量。

如下示例:
[root@ss-server ansible]# cat /etc/ansible/hosts
[kevin]
172.16.60.237 addr=beijing 
172.16.60.238 user=shibo age=39

[root@ss-server ansible]# cat test.yml
---
- hosts: kevin
  remote_user: root
  gather_facts: False
  tasks:
    - name: this is test1
      debug: msg="She is come from {{ hostvars['172.16.60.237']['addr'] }}"
    - name: this is test2
      debug: msg="I am {{ hostvars['172.16.60.238']['user'] }}, and age is {{ hostvars['172.16.60.238']['age'] }}"

或者将test.yml文件配置如下,即由 "[变量]"" 改为 ".变量"
两种配置的执行结果都是一样的!
[root@ss-server ansible]# cat test.yml 
---
- hosts: kevin
  remote_user: root
  gather_facts: False
  tasks:
    - name: this is test1
      debug: msg="She is come from {{ hostvars['172.16.60.237'].addr }}"
    - name: this is test2
      debug: msg="I am {{ hostvars['172.16.60.238'].user }}, and age is {{ hostvars['172.16.60.238'].age }}"

执行结果为:
[root@ss-server ansible]# ansible-playbook test.yml             

PLAY [kevin] *************************************************************************************************************************************

TASK [this is test1] *****************************************************************************************************************************
ok: [172.16.60.237] => {
    "msg": "She is come from beijing"
}
ok: [172.16.60.238] => {
    "msg": "She is come from beijing"
}

TASK [this is test2] *****************************************************************************************************************************
ok: [172.16.60.237] => {
    "msg": "I am shibo, and age is 39"
}
ok: [172.16.60.238] => {
    "msg": "I am shibo, and age is 39"
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.237              : ok=2    changed=0    unreachable=0    failed=0   
172.16.60.238              : ok=2    changed=0    unreachable=0    failed=0  


############################# 这里需要注意下 ###########################
除了上面的配置,还可以如下配置,但是请注意:
1)debug后面必须使用"var"字段,即hostvar变量传递给var字段的变量。
2)var=hostvars[....],等于两边不能有空格!

[root@ss-server ansible]# cat test.yml 
---
- hosts: kevin
  remote_user: root
  gather_facts: False
  tasks:
    - name: this is test1
      debug: var=hostvars['172.16.60.237']['addr']
    - name: this is test2
      debug: var=hostvars['172.16.60.238']['user']

或者将test.yml文件配置如下,这两个配置方法的执行结果是一样的!
[root@ss-server ansible]# cat test.yml
---
- hosts: kevin
  remote_user: root
  gather_facts: False
  tasks:
    - name: this is test1
      debug: var=hostvars['172.16.60.237'].addr
    - name: this is test2
      debug: var=hostvars['172.16.60.238'].user

执行结果为:
[root@ss-server ansible]# ansible-playbook test.yml 

PLAY [kevin] *************************************************************************************************************************************

TASK [this is test1] *****************************************************************************************************************************
ok: [172.16.60.237] => {
    "hostvars['172.16.60.237']['addr']": "beijing"
}
ok: [172.16.60.238] => {
    "hostvars['172.16.60.237']['addr']": "beijing"
}

TASK [this is test2] *****************************************************************************************************************************
ok: [172.16.60.237] => {
    "hostvars['172.16.60.238']['user']": "shibo"
}
ok: [172.16.60.238] => {
    "hostvars['172.16.60.238']['user']": "shibo"
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.237              : ok=2    changed=0    unreachable=0    failed=0   
172.16.60.238              : ok=2    changed=0    unreachable=0    failed=0

注意:如果同一个name里配置了多个debug,则默认执行最后一个debug内容! (多个task的话,也是执行最后一个task)
[root@ss-server ansible]# cat test.yml
---
- hosts: kevin
  remote_user: root
  gather_facts: False
  tasks:
    - name: this is test1
      debug: var=hostvars['172.16.60.237']['addr']
    - name: this is test2
      debug: var=hostvars['172.16.60.238']['user']
      debug: var=hostvars['172.16.60.238']['age']

执行结果:
[root@ss-server ansible]# ansible-playbook test.yml 
 [WARNING]: While constructing a mapping from /etc/ansible/test.yml, line 8, column 7, found a duplicate dict key (debug). Using last defined
value only.


PLAY [kevin] *************************************************************************************************************************************

TASK [this is test1] *****************************************************************************************************************************
ok: [172.16.60.237] => {
    "hostvars['172.16.60.237']['addr']": "beijing"
}
ok: [172.16.60.238] => {
    "hostvars['172.16.60.237']['addr']": "beijing"
}

TASK [this is test2] *****************************************************************************************************************************
ok: [172.16.60.237] => {
    "hostvars['172.16.60.238']['age']": "39"
}
ok: [172.16.60.238] => {
    "hostvars['172.16.60.238']['age']": "39"
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.237              : ok=2    changed=0    unreachable=0    failed=0   
172.16.60.238              : ok=2    changed=0    unreachable=0    failed=0 

11. 列表变量、循环变量、字典变量

1)ansible的变量不仅可以是单个的值,也可以为列表,即ansible传列表作为变量。如下示例:
#################################################################################################################
[root@ss-server ansible]# vim test.yml
---
- hosts: test_host
  gather_facts: no
  vars: 
    - list: [1,2,3]
  tasks:
    - name: echo
      debug: msg="{{ list }}"

执行结果:
[root@ss-server ansible]# ansible-palybook test.yml
TASK [echo] ********************************************************************
ok: [172.16.60.220] => {
    "msg": [
        1, 
        2, 
        3
    ]
}

再来看一例:
linux创建用户,需要获取的变量有用户名,用户密码,用户组,有时候需要创建多个用户,那么传递给ansible的用户肯定是列表,但每一组又有用户名、密码、组这些变量值。
做法如下:
[root@ss-server ~]# cat /etc/ansible/test.yml 
---
- hosts: test_host
  gather_facts: no
  tasks:
   - name: create or update account
     user: name={{ item.user }} password={{ item.password }} groups={{ item.group }} system=no
     with_items:
       -  '{{ user_list }}'

执行结果:
[root@ss-server ansible]# ansible-playbook /etc/ansible/test.yml -e '{"user_list":[{"user":"user1","password":"*******","group":"user1"}]}'

#################################################################################################################
2)循环列表
结合循环,这个特性就变得很有用;以参数传递列表给playbook,不用在playbook中固定循环的次数与内容。如下示例:
[root@ss-server ansible]# vim test.yml
---
- hosts: test_host
  gather_facts: no
  vars: 
    - list: [1,2,3]
  tasks:
    - name: this is loop
      debug: msg="{{ item }}"
      with_items: '{{list}}'

执行结果:
[root@ss-server ansible]# ansible-palybook test.yml
TASK [this is loop] ********************************************************************
ok: [172.16.60.220] => (item=1) => {
    "item": 1, 
    "msg": 1
}
ok: [localhost] => (item=2) => {
    "item": 2, 
    "msg": 2
}
ok: [localhost] => (item=3) => {
    "item": 3, 
    "msg": 3
}

接着看下面一例:
loop 关键字表示循环,去读循环体里的变量固定使用{{item}},item是个字典对象item.key=value。
需要注意:下面test.yml文件中的"loop"关键字 改为 "with_items"关键字,效果是一样的!
ansible的循环用法:在ansible 2.5版本之前,大多数人习惯使用"with_X"风格的关键字操作循环,
从ansible 2.6版本开始,官方开始推荐使用"loop"关键字代替"with_X"风格关键字。
[root@ss-server ~]# cat /etc/ansible/test.yml
---
- name: this is test
  hosts: test_host
  connection: local
  gather_facts: no

  tasks:
    - name: debug loop
      debug:
        msg: "{{item.A1}}"
      loop:                      #这里将"loop"关键字 改为 "with_items"关键字,效果是一样的!
        - A: a
          A1: a1
          A2: a2
        - B: b
          A1: b1
          A2: b2
        - C: c
          A1: c1
          A2: c2
        - D: d
          A1: d1
          A2: d2

执行结果:以上loop下的四个变量分别称为一块,即一个item,符号"-"为循环体块的标志,{{item.A1}}的值,即分别为a1,b1,c1,d1
[root@ss-server ~]# ansible-playbook /etc/ansible/test.yml

PLAY [this is test] *********************************************************************************************************************************

TASK [debug loop] ********************************************************************************************************************************
ok: [172.16.60.20] => (item={u'A': u'a', u'A1': u'a1', u'A2': u'a2'}) => {
    "msg": "a1"
}
ok: [172.16.60.20] => (item={u'A1': u'b1', u'B': u'b', u'A2': u'b2'}) => {
    "msg": "b1"
}
ok: [172.16.60.20] => (item={u'A1': u'c1', u'C': u'c', u'A2': u'c2'}) => {
    "msg": "c1"
}
ok: [172.16.60.20] => (item={u'A1': u'd1', u'A2': u'd2', u'D': u'd'}) => {
    "msg": "d1"
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.20                  : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0 

再来看一例:
[root@ss-server ~]# cat /etc/ansible/test.yml
---
- name: this is test
  hosts: test_host
  connection: local
  gather_facts: no
  vars:
    my_list:
      - a
      - b
      - c
      - 1

  tasks:
    - name: debug loop output
      debug:
        msg: "The {{index}} one is {{item}}"
      loop: "{{my_list}}"               # 或者使用with_items: "{{my_list}}"  或者 with_list: "{{my_list}}" 
      loop_control:
        index_var: index

执行结果:
[root@ss-server ~]# ansible-playbook /etc/ansible/test.yml

PLAY [this is test] ******************************************************************************************************************************

TASK [debug loop output] *************************************************************************************************************************
ok: [172.16.60.20] => (item=a) => {
    "msg": "The 0 one is a"
}
ok: [172.16.60.20] => (item=b) => {
    "msg": "The 1 one is b"
}
ok: [172.16.60.20] => (item=c) => {
    "msg": "The 2 one is c"
}
ok: [172.16.60.20] => (item=1) => {
    "msg": "The 3 one is 1"
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.20                  : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

#################################################################################################################
3)字典变量
变量也可以为字典。如下示例, 用到了ansible的循环,循环关键字是"with_X", 改为loop关键字,效果是一样的!
注意:在变量中使用循环时,vars下必须要有"-",符号"-"为循环体块的标志!!
[root@ss-server ansible]# vim test.yml
---
- hosts: test_host
  gather_facts: no
  vars: 
    - lists: 
        list1: [1,2,3]
        list2: [4,5]
  tasks: 
    - name: loop
      debug: msg="{{ item }}"
      with_items: '{{lists["list1"]}}'        #替换为 loop: '{{lists["list1"]}}', 或者 with_list: '{{lists["list1"]}}' 效果是一样的

执行结果:
[root@ss-server ansible]# ansible-palybook test.yml
TASK [loop] ********************************************************************
ok: [172.16.60.220] => (item=1) => {
    "item": 1, 
    "msg": 1
}
ok: [localhost] => (item=2) => {
    "item": 2, 
    "msg": 2
}
ok: [localhost] => (item=3) => {
    "item": 3, 
    "msg": 3
}

接着看下面一例:
[root@ss-server ~]# cat /etc/ansible/test.yml
---
- hosts: test_host
  gather_facts: no
  vars: 
    - users: 
        name: [xiaoming]
        address: [anhui]
        age: [28]
  tasks: 
    - name: this is loop
      debug: msg="{{ item }}"
      loop: '{{users["name"]}}'        
[root@ss-server ~]# ansible-playbook /etc/ansible/test.yml

PLAY [test_host] *************************************************************************************************************************************

TASK [this is loop] **************************************************************************************************************************************
ok: [172.16.60.20] => (item=xiaoming) => {
    "msg": "xiaoming"
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.20                  : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0 

上面的示例,如果要想打印多个字典变量,修改如下:
[root@ss-server ~]# cat /etc/ansible/test.yml
---
- hosts: test_host
  gather_facts: no
  vars: 
    - users: 
        name: [xiaoming]
        address: [anhui]
        age: [28]
  tasks: 
    - name: this is loop
      debug: msg="{{ item }}"
      loop:                         #这里用loop,with_items,with_list都可以
         - '{{users["name"]}}'    
         - '{{users["address"]}}' 
         - '{{users["age"]}}' 

执行结果:
[root@ss-server ~]# ansible-playbook /etc/ansible/test.yml

PLAY [test_host] *********************************************************************************************************************************

TASK [this is loop] ******************************************************************************************************************************
ok: [172.16.60.20] => (item=[u'xiaoming']) => {
    "msg": [
        "xiaoming"
    ]
}
ok: [172.16.60.20] => (item=[u'anhui']) => {
    "msg": [
        "anhui"
    ]
}
ok: [172.16.60.20] => (item=[28]) => {
    "msg": [
        28
    ]
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.20                  : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

######   可以在一个yaml文件里放置多个hosts,将多个tasks任务一起执行   ########

[root@ss-server ansible]# cat /etc/ansible/hosts
172.16.60.237 
[kevin]
172.16.60.238 
[grace]
172.16.60.236

[root@ss-server ansible]# cat bo.yml            
---
- hosts: kevin
  remote_user: root
  gather_facts: False
  tasks:
    - name: this is test1
      shell: hostname -I

- hosts: 172.16.60.237
  remote_user: root
  tasks:
    - name: this is test2
      debug: msg="this server is {{ info }} "

- hosts: 172.16.60.238
  remote_user: root
  tasks:
    - name: this is test3
      debug: msg="this key is {{ haha }} "

执行结果:
[root@ss-server ansible]# ansible-playbook bo.yml -e "{'info':'my server','haha':'123123213123'}"  

PLAY [kevin] *************************************************************************************************************************************

TASK [this is test1] *****************************************************************************************************************************
changed: [172.16.60.238]

PLAY [172.16.60.237] *****************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.237]

TASK [this is test2] *****************************************************************************************************************************
ok: [172.16.60.237] => {
    "msg": "this server is my server "
}

PLAY [172.16.60.238] *****************************************************************************************************************************

TASK [Gathering Facts] ***************************************************************************************************************************
ok: [172.16.60.238]

TASK [this is test3] *****************************************************************************************************************************
ok: [172.16.60.238] => {
    "msg": "this key is 123123213123 "
}

PLAY RECAP ***************************************************************************************************************************************
172.16.60.237              : ok=2    changed=0    unreachable=0    failed=0   
172.16.60.238              : ok=3    changed=1    unreachable=0    failed=0 


############# 再来看下面一个测试环境用过的部署脚本配置 #########################
[root@localhost ansible]# cat /opt/ansible_cfg/deploy.yml
---
- hosts: webservers
  tasks:
    - name: Installed Httpd Server
      yum: name=httpd state=present

    - name: Start Httpd Server
      systemd: name=httpd state=started enabled=yes

    - name: Start Firewalld Server
      systemd: name=firewalld state=started enabled=yes

    - name: Configure Firewalld Server
      firewalld: service=http immediate=yes permanent=yes state=enabled

- hosts: web01
  tasks:
    - name: Configure web01 Website
      copy: content='This is Web01' dest=/var/www/html/index.html

- hosts: web02
  tasks:
    - name: Cofnigure webi-2 weisite
      copy: content='This is Web02' dest=/var/www/html/index.html

- hosts: nfs01
  tasks:
    - name: Install NFS-utils Server
      yum: name=nfs-utils state=present

    - name: Configure Nfs-utils Server
      copy: src=./exports.j2 dest=/etc/exports owner=root group=root mode=0644

    - name: Create NFS Group
      group: name=www gid=666

    - name: Create NFS User
      user: name=www uid=666 group=www create_home=no shell=/sbin/nologin

    - name: Create Data Directory
      file: path=/data state=directory owner=www group=www mode=0755 recurse=yes

    - name: Start NFS Server
      systemd: name=nfs state=started enabled=yes

- hosts: nfs01
  tasks:
    - name: Mount NFS Server
      mount: path=/opt src=172.16.60.23:/data fstype=nfs opts=defaults state=mounted

######   Ansible-playbook如何正确获取ip   ######

[root@ansible ~]# vim /etc/ansible/hosts_all.yaml
---
- hosts: all 
  tasks:       
    - name: 将原有的hosts文件备份         
      shell: mv /etc/hosts /etc/hosts_bak       
    - name: 将ansible端的hosts复制到各自机器上         
      copy: src=/root/hosts dest=/etc/ owner=root group=root mode=0644       
    - name: 在新的hosts文件后面追加各自机器内网ip和hostname         
      lineinfile: dest=/etc/hosts line="`ansible_all_ipv4_addresses`  `ansible_hostname`"
 
但是执行完ansible-playbook之后,ansible客户机器上的/etc/hosts文件里ip和主机名对应关系如下(cat /etc/hosts):
 
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
[u'172.16.60.210'] redis-fun01.kevin.cn
 
实际想要的结果是(cat /etc/hosts):
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
172.16.60.210 redis-fun01.kevin.cn
 
解决办法:
调整ansible服务端的hosts_all.yaml文件中获取ip的变量
变量用 IP: "{{ ansible_eth0['ipv4']['address'] }}",而不是`ansible_all_ipv4_addresses`
 
修改后的yaml文件配置如下:
[root@ansible ~]# vim /etc/ansible/hosts_all.yaml
---
- hosts: all 
  vars:       
    IP: "{{ ansible_eth0['ipv4']['address'] }}" 
  tasks:       
    - name: 将原有的hosts文件备份         
      shell: mv /etc/hosts /etc/hosts_bak       
    - name: 将ansible端的hosts复制到各自机器上         
      copy: src=/root/hosts dest=/etc/ owner=root group=root mode=0644       
    - name: 在新的hosts文件后面追加各自机器内网ip和hostname         
      lineinfile: dest=/etc/hosts line="`IP`  `ansible_hostname`" 

########  获取ansible清单列表里对应组的ip、指定机器执行操作 [ --list-hosts--limit ]  ########

注意下面两个参数的使用:
1)获取hosts清单文件里指定组内的ip,使用"--list-hosts"
2)指定hosts清单文件里的ip执行操作,使用"--limit"
 
如下是ansible的一个清单文件:
[root@localhost ~]# cat /opt/kevin-bo.cfg
[kevin-bo_F]
172.16.60.65
 
[kevin-bo_A]
172.16.60.140
172.16.60.141
 
[kevin-bo:children]
kevin-bo_D
kevin-bo_F
kevin-bo_A
 
[kevin-bo:vars]
deploy_path=/opt/web/kevin-bo/
start_time_out=90
stop_time_out=60
module=kevin-bo
 
[kevin-bo_D]
172.16.60.195
 
现在需要获取"kevin-bo_A" 和 "kevin-bo_D" 组下的ip,--list-hosts后面加不加引号都可以。
[root@localhost ~]# ansible -i /opt/kevin-bo.cfg --list-hosts kevin-bo_A
  hosts (2):
    172.16.60.140
    172.16.60.141
[root@localhost ~]# ansible -i /opt/kevin-bo.cfg --list-hosts "kevin-bo_A"|grep -v "hosts"
    172.16.60.140
    172.16.60.141
[root@localhost ~]# ansible -i /opt/kevin-bo.cfg --list-hosts kevin-bo_D|grep -v "hosts"
    172.16.60.195

获取多个机器组内的ip,中间使用逗号隔开
[root@localhost ~]# ansible -i /opt/kevin-bo.cfg --list-hosts "kevin-bo_A,kevin-bo_D"
  hosts (3):
    172.16.60.140
    172.16.60.141
    172.16.60.195

[root@localhost ~]# ansible -i /opt/kevin-bo.cfg --list-hosts "kevin-bo_A,kevin-bo_D"|grep -v "hosts"
    172.16.60.140
    172.16.60.141
    172.16.60.195
 
在执行ansible-playbook时,可以指定单个ip或group,也可以指定多个ip或group,也可以一起指定ip和group,多个中间使用逗号隔开!
--limit后面加不加引号都可以。
# ansible-playbook -i 清单文件 yml文件 --limit ip
# ansible-playbook -i 清单文件 yml文件 --limit ip1,iP2,ipn
# ansible-playbook -i 清单文件 yml文件 --limit group
# ansible-playbook -i 清单文件 yml文件 --limit group1,group2,groupn
# ansible-playbook -i 清单文件 yml文件 --limit ip1,ip2,group1,groupn
还可以将制定的ip或group放在一个文件里,如ip.txt,然后--limit后面跟"@ip.txt"
# ansible-playbook -i 列表文件 yml文件 --limit @ip.txt   
# cat ip.txt
172.16.60.140
172.16.60.141
kevin-bo_F
 
如上,需要对清单文件"kevin-bo_A"组下的机器进行发布操作,由于发布过程中涉及服务启停,为了保证发布中整体服务不中断,需要一台一台的执行,不能所有机器一起执行。如下:
[root@localhost ~]# vim deploy.sh
#!/bin/bash
#设置变量,传参等
BRANCH=$1 
MODULE_NAME=$2 
PRODUCT_PATH=$3
USER=$4
APP_NANE=${Deploy_App}
.....
 
for Next_Deploy_IP in $(ansible -i /opt/kevin-bo.cfg --list-hosts kevin-bo_A|grep -v "hosts")
do
   ansible-playbook -i /opt/kevin-bo.cfg /root/ansible/web_deploy.yml --limit "${Next_Deploy_IP}" -e "user=${USER} app_name=${APP_NANE} package_name=... ..."
   if [ $? -eq 0 ];then
      echo "[`date +%Y%m%d-%H%M%S`]++++++++++++++++++++++++${Next_Deploy_IP}部署成功!++++++++++++++++++++++++++++++"
      sleep 10
   else
      echo "[`date +%Y%m%d-%H%M%S`]++++++++++++++++++++++++${Next_Deploy_IP}部署失败!++++++++++++++++++++++++++++++"
      exit 1
   fi
done
posted @ 2016-06-08 12:10  散尽浮华  阅读(19776)  评论(1编辑  收藏  举报