复制代码
[root@ansible PlayBook]# ansible-playbook -h

#ansible-playbook常用选项：
–check or -C #只检测可能会发生的改变，但不真正执行操作
–list-hosts #列出运行任务的主机
–list-tags #列出playbook文件中定义所有的tags
–list-tasks #列出playbook文件中定义的所以任务集
–limit #主机列表 只针对主机列表中的某个主机或者某个组执行
-f #指定并发数，默认为5个
-t #指定tags运行，运行某一个或者多个tags。（前提playbook中有定义tags）
-v #显示过程 -vv -vvv更详细
复制代码
Playbook中元素属性#
主机与用户#
在一个playbook开始时，最先定义的是要操作的主机和用户

• hosts: 192.168.1.31
  remote_user: root
  除了上面的定义外，还可以在某一个tasks中定义要执行该任务的远程用户

tasks:

• name: run df -h
  remote_user: test
  shell: name=df -h
  还可以定义使用sudo授权用户执行该任务

复制代码
tasks:

• name: run df -h
  sudo_user: test
  sudo: yes
  shell: name=df -h
  复制代码
  tasks任务列表#
  每一个task必须有一个名称name,这样在运行playbook时，从其输出的任务执行信息中可以很清楚的辨别是属于哪一个task的，如果没有定义 name，action的值将会用作输出信息中标记特定的task。
  每一个playbook中可以包含一个或者多个tasks任务列表，每一个tasks完成具体的一件事，（任务模块）比如创建一个用户或者安装一个软件等，在hosts中定义的主机或者主机组都将会执行这个被定义的tasks。

复制代码
tasks:

• name: create new file
  file: path=/tmp/test01.txt state=touch
• name: create new user
  user: name=test001 state=present
  复制代码
  Handlers与Notify#
  很多时候当我们某一个配置发生改变，我们需要重启服务，（比如httpd配置文件文件发生改变了）这时候就可以用到handlers和notify了；
  (当发生改动时)notify actions会在playbook的每一个task结束时被触发，而且即使有多个不同task通知改动的发生，notify actions知会被触发一次；比如多个resources指出因为一个配置文件被改动，所以apache需要重启，但是重新启动的操作知会被执行一次。

复制代码
[root@ansible ~]# cat httpd.yml

#用于安装httpd并配置启动

• hosts: 192.168.1.31
  remote_user: root

  tasks:

  • name: install httpd
    yum: name=httpd state=installed
  • name: config httpd
    template: src=/root/httpd.conf dest=/etc/httpd/conf/httpd.conf
    notify:
    • restart httpd
  • name: start httpd
    service: name=httpd state=started

  handlers:

  • name: restart httpd
    service: name=httpd state=restarted

#这里只要对httpd.conf配置文件作出了修改，修改后需要重启生效，在tasks中定义了restart httpd这个action，然后在handlers中引用上面tasks中定义的notify。
复制代码
Playbook中变量的使用#
环境说明：这里配置了两个组，一个apache组和一个nginx组

复制代码
[root@ansible PlayBook]# cat /etc/ansible/hosts
[apache]
192.168.1.36
192.168.1.33

[nginx]
192.168.1.3[1:2]
复制代码
命令行指定变量#
执行playbook时候通过参数-e传入变量，这样传入的变量在整个playbook中都可以被调用，属于全局变量

复制代码

[root@ansible PlayBook]# cat variables.yml

• hosts: all
  remote_user: root

  tasks:

  • name: install pkg
    yum: name={{ pkg }}

#执行playbook 指定pkg
[root@ansible PlayBook]# ansible-playbook -e “pkg=httpd” variables.yml
复制代码
hosts文件中定义变量#
在/etc/ansible/hosts文件中定义变量，可以针对每个主机定义不同的变量，也可以定义一个组的变量，然后直接在playbook中直接调用。注意，组中定义的变量没有单个主机中的优先级高。

复制代码

编辑hosts文件定义变量

[root@ansible PlayBook]# vim /etc/ansible/hosts
[apache]
192.168.1.36 webdir=/opt/test #定义单个主机的变量
192.168.1.33
[apache:vars] #定义整个组的统一变量
webdir=/web/test

[nginx]
192.168.1.3[1:2]
[nginx:vars]
webdir=/opt/web

编辑playbook文件

[root@ansible PlayBook]# cat variables.yml

• hosts: all
  remote_user: root

  tasks:

  • name: create webdir
    file: name={{ webdir }} state=directory #引用变量

执行playbook

[root@ansible PlayBook]# ansible-playbook variables.yml
复制代码
playbook文件中定义变量#
编写playbook时，直接在里面定义变量，然后直接引用，可以定义多个变量；注意：如果在执行playbook时，又通过-e参数指定变量的值，那么会以-e参数指定的为准。

