运维自动化之ansible的安装与使用
随着服务器数量的增长，我们需要一个批量工具去提高工作效率，之前用的是puppet，ansible的简单，适用让我眼前一亮，决定写一篇ansible从安装到基本配置的文档供新手参阅。
一、安装
1.安装第三方epel源
centos 6的epel
[root@ansible ~]# wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
[root@ansible ~]# rpm -ivh epel-release-6-8.noarch.rpm
centos5版本的安装5的epel（不详细解释）
2.安装ansible
[root@ansible ~]# yum install ansible -y
[root@ansible ~]# ll /etc/ansible
-rw-r--r-- 1 root root 8625 Oct 11 18:06 ansible.cfg
-rw-r--r-- 1 root root 1046 Oct 11 18:06 hosts
ansibles.cfg是配置文件，hosts是管理主机信息
建议密钥认证
[root@ansible ~]# ssh-keygen （直接回车即可）
推送公钥
[root@ansible ~]# for i in {1..4}; do ssh-copy-id -i 192.168.78.1$i; done
[root@ansible ~]# cat /etc/ansible/hosts
...
[web]
192.168.78.11
192.168.78.12
[mysql]
192.168.78.13
192.168.78.14
...
组名以及ip根本自己需求定义
3.定义变量
1）定义主机变量
[root@ansible ansible]# cat hosts
...
[web]
192.168.78.11 http_port=80
192.168.78.12 http_port=303
...
**主机指定变量，以便后面供palybooks配置使用。定义两台web服务器的apache参数http_port，可以让两台服务器产生的apache配置文件httpd.conf差异化**
2）定义组变量
[root@ansible ansible]# cat hosts
...
[web]
192.168.78.11
192.168.78.12
[web:vars]
http_port=80
**组变量的作用域是覆盖组所有成员，通过定义一个新块，块名由组名+ ":vars"组成。**
3）嵌套组
[root@ansible ~]# cat /etc/ansible/hosts
...
[web]
192.168.78.11
192.168.78.12
[mysql]
192.168.78.13
192.168.78.14
[nested：children]
web
mysql
[nested：vars]
ntp_server=s1b.time.edu.cn
...
**嵌套组定义一个新块，块名由组名+":chilren"组成。同是嵌套组也可以定义组变量，作用域是嵌套组里的所有组
嵌套组只能在/usr/bin/ansible-playbook中，在/usr/bin/ansible中不起作用，下面会介绍playbook**
4）分离主机与组特定数据
**为了更好的规范定义的主机与组变量，我们实际是不会在hosts里直接写的，将定义的主机名与组变量单独剥离出来放到指定的文件中，将采用YAML格式存放，存放位置规定："/etc/ansible/group\_vars/+组名"和"/etc/ansible/host\_vars/+主机名"分别存放指定组名或主机名定义的变量，如下：**
**注意目录结构，规范目录名** 
[root@ansible host_vars]# cat 192.168.78.11.yml
---
http_port: 80
[root@ansible group_vars]# cat mysql.yml
---
ntp_server: s1b.time.edu.cn
database_server: 192.168.78.14
[root@ansible group_vars]# cat web.yml
---
ntp_server: s1b.time.edu.cn
http_prot: 80
**可以直接调用变量，规范目录名的原因是ansible会自动加载这几个目录下的变量，如果变量不放到这几个目录下，是不能调用的，我们会在后面介绍到不放到特定目录下，playbook如何调用这些变量**
二、命令参数
Usage: ansible <host-pattern> [options]
Options:
-m MODULE\_NAME, --module-name=MODULE\_NAME 要执行的模块，默认为 command
-a MODULE_ARGS, --args=MODULE_ARGS 模块的参数
-u REMOTE_USER, --user=REMOTE_USER ssh 连接的用户名，默认用 root，ansible.cfg 中可以配置
-k, --ask-pass 提示输入 ssh 登录密码，当使用密码验证登录的时候用
-s, --sudo sudo 运行
-U SUDO_USER, --sudo-user=SUDO_USER sudo 到哪个用户，默认为 root
-K, --ask-sudo-pass 提示输入 sudo 密码，当不是 NOPASSWD 模式时使用
-B SECONDS, --background=SECONDS run asynchronously, failing after X seconds(default=N/A)
-P POLL_INTERVAL, --poll=POLL_INTERVAL set the poll interval if using
-B (default=15)
-C, --check 只是测试一下会改变什么内容，不会真正去执行
-c CONNECTION 连接类型(default=smart)
-f FORKS, --forks=FORKS fork 多少个进程并发处理，默认 5
-i INVENTORY, --inventory-file=INVENTORY 指定 hosts 文件路径，默认 default =/etc/ansible/hosts
-l SUBSET, --limit=SUBSET 指定一个 pattern，对<host_pattern>已经匹配的主机中再过滤一次
--list-hosts 只打印有哪些主机会执行这个 playbook 文件：不是实际执行该 playbook
-M MODULE_PATH, --module-path=MODULE_PATH 要执行的模块的路径，默认为/usr/share/ansible/
-o, --one-line 压缩输出，摘要输出
--private-key=PRIVATE_KEY_FILE 私钥路径
-T TIMEOUT, --timeout=TIMEOUT ssh 连接超时时间，默认 10 秒
-t TREE, --tree=TREE 日志输出到该目录，日志文件名会以主机名命名
-v, --verbose verbose mode (-vvv for more, -vvvv to enable connection debugging)
1)以 xb 身份 ping 所有主机
ansible all -m ping -u xb
2)用 xb 用户以 root 身份 ping
ansible all -m ping -u xb --sudo
3)用 xb 用户 sudo 到 bx 用户 ping
ansible all -m ping -u xb --sudo --sudo-user bx
三、常用模块
copy模块：
目的：把主控端/root目录下的a.sh文件拷贝到到指定节点上
命令：ansible 10.1.1.113 -m copy -a ‘src=/root/a.sh dest=/tmp/ owner=root group=root mode=0755‘
file模块：
目的：更改指定节点上/tmp/t.sh的权限为755，属主和属组为root
命令：ansible all -m file -a "dest=/tmp/t.sh mode=755 owner=root group=root"
cron模块：
目的：在指定节点上定义一个计划任务，每隔3分钟到主控端更新一次时间
命令：ansible all -m cron -a ‘name="custom job" minute=\*/3 hour=\* day=\* month=\* weekday=\* job="/usr/sbin/ntpdate 172.16.254.139"‘
group模块：
目的：在所有节点上创建一个组名为nolinux，gid为2014的组
命令：ansible all -m group -a ‘gid=2014 name=nolinux‘
user模块：
目的：在指定节点上创建一个用户名为nolinux，组为nolinux的用户
命令：ansible 10.1.1.113 -m user -a ‘name=nolinux groups=nolinux state=present‘
删除用户
命令：ansible 10.1.1.113 -m user -a ‘name=nolinux state=absent remove=yes‘
yum模块：
目的：在指定节点上安装 apache 服务
命令：ansible all -m yum -a "state=present name=httpd"
state=latest=>>安装最新版本
service模块：
目的：启动指定节点上的 httpd 服务，并让其开机自启动
命令：ansible 10.1.1.113 -m service -a ‘name=httpd state=restarted enabled=yes‘
script模块：
目的：在指定节点上执行/root/a.sh脚本(该脚本是在ansible主控端)
命令：ansible 10.1.1.113 -m script -a ‘/root/a.sh‘
ping模块：
目的：检查指定节点机器是否还能连通
命令：ansible 10.1.1.113 -m ping
command模块：
目的：在指定节点上运行hostname命令
命令：ansible 10.1.1.113 -m command -a ‘hostname‘
raw模块：
目的：在10.1.1.113节点上运行ifconfig命令
命令：ansible 10.1.1.113 -m raw-a ‘ifconfig|eth0‘
get_url模块：
目的：将http://10.1.1.116/favicon.ico文件下载到指定节点的/tmp目录下
命令：ansible 10.1.1.113 -m get_url -a ‘url=http://10.1.1.116/favicon.ico dest=/tmp‘
stat模块：
目的：获取远程文件状态信息，包括atime、ctime、mtime、md5、uid、gid等信息
ansible web -m stat -a ‘path=/etc/sysctl.conf‘
synchronize模块：
目的：将主控方/root/a目录推送到指定节点的/tmp目录下
命令：ansible 10.1.1.113 -m synchronize -a ‘src=/root/a dest=/tmp/ compress=yes‘
执行效果：
delete=yes 使两边的内容一样（即以推送方为主）
compress=yes 开启压缩，默认为开启
--exclude=.git 忽略同步.git结尾的文件
mode=pull 更改推送模式为拉取模式
目的：将10.1.1.113节点的/tmp/a目录拉取到主控节点的/root目录下
命令：ansible 10.1.1.113 -m synchronize -a ‘mode=pull src=/tmp/a dest=/root/‘
需要更多模块请使用ansible-doc -l查询
四、playbook配置管理
1.语法说明
- hosts： web #定义操作的对象，可以是主机或组
vars： #这个是变量
http_port: 80
max_clients: 200
remote_user: root #远端的执行权限，可以理解为远程操作的用户名
#任务列表，playbook将按定义的配置文件自上而下的执行，定义的主机都将得到相同的任务，但执行的结果不一定保持一致，
取决于主机的环境及程序包状态。建议每个任务都要定义一个name标签，增强可读性，也便于观察结果输出时了解运行的位置。
tasks：
- name: ensure apache is at the latest version
yum: pkg=httpd state=latest #利用yum模块来操作
- name: write the apache
template: src=/srv/httpd.j2 dest=/etc/httpd.conf
#触发重启服务器
notify:
- restart apache
- name: ensure apache is running
service: name=httpd state=started
#这里的restart apache 和上面的触发是配对的。这就是handlers的作用。相当于tag
handlers:
- name: restart apache
service: name=httpd state=restarted
#### 如果做了相关sudo限制，需要在playbook里面开启sudo ####
- hosts: web
remote_user: xiaobi
tasks:
- service: name=httpd state=started
sudo: yes
### 2.playbook实例 ###
**创建一个xiaobi的用户，里面引用了一个user的变量，用jinja2模板给赋值进去了。**
[root@ansible ansible]# cat user.yml
- name: create user
hosts: web
user: root
gather_facts: false
vars:
- user: "xiaobi"
tasks:
- name: create {{ user }}
user: name={{ user }}
**下面多一个service的调用**
[root@ansible ansible]# cat user.yml
- name: create user
hosts: web
user: root
gather_facts: false
vars:
- user: "xiaobi"
tasks
- name: create {{ user }}
user: name={{ user }}
- service: name=httpd state=started
**再加一个copy模块的调用**
[root@ansible ansible]# cat user.yml
- name: create user
hosts: web
user: root
gather_facts: false
vars:
- user: "xiaobi"
tasks:
- name: create {{ user }}
user: name={{ user }}
- service: name=httpd state=startedc
- name: Copy file to client
copy: src=/tmp/tiger dest=/tmp/tigress
**注意：使用copy传送文件的时候，有可能会报错：**
afewbug | FAILED >> {
"checksum": "4ee72f7427050dcd97068734d35ca7b2c651bc88",
"failed": true,
"msg": "Aborting, target uses selinux but python bindings (libselinux-python) aren‘t installed!"
**是因为ansible需要libselinux-python包。（被控端需要安装libselinux-python**）
**可以在copy前先调用yum模块，安装libselinux-python**
[root@ansible ansible]# cat user.yml
- name: create user
hosts: web
user: root
gather_facts: false
vars:
- user: "xiaobi"
tasks:
- name: create {{ user }}
user: name={{ user }}
- service: name=httpd state=started
- name: ensure libselinux-python is at the latest
yum: pkg=libselinux-python state=latest
- name: Copy file to client
copy: src=/tmp/tiger dest=/tmp/tigress
**template模板复制，支持jinja2，以变量say命名**
[root@ansible ansible]# cat user.yml
- name: create user
hosts: web
remote_user: root
gather_facts: false
vars:
- user: "xiaobi"
- say: "tiger"
tasks:
- name: create {{ user }}
user: name={{ user }}
- service: name=httpd state=started
- name: ensure libselinux-python is at the latest version
yum: pkg=libselinux-python state=latest
- name: Copy file to client
# copy: src=/tmp/tiger dest=/tmp/tigress
template: src=/tmp/tiger dest=/tmp/{{ say }}
**不只是这样，还可以把刚才的那个say变量传到文件里，其实和saltstack是一样的** 
**再加一个执行外部命令的模块**
[root@ansible ansible]# cat user.yml
- name: create user
hosts: web
remote_user: root
gather_facts: false
vars:
- user: "xiaobi"
- say: "tiger"
tasks:
- name: create {{ user }}
user: name={{ user }}
- service: name=httpd state=started
- name: ensure libselinux-python is at the latest version
yum: pkg=libselinux-python state=latest
- name: Copy file to client
# copy: src=/tmp/tiger dest=/tmp/tigress
template: src=/tmp/tiger dest=/tmp/{{ say }}
- name: run this command and ignore the result
shell: /usr/bin/somecommand || /bin/true
- name: "cmd"
command: touch /tmp/tigress
# - name: "cmd"
# action: command touch /tmp/tigress
**注释：
1./usr/bin/somecommand：执行某些命令 ||： 前面失败的话/bin/true：返回true。当你执行一些特定的命令，得到的结果是你可能无法预测的，不希望他的结果为false而中断，而是继续执行，这个true就有意义了。类似的判断还有chenge_when参数
2.老版本的写法是action: commadn touch 现在基本弃用了，ansible0.8或以上版本可以直接调用shell，command模块，结果是一样的。**
)
**小节总结：已经完成的操作会提示绿色ok，没有做过的操作会提示黄色changed。shell一类执行是没有完整的行为判断的。只有结果输出，所有永远为changed**
ansible-playbook user.yml -f 10
**ansible在多任务下，推荐使用多进程模式的。其实就是用multiprocess做的多进程池 ！ -f 10 就是limit 10个任务并发。
fork默认是5,如果有5个客户端,那么这5个是同时执行的;如果是6个,那么第6个要等前面5个执行完**
### 3.变量功能 ###
1）系统变量
**前言介绍：获取远程主机系统信息==>>Facts。
facts是一个非常有用的组件，类似于Saltstack的Grains功能，puppet的facter的功能。实现获取远程主机的系统信息，包括主机名、ip地址、操作系统、分区信息、硬件信息等，可以配合playbook实现更加个性化、灵活的功能需求，比如在httpd.conf模板中引用Facts的主机名信息作为ServerName参数的值。通过运行ansible web -m setup可获取Facts信息，下面是一些实例：**
ansible web -m setup
**这里只展示一部分，可以得到很多信息，这些信息是可以作为变量引用的**
**以下请看圈起来的地方对比的看就容易明白了**
2）自定义变量
**我们可以通过Facts来获取目标主机的系统信息，当这些信息还不能满足我们的功能需求时，通过编写自己定义的的Facts模块来实现。当然，还有一个更简单的实现方法，就是通过本地Facts来实现。只需在目标设备/etc/ansible/facts.d目录定义JSON、INI或可执行文件的JSON输出，文件扩展名要求使用".fact"，这些文件都可以作为Ansible的本地Facts，看下面例子，在目标主机192.168.78.11定义三个变量，供以后playbook进行引用**
**①！！！注意：此操作是在目标主机，后面会介绍在主控端操作：**
[root@192 ~]# mkdir /etc/ansible/facts.d -p
[root@192 ~]# cd /etc/ansible/facts.d
[root@192 facts.d]# vim icsoc.fact
[general]
apple=1
banana=2
orange=3
**在主控端运行ansibles 192.168.78.11 -m setup -a ‘filter=ansible\_local‘**
**注意返回JSON的层次结构，icsoc（文件名前缀）→general（INI的节名）→key:value（INI的键与值），现在我们就可以在我们的模板或playook中通过以下方式进行调用：**
**{{ ansible\_local.icsoc.general.apple }}**
**②下面来说一切操作都在主控端进行**
**在主控端创建icsoc\_new.fact文件，如下：（下面会提到为什么以icsoc\_new.fact命名而不能使用icsoc-new.fact命名原因）**
[root@ansible ansible]# cat /etc/ansible/icsoc_new.fact
[general]
apple=11
banana=22
orange=33
**在user.yml中加入创建目录，以及把主控端的icsoc_new.fact推送到目标主机**
[root@ansible ansible]# cat user.yml
- name: create user
hosts: web
remote_user: root
gather_facts: true
vars:
- user: "xiaobi"
- say: "tiger"
tasks:
- name: create {{ user }}
user: name={{ user }}
- service: name=httpd state=started
- name: ensure libselinux-python is ata the latest version
yum: pkg=libselinux-python state=latest
- name: Copy file to client
# copy: src=/tmp/tiger dest=/tmp/tigress
template: src=/tmp/tiger dest=/tmp/{{ say }}
- name: "cmd"
command: touch /tmp/tigree
- name: run this command and ignore the result
shell: /usr/bin/somecommand || /bin/true
- name: "reference facts variable"
template: src=/tmp/bbb dest=/tmp/{{ ansible_default_ipv4.address }}
- name: create directory for ansible custom facts
file: state=directory recurse=yes path=/etc/ansible/facts.d
- name: install custom impi fact
copy: src=/etc/ansible/icsoc_new.fact dest=/etc/ansible/facts.d
- name: re-read facts after adding custom fact
setup: filter=ansible_local
**运行ansible-playbook user.yml截图太长不截图了，和上面基本一样**
此时在目标主机就有了/etc/ansible/facts.d/icsoc\_new.fact文件。
**运行ansible web -m setup -a ‘filter=ansible\_local‘**
**注意返回JSON的层次结构，icsoc_new（文件名前缀）→general（INI的节名）→key:value（INI的键与值），现在我们就可以在我们的模板或playook中通过以下方式进行调用：**
**{{ ansible\_local.icsoc\_new.general.apple }}**
**!!!注意：变量名的命名规则由字母、数字和下划线组合而成，变量必须以字母开头，如：icsoc\_new,icsoc5都是可以的，icsoc-new和5icsoc是不可以的，这也是我们创建本地facts的时候不使用icsoc-new.fact命名的原因。**
3）注册变量
**变量的另一个用途是将一条命令的运行结果保存到变量中，供后面的playbook使用。下面介绍一个简单的示例：（由于截图太长，我们重新写一个简短的user1.yml，方便截图）**
[root@ansible ansible]# cat user1.yml
- hosts: web
remote_user: root
tasks:
- shell: /usr/bin/foo
register: foo_result
ignore_errors: True
- shell: touch /tmp/kkkk
when: foo_result.rc == 5
**上述示例注释：
1.注册了一个foo\_resul变量，变量值为shell: /usr/bin/foo的运行结果;
2.ignore\_errors: True为忽略错误
3.当变量注册完成后，就可以在后面的playbook中使用了
4.当条件语句when: foo\_result.rc == 5成立时，shell: touch /tmp/kkkk命令才会执行
5.foo\_result.rc为返回/usr/bin/foo的resultcode（返回码）返回"rc=0"的返回码** 
**由于/usr/bin/foo的运行结果返回码是127，所以shell: touch /tmp/kkkk命令没有执行，这里显示跳过了。下面我们再修改一下user1.yml把when: foo\_result.rc == 5改为127，再测试一下**
[root@ansible ansible]# cat user1.yml
- hosts: web
remote_user: root
tasks:
- shell: /usr/bin/foo
register: foo_result
ignore_errors: True
- shell: touch /tmp/kkkk
when: foo_result.rc == 127
### 4.语句 ###
####1）条件语句####
**前言：
1.有时候一个playbook的结果取决于一个变量，或者取决于上一个任务（task）的执行结果值，在某些情况下，一个变量的值可以依赖于其他变量的值，当然也会影响ansible的执行过程
2.有时候我们想跳过某些主机的执行步骤，比如符合特定版本的操作系统将不安装某个软件包，或者磁盘空间满了将进行清理的步骤。
3.这些在ansible中很容易做到，通过when实现，其中将引用jinja2表达式。**
[root@ansible ansible]# cat when.yml
- name: when
hosts: web
remote_user: root
gather_facts: true
tasks:
- name: "shutdown Debian flavored systems"
command: /sbin/shutdown -t now
when: ansible_os_family == "Debian"
**通过变量ansible_os_family == "Debian"（操作系统版本名称）是否为Debian，结果将返回BOOL类型值，为True时将执行上一条语句command: /sbin/shutdown -t now，为False时该条语句都不会触发。**
**下面再写一个通过判断一条命令执行结果做不同分支的二级处理**
[root@ansible ansible]# cat when1.yml
- name: when
hosts: web
remote_user: root
gather_facts: true
tasks:
- command: /sbin/ip a
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： result|success"的意思为当变量result执行结果为成功状态是，将执行/bin/something_else命令，其他同理。其中success为Ansible内部过滤器方法，返回True代表命令运行成功。**
#### 2）循环语句 ####
[root@ansible ansible]# cat wheel.yml
- name: whell
hosts: web
remote_user: root
gather_facts: true
tasks:
- name: "Batch add user"
user: name={{ item }} state=present groups=wheel
with_items:
- tiger1
- tiger2
**以上示例是批量创建系统用户的功能。with\_items会自动循环执行上面的语句"user: name={{ item }} state=present groups=wheel"，循环的次数为with\_items的元素个数。这里有2个元素，分别为tiger1、tiger2，会分别替换{{ item }}项，这个示例与下面的示例是等价的：**
[root@ansible ansible]# cat wheel.yml
- name: whell
hosts: web
remote_user: root
gather_facts: true
tasks:
- name: "add user tiger1"
user: name=tiger1 state=present groups=wheel
- name: "add user tiger2"
user: name=tiger2 state=present groups=wheel
**元素也支持字典的形式，如下：**
[root@ansible ansible]# cat wheel.yml
- name: whell
hosts: web
remote_user: root
gather_facts: true
tasks:
- name: "Batch add user"
user: name={{ item.name }} state=present groups={{ item.groups }}
with_items:
- { name: ‘tiger1‘,groups: ‘wheel‘ }
- { name: ‘tiger2‘,groups: ‘root‘ }
**循环也支持列表（list）的形式，不过是通过with_flattened语句来实现的，如下：**
[root@ansible ansible]# cat /etc/ansible/123.yml
packages_base:
- [ ‘vsftpd‘, ‘vim‘ ]
packages_apps:
- [[ ‘mysql‘, ‘httpd‘ ]]
**以上定义了两个列表变量，分别是需要安装的软件包名，以便后面进行引用，如下：**
[root@ansible ansible]# cat /etc/ansible/wheel1.yml
- name: whell
hosts: web
vars_files: #之前说的在特定的目录下定义变量文件，可以自动加载。如果在自定义路径，我们需要这里指明具体路径
- /etc/ansible/123.yml
remote_user: root
gather_facts: true
tasks:
- name: "Batch install rpms"
yum: name={{ item }} state=installed
with_flattened: #通过使用with_flattened语句循环引用定义好的列表变量
- packages_base
- packages_apps 
**通过使用with_flattened语句循环引用定义好的列表变量**
### 5.handlers与include ###
**当多个playbook涉及复用的任务列表时，可以将复用的内容剥离出来，写到独立的文件里，需要的地方include进来即可**
**除了tasks之外，还有一个handlers的命令，handlers是在执行tasks之后服务器发生变化之后可供调用的handler，如下所示：**
[root@ansible ansible]# cat httpd.yml
- name: write the httpd config file
hosts: web
remote_user: root
gather_facts: true
tasks:
- name: write the httpd.conf to client
template: src=/httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
notify: # 如果copy执行完之后/etc/httpd/conf/httpd.conf文件发送了变化，则执行
- restart httpd # 调用handler
- include: playbook/tasks/httpd.yml
handlers:
- name: restart httpd #此处的标识必须和notify一样才可以引起触发
service: name=httpd state=restarted
**注意上面使用的- include: playbook/tasks/httpd.yml，看一下这个文件的内容，**
[root@ansible ansible]# cat playbook/tasks/httpd.yml
- name: ensure httpd is running
service: name=httpd state=started
本文出自 “10995114” 博客，请务必保留此出处http://11005114.blog.51cto.com/10995114/1812386
原文地址：http://11005114.blog.51cto.com/10995114/1812386
