运维工具Ansible—常用模块的使用

常用模块使用
首先在使用模块之前我们可以查看一下模块有多少，不过大多数用不到。下面主要看几个常用模块

[root@soso ~]# ansible-doc -l | wc -l
262

1、setup

##用来查看远程主机的基本信息

[root@soso ~]# ansible test -m setup

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

[root@soso ~]# ansible test -m ping

3、file
##设置文件属性

[root@soso ~]# ansible-doc -s file
- name: Sets attributes of files
action: file
force                  # 需要在两种情况下创建软连接，一种是源文件不存在，但之后建立的情况下；另一种是目标软连接已存在，需要先取消之前的软链，然后创建新的软链：有两个选项：yes|no
group                  # 定义文件/目录的所属组
mode                   # 定义文件/目录的权限
owner                  # 定义文件/目录的所属主
path=                  # 必选项，定义文件/目录的路径
recurse                # 递归设置文件的属性，只对目录有效
src                    # 要被链接的源文件路径，只应用于state=link的情况有效
state                  # 状态
directory        #如果目录不存在则创建目录
file                #即使文件不存在，也不会被创建
link                #创建软连接
hard                #创建硬链接
touch               #如果文件不存在，则会创建一个新的文件；如果文件或目录存在，则更新其最后的修改时间
absent              #删除目录、文件或者取消链接文件
(END)

将远程主机/etc/passwd 文件链接到 /root 目录下：

[root@soso ~]# ls
Python-2.7.5  shell  soft
[root@soso ~]# ansible test -m file -a "src=/etc/passwd dest=/root/passwd state=link"
192.168.1.2 | success >> {
"changed": true,
"dest": "/root/passwd",
"gid": 0,
"group": "root",
"mode": "0777",
"owner": "root",
"size": 11,
"src": "/etc/passwd",
"state": "link",
"uid": 0
}

[root@soso ~]# ll
total 12
drwxr-xr-x 18 1000 1000 4096 Nov 26 11:11 Python-2.7.5
lrwxrwxrwx  1 root root   11 Dec 16 15:35 passwd -> /etc/passwd
drwxr-xr-x  3 root root 4096 Dec  7 15:06 shell
drwxr-xr-x 12 root root 4096 Dec 16 15:32 soft

删除创建的软连接

[root@soso ~]# ansible test -m file -a 'path=/root/passwd state=absent'
192.168.1.2  | success >> {
"changed": true,
"path": "/root/passwd",
"state": "absent"
}

[root@soso ~]# ll
total 12
drwxr-xr-x 18 1000 1000 4096 Nov 26 11:11 Python-2.7.5
drwxr-xr-x  3 root root 4096 Dec  7 15:06 shell
drwxr-xr-x 12 root root 4096 Dec 16 15:32 soft

创建文件

[root@soso ~]# ansible test -m file -a 'path=/root/1 state=touch'
192.168.1.2 | success >> {
"changed": true,
"dest": "/root/1",
"gid": 0,
"group": "root",
"mode": "0644",
"owner": "root",
"size": 0,
"state": "file",
"uid": 0
}

[root@soso ~]# ls
1  Python-2.7.5  shell  soft

4、cope

##复制本地文件到远程主机，进行统一部署
用法：
backup # 用于复制时，是否备份远程主机上的目标文件
content # 用于替代 ‘src’ ，可以直接设定指定文件的值
dest= # 必选项，要将源文件复制到远程主机的绝对路径，如果源文件是一个目录，那么远程路径也必须是一个目录
directory_mode # 递归设定目录的权限，默认为系统默认权限
force # 强制覆盖。如果目标主机包含该文件，但内容不同，如果设置为yes,则强制覆盖；如果设置为no，则只有当目录主机的目录位置不存在该文件时，才复制。默认为yes
group # 定义文件/目录的所属组
mode # 定义文件/目录的权限
owner # 定义文件/目录的所属主
src # 要复制到远程主机的文件在本地的地址，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用 '/' 结尾，则只复制目录里的内容，如果没有使用 '/' 来结尾，则包含目录在内的整个内容全部复制。

实例：

讲本地文件复制到远程主机

[root@soso ~]#  ansible test -m copy -a "src=/root/1 dest=/tmp/1  mode=600 "
192.168.1.2 | success >> {
"changed": true,
"checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
"dest": "/tmp/1",
"gid": 0,
"group": "root",
"md5sum": "d41d8cd98f00b204e9800998ecf8427e",
"mode": "0600",
"owner": "root",
"size": 0,
"src": "/root/.ansible/tmp/ansible-tmp-1450252219.51-80486766978488/source",
"state": "file",
"uid": 0
}

[root@soso ~]# ll /tmp/1
-rw------- 1 root root 0 Dec 16 15:50 /tmp/1

5、command
##远程主机上执行命令
creates：一个文件名，当该文件存在，则该命令不执行free_form：要执行的linux指令chdir：在执行指令之前，先切换到该目录removes：一个文件名，当该文件不存在，则该选项不执行executable：切换shell来执行指令，该执行路径必须是一个绝对路径

[root@soso ~]# ansible test -m command -a 'ls /home'
192.168.1.2| success | rc=0 >>
redis
zabbix

实例：
使用 creates 参数，判断一个文件是否存在，存在的话，就跳过后面的执行命令

[root@soso ~]# ansible test -m command -a 'creates=/tmp/1 ls -l /etc/passwd'
192.168.1.2  | success | rc=0 >>
skipped, since /tmp/1 exists