复制代码

编辑playbook

[root@ansible PlayBook]# cat variables.yml

• hosts: all
  remote_user: root
  vars: #定义变量
  pkg: nginx #变量1
  dir: /tmp/test1 #变量2

  tasks:

  • name: install pkg
    yum: name={{ pkg }} state=installed #引用变量
  • name: create new dir
    file: name={{ dir }} state=directory #引用变量

执行playbook

[root@ansible PlayBook]# ansible-playbook variables.yml

如果执行时候又重新指定了变量的值，那么会已重新指定的为准

[root@ansible PlayBook]# ansible-playbook -e “dir=/tmp/test2” variables.yml
复制代码
调用setup模块获取变量#
setup模块默认是获取主机信息的，有时候在playbook中需要用到，所以可以直接调用。常用的参数参考

复制代码

编辑playbook文件

[root@ansible PlayBook]# cat variables.yml

• hosts: all
  remote_user: root

  tasks:

  • name: create file
    file: name={{ ansible_fqdn }}.log state=touch #引用setup中的ansible_fqdn

执行playbook

[root@ansible PlayBook]# ansible-playbook variables.yml
复制代码
独立的变量YAML文件中定义#
为了方便管理将所有的变量统一放在一个独立的变量YAML文件中，laybook文件直接引用文件调用变量即可。

复制代码

定义存放变量的文件

[root@ansible PlayBook]# cat var.yml
var1: vsftpd
var2: httpd

编写playbook

[root@ansible PlayBook]# cat variables.yml

• hosts: all
  remote_user: root
  vars_files: #引用变量文件

  • ./var.yml #指定变量文件的path（这里可以是绝对路径，也可以是相对路径）

  tasks:

  • name: install package
    yum: name={{ var1 }} #引用变量
  • name: create file
    file: name=/tmp/{{ var2 }}.log state=touch #引用变量

执行playbook

[root@ansible PlayBook]# ansible-playbook variables.yml
复制代码
Playbook中标签的使用#
一个playbook文件中，执行时如果想执行某一个任务，那么可以给每个任务集进行打标签，这样在执行的时候可以通过-t选择指定标签执行，还可以通过–skip-tags选择除了某个标签外全部执行等。

复制代码

编辑playbook

[root@ansible PlayBook]# cat httpd.yml

• hosts: 192.168.1.31
  remote_user: root

  tasks:

  • name: install httpd
    yum: name=httpd state=installed
    tags: inhttpd

  • name: start httpd
    service: name=httpd state=started
    tags: sthttpd

  • name: restart httpd
    service: name=httpd state=restarted
    tags:

    • rshttpd
    • rs_httpd

正常执行的结果

[root@ansible PlayBook]# ansible-playbook httpd.yml

PLAY [192.168.1.31] **

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

TASK [install httpd] *
ok: [192.168.1.31]

TASK [start httpd] ***
ok: [192.168.1.31]

TASK [restart httpd] *
changed: [192.168.1.31]

PLAY RECAP ***
192.168.1.31 : ok=4 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
复制代码
1）通过-t选项指定tags进行执行

复制代码

通过-t指定tags名称，多个tags用逗号隔开

[root@ansible PlayBook]# ansible-playbook -t rshttpd httpd.yml

PLAY [192.168.1.31] **

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

TASK [restart httpd] *
changed: [192.168.1.31]

PLAY RECAP ***
192.168.1.31 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
复制代码
2）通过–skip-tags选项排除不执行的tags

复制代码
[root@ansible PlayBook]# ansible-playbook –skip-tags inhttpd httpd.yml

PLAY [192.168.1.31] **

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

TASK [start httpd] ***
ok: [192.168.1.31]

TASK [restart httpd] *
changed: [192.168.1.31]

PLAY RECAP ***
192.168.1.31 : ok=3 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
复制代码
Playbook中模板的使用#
template模板为我们提供了动态配置服务，使用jinja2语言，里面支持多种条件判断、循环、逻辑运算、比较操作等。其实说白了也就是一个文件，和之前配置文件使用copy一样，只是使用copy，不能根据服务器配置不一样进行不同动态的配置。这样就不利于管理。
说明：
1、多数情况下都将template文件放在和playbook文件同级的templates目录下（手动创建），这样playbook文件中可以直接引用，会自动去找这个文件。如果放在别的地方，也可以通过绝对路径去指定。
2、模板文件后缀名为.j2。

循环参考

示例：通过template安装httpd

1）playbook文件编写

