Ansible简介及常用模块

一、基础介绍

1、简介

ansible是新出现的自动化运维工具，基于Python开发，集合了众多运维工具（puppet、cfengine、chef、func、fabric）的优点，实现了批量系统配置、批量程序部署、批量运行命令等功能。ansible是基于模块工作的，本身没有批量部署的能力。真正具有批量部署的是ansible所运行的模块，ansible只是提供一种框架。主要包括：

(1)、连接插件connection plugins：负责和被监控端实现通信；

(2)、host inventory：指定操作的主机，是一个配置文件里面定义监控的主机；

(3)、各种模块核心模块、command模块、自定义模块；

(4)、借助于插件完成记录日志邮件等功能；

(5)、playbook：剧本执行多个任务时，非必需可以让节点一次性运行多个任务。

2.工作机制

3.特性

(1)、no agents：不需要在被管控主机上安装任何客户端；

(2)、no server：无服务器端，使用时直接运行命令即可；

(3)、modules in any languages：基于模块工作，可使用任意语言开发模块；

(4)、yaml，not code：使用yaml语言定制剧本playbook；

(5)、ssh by default：基于SSH工作；

(6)、strong multi-tier solution：可实现多级指挥。

4、优点
(1)、轻量级，无需在客户端安装agent，更新时，只需在操作机上进行一次更新即可；
(2)、批量任务执行可以写成脚本，而且不用分发到远程就可以执行；
(3)、使用python编写，维护更简单，ruby语法过于复杂；
(4)、支持sudo。

二、Ansible基础安装与配置

本次安装使用的centos6.4系统环境

针对RedHat系列安装EPEL源

rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6
yum install ansible

查看ansible版本：ansible --version
查看ansible安装文件：rpm -ql ansible |head

使用无ssh登录:
#-i用来指定hosts文件位置，webservers定义的主机组名. -u指定用户名，-m 执行命令,-k来提示输入密码

ansible -i /etc/ansible/hosts webservers -u saneri -m command -a 'df -Th' -k 

# vim /etc/ansible/hosts

主机组之间的嵌套写法：

[host:children]
host_1
host_2

[host_1]
10.10.100.14

[host_2]
10.10.100.17

[wservices]
10.20.9.[145:160] ansible_ssh_user=root ansible_ssh_pass='123456'

ansible -i hosts all -m ping -u www
　该命令选项的作用分别为：

　　-i：指定 inventory 文件，使用当前目录下的 hosts
　　all：针对 hosts 定义的所有主机执行，这里也可以指定组名或模式
　　-m：指定所用的模块，我们使用 Ansible 内置的 ping 模块来检查能否正常管理远端机器
　　-u：指定远端机器的用户

[options]