[root@soso ~]# ansible test -m command -a 'creates=/tmp/2 ls -l /etc/passwd'
192.168.1.2 | success | rc=0 >>
-rw-r--r-- 1 root root 1882 Dec 14 20:11 /etc/passwd

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

[root@soso ~]# ansible test -m shell -a 'cat /etc/passwd| grep root'
192.168.1.2  | success | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin

7、synchronize
使用rsync同步文件。使用rsync 模块，系统必须安装rsync 包，否则无法使用这个模块
用法：
archive # 是否采用归档模式同步，即以源文件相同属性同步到目标地址
checksum # 是否效验
compress #
copy_links # 同步的时候是否复制连接
delete # 删除源中没有而目标存在的文件
dest= # 目标地址
dest_port # 目标接受的端口
dirs # 以非递归的方式传输目录
existing_only # Skip creating new files on receiver.
group # Preserve group
links # Copy symlinks as symlinks.
mode # 模式，rsync 同步的方式 PUSH\PULL
recursive # 是否递归 yes/no
rsync_opts # 使用rsync 的参数
rsync_path # 服务的路径（源码编译时需指定）
rsync_timeout # Specify a --timeout for the rsync command in seconds.
set_remote_user # put user@ for the remote paths. If you have a custom ssh config to define the remote user for
src= # 源，同步的数据源
检查机器上是否装过rsync:

[root@soso ~]#which rsync

没有装过的主机可以远程安装rsync包：

[root@soso ~]#  ansible test -m yum -a 'name=rsync state=latest'

实例：
1、将ansible 服务端/root/ 下的hello 文件同步到test的/tmp：

[root@soso ~]# ansible test -m  synchronize -a 'src=/root/hello dest=/tmp/'
192.168.1.2 | success >> {
"changed": true,
"cmd": "rsync --delay-updates -F --compress --archive --rsh 'ssh  -S none -o StrictHostKeyChecking=no' --out-format='<<CHANGED>>%i %n%L' \"/root/hello\" \"root@121.42.141.231:/tmp/\"",
"msg": "<f+++++++++ hello\n",
"rc": 0,
"stdout_lines": [
"<f+++++++++ hello"
]
}
[root@soso ~]# ls /tmp/hello
/tmp/hello

8、cron

cron 模块，用于管理计划任务
用法：

backup # 在对远程主机上的原计划任务修改之前做备份（也就是先备份再修改）
cron_file # 如果指定该选项，则用该文件替换远程主机上的cron.d目录下的用户的任务计划
day # 天（1-31，*，*/2, ……）
hour # 小时( 0-23, *, */2, ……）
job # T要执行的任务，依赖于state=present
minute # 分钟（0-59，*，*/2，……）
month # 月（1-12，*，*/2，……）
name # 该任务的描述
reboot # If the job should be run at reboot. This option
special_time #指定什么时候执行，参数： reboot,yearly,annually,monthly,weekly,daily,hourly
state # 确认该任务计划是创建还是删除
user #以哪个用户的身份执行
weekday #周（0-7，*，……）

实例：

1、给test 主机创建一个计划任务：

[root@soso ~]#  ansible test -m cron -a "name='echo ' hour=2 user=root job='echo 1 >> /root/hello' "
192.168.1.2 | success >> {
"changed": true,
"jobs": [
"echo "
]
}
[root@soso ~]# ansible test -m shell -a "crontab -l"
192.168.1.2 | success | rc=0 >>
* * * * 1 sh /root/shell/apache_log.sh
#Ansible: echo
* 2 * * * echo 1 >> /root/hello

2、删除刚才创建的计划任务

[root@soso ~]#  ansible test -m cron -a "name='echo' hour=2 user=root job='echo 1 >> /root/hello' state=absent"
192.168.1.2 | success >> {
"changed": true,
"jobs": []
}

[root@soso ~]# ansible test -m shell -a "crontab -l"                                     192.168.1.2 | success | rc=0 >>
* * * * 1 sh /root/shell/apache_log.sh

9、service
service 模块作用于一些服务，比如对某些服务器的启动、重启、停止、重载等的管理
arguments # 给命令行提供一些选项
enabled # 是否开机启动 yes|no
name= # 必选项，服务名称
pattern # 定义一个模式，如果通过status指令来查看服务的状态时，没有响应，就会通过ps指令在进程中根据该模式进行查找，如果匹配到，则认为该服务依然在运行
runlevel # 运行级别
sleep # 如果执行了restarted，在则stop和start之间沉睡几秒钟
state # 对当前服务执行启动，停止、重启、重新加载等操作 （started,stopped,restarted,reloaded）
实例：
实例：远程启动http

[root@soso ~]# ss -nl
State      Recv-Q Send-Q        Local Address:Port          Peer Address:Port
LISTEN     0      80                        *:3306                     *:*
LISTEN     0      128                       *:111                      *:*
LISTEN     0      128                       *:22                       *:*
LISTEN     0      128                       *:43131                    *:*
[root@soso ~]# ansible test -m service -a "name=httpd state=started enabled=yes"
192.168.1.2 | success >> {
"changed": true,
"enabled": true,
"name": "httpd",
"state": "started"
}
[root@soso ~]# ss -nl
State      Recv-Q Send-Q        Local Address:Port          Peer Address:Port
LISTEN     0      80                        *:3306                     *:*
LISTEN     0      128                       *:111                      *:*
LISTEN     0      128                       *:80                       *:*
LISTEN     0      128                       *:22                       *:*
LISTEN     0      128                       *:43131                    *:*

其他常用的模块还有 yum user filesystem mount