复制代码
[root@ansible PlayBook]# cat testtmp.yml

#模板示例

• hosts: all
  remote_user: root
  vars:

  • listen_port: 88 #定义变量

  tasks:

  • name: Install Httpd
    yum: name=httpd state=installed
  • name: Config Httpd
    template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf #使用模板
    notify: Restart Httpd
  • name: Start Httpd
    service: name=httpd state=started

  handlers:

  • name: Restart Httpd
    service: name=httpd state=restarted
    复制代码
    2）模板文件准备，httpd配置文件准备，这里配置文件端口使用了变量

[root@ansible PlayBook]# cat templates/httpd.conf.j2 |grep ^Listen
Listen {{ listen_port }}
3）查看目录结构

复制代码

目录结构

[root@ansible PlayBook]# tree .
.
├── templates
│ └── httpd.conf.j2
└── testtmp.yml

1 directory, 2 files
复制代码
4）执行playbook，由于192.168.1.36那台机器是6的系统，模板文件里面的配置文件是7上面默认的httpd配置文件，httpd版本不一样(6默认版本为2.2.15，7默认版本为2.4.6)，所以拷贝过去后启动报错。下面使用playbook中的判断语句进行处理；此处先略过

复制代码
[root@ansible PlayBook]# ansible-playbook testtmp.yml

PLAY [all] **

TASK [Gathering Facts] **
ok: [192.168.1.36]
ok: [192.168.1.32]
ok: [192.168.1.33]
ok: [192.168.1.31]

TASK [Install Httpd] ****
ok: [192.168.1.36]
ok: [192.168.1.33]
ok: [192.168.1.32]
ok: [192.168.1.31]

TASK [Config Httpd] *
changed: [192.168.1.31]
changed: [192.168.1.33]
changed: [192.168.1.32]
changed: [192.168.1.36]

TASK [Start Httpd] **
fatal: [192.168.1.36]: FAILED! => {“changed”: false, “msg”: “httpd: Syntax error on line 56 of /etc/httpd/conf/httpd.conf: Include directory ‘/etc/httpd/conf.modules.d’ not found\n”}
changed: [192.168.1.32]
changed: [192.168.1.33]
changed: [192.168.1.31]

RUNNING HANDLER [Restart Httpd] *
changed: [192.168.1.31]
changed: [192.168.1.32]
changed: [192.168.1.33]

PLAY RECAP **
192.168.1.31 : ok=5 changed=3 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
192.168.1.32 : ok=5 changed=3 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
192.168.1.33 : ok=5 changed=3 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
192.168.1.36 : ok=3 changed=1 unreachable=0 failed=1 skipped=0 rescued=0 ignored=0
复制代码
template之when#
when语句参考

条件测试：如果需要根据变量、facts或此前任务的执行结果来做为某task执行与否的前提时要用到条件测试，通过when语句执行，在task中使用jinja2的语法格式、
when语句：
在task后添加when子句即可使用条件测试；when语句支持jinja2表达式语法。

类似这样：

复制代码
tasks:

• command: /bin/false
  register: result
  ignore_errors: True
• command: /bin/something
  when: result|failed
• command: /bin/something_else
  when: result|success
• command: /bin/still/something_else
  when: result|skipped
  复制代码
  示例：通过when语句完善上面的httpd配置

1）准备两个配置文件，一个centos6系统httpd配置文件，一个centos7系统httpd配置文件。

复制代码
[root@ansible PlayBook]# tree templates/
templates/
├── httpd6.conf.j2 #6系统2.2.15版本httpd配置文件
└── httpd7.conf.j2 #7系统2.4.6版本httpd配置文件

0 directories, 2 files
复制代码
2）修改playbook文件，通过setup模块获取系统版本去判断。setup常用模块

复制代码
[root@ansible PlayBook]# cat testtmp.yml

#when示例

• hosts: all
  remote_user: root
  vars:

  • listen_port: 88

  tasks:

  • name: Install Httpd
    yum: name=httpd state=installed
  • name: Config System6 Httpd
    template: src=httpd6.conf.j2 dest=/etc/httpd/conf/httpd.conf
    when: ansible_distribution_major_version == “6” #判断系统版本，为6便执行上面的template配置6的配置文件
    notify: Restart Httpd
  • name: Config System7 Httpd
    template: src=httpd7.conf.j2 dest=/etc/httpd/conf/httpd.conf
    when: ansible_distribution_major_version == “7” #判断系统版本，为7便执行上面的template配置7的配置文件
    notify: Restart Httpd
  • name: Start Httpd
    service: name=httpd state=started

  handlers:

  • name: Restart Httpd
    service: name=httpd state=restarted
    复制代码
    3）执行playbook