-m：指定模块(默认是command模块)
-a：指定模块的参数
-u：指定执行远程主机的用户(默认是root)ansible.cfg中可配置
-k：指定远程主机的密码
-s：以sudo方式运行
-U：sudo到那个用户(默认是root)
-f：指定多少个进程并发处理(默认是5)
--private-key=/path：指定私钥路径
-T：ssh连接超时时间(默认(10s)
-t：日志输出到该目录
-v：显示详细信息

配置linux主机SSH无密码访问

为了避免Ansible下发指令时输入目标主机密码，通过证书签名达到SSH无密码是一个好的方案，推荐使用ssh-keygen与ssh-copy-id来实现快速证书的生成及公钥下发，其中ssh-keygen生成一对密钥，使用ssh-copy-id来下发生成的公钥.

在主控端主机创建密钥，执行:ssh-keygen -t rsa,有询问直接按回车键即可，将在/root/.ssh/下生成一对密钥，其中id_rsa为私钥，id_rsa.pub为公钥(需要下发到被控主机用户.ssh目录，同时要求重命名成authorized_keys文件.)

接下来同步公钥文件id_rsa.pub到目标主机，推荐使用ssh-copy-id公钥拷贝工具。

命令格式：/usr/bin/ssh-copy-id[-i[identity_file]][user@machine]

#ssh-copy-id -i /root/.ssh/id_rsa.pub root@ip

效验SSH无密码配置是否成功，运行ssh root@ip,如直接进入目标root账号提示符，则说明配置成功.

三、常用模块使用

查看ansible模块的帮助信息(如yum模块)：

[root@localhost ~]# ansible-doc -s yum

(1)、setup

## 用来收集远程主机的一些基本信息

ansible host -m setup

(2)、ping

## 用来测试远程主机的运行状态

# ansible storm_cluster -m ping

(3)、file

## 设置文件的属性

相关选项如下：

force：需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no

group：定义文件/目录的属组

mode：定义文件/目录的权限

owner：定义文件/目录的属主

path：必选项，定义文件/目录的路径

recurse：递归设置文件的属性，只对目录有效

src：被链接的源文件路径，只应用于state=link的情况

dest：被链接到的路径，只应用于state=link的情况

state：

　　directory：如果目录不存在，就创建目录

　　file：即使文件不存在，也不会被创建

　　link：创建软链接

　　hard：创建硬链接

　　touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间

　　absent：删除目录、文件或者取消链接文件

示例：

## 远程文件符号链接创建
# ansible host_1 -m file -a "src=/etc/resolv.conf dest=/tmp/resolv.conf state=link"

##查看远程文件是否创建完成
ansible host_1 -m command -a "ls -lh /tmp/"

##远程删除创建的链接文件
ansible host_1 -m file -a 'path=/tmp/resolv.conf state=absent'

##在远程主机上面创建一个文件
ansible host_1 -m file -a 'path=/tmp/saneri.txt state=touch'

##远程创建目录dd1，指定属主、属组和权限.
ansible host_1 -m file -a 'path=/tmp/dd1 state=directory owner=yanglei group=root mode=777'

(4)、copy

## 复制文件到远程主机

相关选项如下：

backup：在覆盖之前，将源文件备份，备份文件包含时间信息。有两个选项：yes|no

content：用于替代“src”，可以直接设定指定文件的值

dest：必选项。要将源文件复制到的远程主机的绝对路径，如果源文件是一个目录，那么该路径也必须是个目录

directory_mode：递归设定目录的权限，默认为系统默认权限

force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes

others：所有的file模块里的选项都可以在这里使用

src：被复制到远程主机的本地文件，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用“/”来结尾，则只复制目录里的内容，如果没有使用“/”来结尾，则包含目录在内的整个内容全部复制，类似于rsync。
示例：

##复制当前目录下文件test.txt，到host_1列表主机中的/tmp目录.
ansible host_1 -m copy -a 'src=test.txt dest=/tmp/xxoo.sh mode=700'

##复制文件之前先备份源文件.
ansible host_1 -m copy -a 'src=test.txt dest=/tmp/xxoo.sh mode=700 backup=yes'

-rwx------  1 root    root      23 Jan 29 16:37 xxoo.sh
-rwx------  1 root    root      12 Jan 29 16:29 xxoo.sh.2016-01-29@16:37:21~

(5)、command

## 在远程主机上执行命令

相关选项如下：

creates：一个文件名，当该文件存在，则该命令不执行

free_form：要执行的linux指令

chdir：在执行指令之前，先切换到该目录

removes：一个文件名，当该文件不存在，则该选项不执行

executable：切换shell来执行指令，该执行路径必须是一个绝对路径

示例：

# ansible host_1 -m command -a "uptime"

##当/tmp/xxoo.sh文件存在时，则不执行后面的ls -lh /home命令,反之则执行！

ansible host_1 -a 'creates=/tmp/xxoo.sh ls -lh /home'

##执行tar名字之前，先用chdir切换到指定文件目录.

ansible host_1 -a 'chdir=/usr/local/src tar -zcvf nginx_tar.gz  nginx-1.8.0'

#可以使用command模块创建用户

ansible host_1 -m command -a 'useradd -s /sbin/nologin -M user1'

6)、shell

ansible-doc -s shell

## 切换到某个shell执行指定的指令，参数与command相同。

与command不同的是，此模块可以支持命令管道，同时还有另一个模块也具备此功能：raw

示例：

##过滤出sshd服务
ansible host_1 -m shell -a 'ps -ef |grep sshd'

三个远程命令模块的区别：

(1)功能
模块包括command、script、shell，都可以实现远程shell命令运行。
command作为Aasible的默认模块，可以运行远程权限范围所有的shell命令；
script功能是在远程主机执行主控端存储的shell脚本文件，相当于scp+shell组合；
shell功能是执行远程主机的shell脚本文件
(2)示例：
ansible 192.168.21.128 -u ansible --sudo -m command -a 'df -Th'
ansible 192.168.21.128 -u ansible --sudo -m script -a '/root/test.sh'
ansible 192.168.21.128 -u ansible --sudo -m shell -a '/root/test_clinet.sh'

7.service

用于管理服务

该模块包含如下选项：

arguments：给命令行提供一些选项

enabled：是否开机启动 yes|no

name：必选项，服务名称

