常用模块使用

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

[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='<>%i %n%L' \"/root/hello\" \"[email protected]:/tmp/\"", 
    "msg": " 
  

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