复制代码
[root@ansible PlayBook]# ansible-playbook testtmp.yml

PLAY [all] **

TASK [Gathering Facts] **
ok: [192.168.1.31]
ok: [192.168.1.32]
ok: [192.168.1.33]
ok: [192.168.1.36]

TASK [Install Httpd] ****
ok: [192.168.1.32]
ok: [192.168.1.33]
ok: [192.168.1.31]
ok: [192.168.1.36]

TASK [Config System6 Httpd] *
skipping: [192.168.1.33]
skipping: [192.168.1.31]
skipping: [192.168.1.32]
changed: [192.168.1.36]

TASK [Config System7 Httpd] *
skipping: [192.168.1.36]
changed: [192.168.1.33]
changed: [192.168.1.31]
changed: [192.168.1.32]

TASK [Start Httpd] **
ok: [192.168.1.36]
ok: [192.168.1.31]
ok: [192.168.1.32]
ok: [192.168.1.33]

RUNNING HANDLER [Restart Httpd] *
changed: [192.168.1.33]
changed: [192.168.1.31]
changed: [192.168.1.32]
changed: [192.168.1.36]

PLAY RECAP **
192.168.1.31 : ok=5 changed=2 unreachable=0 failed=0 skipped=1 rescued=0 ignored=0
192.168.1.32 : ok=5 changed=2 unreachable=0 failed=0 skipped=1 rescued=0 ignored=0
192.168.1.33 : ok=5 changed=2 unreachable=0 failed=0 skipped=1 rescued=0 ignored=0
192.168.1.36 : ok=5 changed=2 unreachable=0 failed=0 skipped=1 rescued=0 ignored=0
复制代码
template之with_items#
with_items迭代，当有需要重复性执行的任务时，可以使用迭代机制。
对迭代项的引用，固定变量名为“item”，要在task中使用with_items给定要迭代的元素列表。
列表格式：
  字符串
  字典

示例1：通过with_items安装多个不同软件

编写playbook

复制代码
[root@ansible PlayBook]# cat testwith.yml

示例with_items

• hosts: all
  remote_user: root

  tasks:

  • name: Install Package
    yum: name={{ item }} state=installed #引用item获取值
    with_items: #定义with_items
    • httpd
    • vsftpd
    • nginx
      复制代码
      上面tasks写法等同于：

复制代码

• hosts: all
  remote_user: root
  tasks:
  • name: Install Httpd
    yum: name=httpd state=installed
  • name: Install Vsftpd
    yum: name=vsftpd state=installed
  • name: Install Nginx
    yum: name=nginx state=installed
    复制代码
    示例2：通过嵌套子变量创建用户并加入不同的组

1）编写playbook

复制代码
[root@ansible PlayBook]# cat testwith01.yml

示例with_items嵌套子变量

• hosts: all
  remote_user: root

  tasks:

  • name: Create New Group
    group: name={{ item }} state=present
    with_items:

    • group1
    • group2
    • group3

  • name: Create New User
    user: name={{ item.name }} group={{ item.group }} state=present
    with_items:

    • { name: ‘user1’, group: ‘group1’ }
    • { name: ‘user2’, group: ‘group2’ }
    • { name: ‘user3’, group: ‘group3’ }
      复制代码
      2）执行playbook并验证

复制代码

执行playbook

[root@ansible PlayBook]# ansible-playbook testwith01.yml

验证是否成功创建用户及组

[root@ansible PlayBook]# ansible all -m shell -a ‘tail -3 /etc/passwd’
192.168.1.36 | CHANGED | rc=0 >>
user1:x:500:500::/home/user1:/bin/bash
user2:x:501:501::/home/user2:/bin/bash
user3:x:502:502::/home/user3:/bin/bash

192.168.1.32 | CHANGED | rc=0 >>
user1:x:1001:1001::/home/user1:/bin/bash
user2:x:1002:1002::/home/user2:/bin/bash
user3:x:1003:1003::/home/user3:/bin/bash

192.168.1.31 | CHANGED | rc=0 >>
user1:x:1002:1003::/home/user1:/bin/bash
user2:x:1003:1004::/home/user2:/bin/bash
user3:x:1004:1005::/home/user3:/bin/bash

192.168.1.33 | CHANGED | rc=0 >>
user1:x:1001:1001::/home/user1:/bin/bash
user2:x:1002:1002::/home/user2:/bin/bash
user3:x:1003:1003::/home/user3:/bin/bash
复制代码
template之for if#
通过使用for，if可以更加灵活的生成配置文件等需求，还可以在里面根据各种条件进行判断，然后生成不同的配置文件、或者服务器配置相关等。