pattern：定义一个模式，如果通过status指令来查看服务的状态时，没有响应，就会通过ps指令在进程中根据该模式进行查找，如果匹配到，则认为该服务依然在运行

runlevel：运行级别

sleep：如果执行了restarted，在则stop和start之间沉睡几秒钟

state：对当前服务执行启动，停止、重启、重新加载等操作（started,stopped,restarted,reloaded）

示例：

ansible host_1 -m service -a 'name=nginx state=restarted sleep=3'

ansible host_1 -m service -a "name=network state=restarted args=eth0"

8.cron

用于管理计划任务

包含如下选项：

backup：对远程主机上的原任务计划内容修改之前做备份

cron_file：如果指定该选项，则用该文件替换远程主机上的cron.d目录下的用户的任务计划

day：日（1-31，*，*/2,……）

hour：小时（0-23，*，*/2，……）

minute：分钟（0-59，*，*/2，……）

month：月（1-12，*，*/2，……）

weekday：周（0-7，*，……）

job：要执行的任务，依赖于state=present

name：该任务的描述

special_time：指定什么时候执行，参数：reboot,yearly,annually,monthly,weekly,daily,hourly

state：确认该任务计划是创建还是删除

user：以哪个用户的身份执行
示例：

##每隔两小时执行/sbin/reboot命令.
ansible host_1 -m cron -a 'name="reboot system" hour=2 user=root job="/sbin/reboot"'

#查看host_1主机列表的计划任务列表

ansible host_1 -m command -a 'crontab -l'

#删除该计划任务
ansible host_1 -m cron -a 'name="reboot system" hour=2 user=root job="/sbin/reboot" state=absent'
  
ansible host_1 -m cron -a 'name="check home directory" minute=*/3 job="ls -lh /home"'

#每天的五点和两点执行job的计划任务.
ansible host_1 -m cron -a 'name="check dirs" hour="5,2" job="ls -alh > /dev/null"'


#在reboot时执行脚本.
ansible host_1 -m cron -a 'name="a job for reboot" special_time=reboot job="/some/job.sh"'

#每周二的12点钟执行更新yum源操作
ansible host_1 -m cron -a 'name="yum autoupdate" weekday="2" minute=0 hour=12 user="root" job="YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate" cron_file=ansible_yum-autoupdate'

#删除ansible_yum-autoupdate
ansilbe host_1 -m cron -a 'cron_file=ansible_yum-autoupdate state=absent'

9.yum

使用yum包管理器来管理软件包

选项：

config_file：yum的配置文件

disable_gpg_check：关闭gpg_check

disablerepo：不启用某个源

enablerepo：启用某个源

list

name：要进行操作的软件包的名字，也可以传递一个url或者一个本地的rpm包的路径

state：状态（present,latest,absent） (present,latest为安装，absent为删除)
示例：

##使用yum安装httpd软件
ansible host_1 -m yum -a 'name=httpd state=present'

ansible host_1 -m yum -a 'name=httpd state=latest'
 
##启动httpd服务
ansible host_1 -m service -a 'name=httpd state=started'  

10.user模块

用户管理模块

常用参数：

home        #指定用户的家目录，需要与createhome配合使用;
groups      #指定用户的属组;
uid         #指定用的uid;
password    #指定用户的密码;
name        #指定用户名;
createhome  #是否创建家目录yes|no;
system      #是否为系统用户;
remove      #当state=absent时，remove=yes则表示连同家目录一起删除，等价于userdel -r;
state       #是创建还是删除;
shell       #指定用户的shell环境;

说明的是，password后面指定的密码不能是明文，后面这一串密码会被直接传送到被管理主机的/etc/shadow文件中，而登陆的时候输入的密码会被hash加密以后再去与/etc/shadow中存放的密码去做对

比，会出现不一致的现象。所以需要先将密码字符串进行加密处理：openssl passwd -salt -1 "123456"，然后将得到的字符串放到password中即可。

示例：

#创建user1用户
ansible host_1 -m user -a 'createhome=yes home=/home/user1 password=123456 name=user1 state=present shell=/bin/bash'

#删除user1用户：
ansible host_1 -m user -a 'remove=yes state=absent name=user1'

11.group

组管理模块，使用实例：

ansible all -m group -a 'name=groupname state=present'

常用参数：

gid     #指定gid;
name    #指定组名称;
state   #操作状态，present,absent;
system  #是否为系统组;

12.synchronize

使用rsync同步文件

archive #归档

checksum #检验其校验和

delete #删除源中没有，目标中存在的文件

dest #目标位置

src #源

dest_port

existing_only: skip createing new files on receiver

links

owner

mode:(push, pull) #模式，同步方式分为push（推）和pull（拉取）两种

recursive

rsync_path

示例：

ansible host_1 -m synchronize -a 'src=/tmp/helloworld dest=/var/www/'    

ansible host_1 -m synchronize -a 'src=./ansible.cfg dest=/tmp/ mode=push rsync_path=/usr/bin/rsync rsync_opts="-avz,--exclude=.git"'  

13.filesystem

在块设备上创建文件系统

选项：

dev：目标块设备

force：在一个已有文件系统的设备上强制创建

fstype：文件系统的类型

opts：传递给mkfs命令的选项

示例：

#创建数据设备，模拟数据设备
ansible host_1 -m command -a 'dd if=/dev/zero of=/disk.img bs=4k count=1024'	

#关联loop设备
ansible host_1 -m command -a 'losetup /dev/loop0 /disk.img'   		

ansible host_1 -m filesystem -a 'losetup /dev/loop0 /disk.img'

#格式化块设备,-F表示强制创建

ansible host_1 -m filesystem -a 'dev=/disk.img fstype=ext4 opts=-F'

14.mount

配置挂载点

选项：

dump

fstype：必选项，挂载文件的类型，ext3、ext4...

name：必选项，挂载点

opts：传递给mount命令的参数

passno

src：必选项，要挂载的文件

state：必选项

present：只处理fstab中的配置

absent：删除挂载点

mounted：自动创建挂载点并挂载之

umounted：卸载

示例：

#将块设备挂载到/tmp目录下

ansible host_1 -m mount -a 'fstype=ext4 name=/tmp src=/dev/loop0 state=mounted'

#在/aaa目录下创建test文件

ansible host_1 -m file -a 'path=/aaa/test state=touch'

#将块设备挂载到/mnt目录下,并有可读写权限

ansible host_1 -m mount 'name=/mnt src=/dev/loop0 fstype=ext4 state=mounted opts=rw'

15.stat模块

(1)功能
获取远程文件状态信息，包括atime、ctime、mtime、md5、uid、gid等信息。

ansible 192.168.21.128 -u ansible --sudo  -m stat -a "path=/etc/sysctl.conf"

16.get_url模块
(1)功能
实现在远程主机下载指定URL到本地，支持sha256文件校验.

ansible 192.168.21.128 -u ansible --sudo  -m get_url -a "url=http://www.baidu.com dest=/tmp/index.html mode=0440 force=yes"

17.unarchive模块

用于解压文件的模块

$ ansible test -m unarchive -a 'src=foo.tgz dest=/var/lib/foo'
$ ansible test -m unarchive -a 'src=/tmp/foo.zip dest=/usr/local/bin copy=no'
$ ansible test -m unarchive -a 'src=https://example.com/example.zip dest=/usr/local/bin copy=no'

常用参数：

copy        #在解压文件之前，是否先将文件复制到远程主机，默认为yes。若为no，则要求目标主机上压缩包必须存在;
creates     #指定一个文件名，当该文件存在时，则解压指令不执行;
dest        #远程主机上的一个路径，即文件解压的路径;
group       #解压后的目录或文件的属组;
list_files  #如果为yes，则会列出压缩包里的文件，默认为no，2.0版本新增的选项;
mode        #解决后文件的权限;
src         #如果copy为yes，则需要指定压缩文件的源路径;
owner       #解压后文件或目录的属主;

18.debug模块

(1.)功能

调试模块，用于在调试中输出信息

常用参数：

msg：调试输出的消息
var：将某个任务执行的输出作为变量传递给debug模块，debug会直接将其打印输出
verbosity：debug的级别（默认是0级，全部显示）

debug模块示例：

---
- hosts: 192.168.21.128
  gather_facts: False
  tasks:
  - name: command run line
    shell: date
    register: result
  - name: show debug info
    debug: var=result.stdout verbosity=0
    
    
debug: var=result verbosity=0时可以看到debug不光输出了date命令结果,还返回了很多相关调试信息,只需要date返回值可以使用变量属性过滤 如result.stdout 就是命令的返回值

#获取被控机器的fact数据默认为True,你可以关闭获取fact数据功能。关闭之后,可以加快 ansible-playbook 的执行效率。
gather_facts：False

更多模块查阅ansible中文官方文档：http://www.ansible.com.cn/

　　　　　　　　　　　　　　　　http://www.mamicode.com/info-detail-1428476.html

　　　　　　　　　　　　　　　　http://www.ywnds.com/?p=6051