示例1

1）编写playbook

复制代码
[root@ansible PlayBook]# cat testfor01.yml

template for 示例

• hosts: all
  remote_user: root
  vars:
  nginx_vhost_port:

  - 81
  - 82
  - 83

  tasks:

  • name: Templage Nginx Config
    template: src=nginx.conf.j2 dest=/tmp/nginx_test.conf
    复制代码
    2）模板文件编写

复制代码

循环playbook文件中定义的变量，依次赋值给port

[root@ansible PlayBook]# cat templates/nginx.conf.j2
{% for port in nginx_vhost_port %}
server{
listen: {{ port }};
server_name: localhost;
}
{% endfor %}
复制代码
3）执行playbook并查看生成结果

复制代码
[root@ansible PlayBook]# ansible-playbook testfor01.yml

去到一个节点看下生成的结果发现自动生成了三个虚拟主机

[root@linux ~]# cat /tmp/nginx_test.conf
server{
listen: 81;
server_name: localhost;
}
server{
listen: 82;
server_name: localhost;
}
server{
listen: 83;
server_name: localhost;
}
复制代码
示例2

1）编写playbook

复制代码
[root@ansible PlayBook]# cat testfor02.yml

template for 示例

• hosts: all
  remote_user: root
  vars:
  nginx_vhosts:

  - web1:
    listen: 8081
    server_name: "web1.example.com"
    root: "/var/www/nginx/web1"
  - web2:
    listen: 8082
    server_name: "web2.example.com"
    root: "/var/www/nginx/web2"
  - web3:
    listen: 8083
    server_name: "web3.example.com"
    root: "/var/www/nginx/web3"

  tasks:

  • name: Templage Nginx Config
    template: src=nginx.conf.j2 dest=/tmp/nginx_vhost.conf
    复制代码
    2）模板文件编写

复制代码
[root@ansible PlayBook]# cat templates/nginx.conf.j2
{% for vhost in nginx_vhosts %}
server{
listen: {{ vhost.listen }};
server_name: {{ vhost.server_name }};
root: {{ vhost.root }};
}
{% endfor %}
复制代码
3）执行playbook并查看生成结果

复制代码
[root@ansible PlayBook]# ansible-playbook testfor02.yml

去到一个节点看下生成的结果发现自动生成了三个虚拟主机

[root@linux ~]# cat /tmp/nginx_vhost.conf
server{
listen: 8081;
server_name: web1.example.com;
root: /var/www/nginx/web1;
}
server{
listen: 8082;
server_name: web2.example.com;
root: /var/www/nginx/web2;
}
server{
listen: 8083;
server_name: web3.example.com;
root: /var/www/nginx/web3;
}
复制代码
示例3

在for循环中再嵌套if判断，让生成的配置文件更加灵活

1）编写playbook

复制代码
[root@ansible PlayBook]# cat testfor03.yml

template for 示例

• hosts: all
  remote_user: root
  vars:
  nginx_vhosts:

  - web1:
    listen: 8081
    root: "/var/www/nginx/web1"
  - web2:
    server_name: "web2.example.com"
    root: "/var/www/nginx/web2"
  - web3:
    listen: 8083
    server_name: "web3.example.com"
    root: "/var/www/nginx/web3"

  tasks:

  • name: Templage Nginx Config
    template: src=nginx.conf.j2 dest=/tmp/nginx_vhost.conf
    复制代码
    2）模板文件编写

复制代码

说明：这里添加了判断，如果listen没有定义的话，默认端口使用8888，如果server_name有定义，那么生成的配置文件中才有这一项。

[root@ansible PlayBook]# cat templates/nginx.conf.j2
{% for vhost in nginx_vhosts %}
server{
{% if vhost.listen is defined %}
listen: {{ vhost.listen }};
{% else %}
listen: 8888;
{% endif %}
{% if vhost.server_name is defined %}
server_name: {{ vhost.server_name }};
{% endif %}
root: {{ vhost.root }};
}
{% endfor %}
复制代码
3）执行playbook并查看生成结果

复制代码
[root@ansible PlayBook]# ansible-playbook testfor03.yml

去到一个节点看下生成的结果发现自动生成了三个虚拟主机

[root@linux ~]# cat /tmp/nginx_vhost.conf
server{
listen: 8081;
root: /var/www/nginx/web1;
}
server{
listen: 8888;
server_name: web2.example.com;
root: /var/www/nginx/web2;
}
server{
listen: 8083;
server_name: web3.example.com;
root: /var/www/nginx/web3;
}
复制代码
上面三个示例的图片展示效果

例一

例二

例三