Ansible模块说明

常用模块

copy模块:

获取帮助:ansible-doc -s copy
模块参数详解:  
src:指定源文件路径,可以是相对路径,也可以是绝对路径,可以是目录(并非是必须的,可以使用content,直接生成文件内容)
dest:指定目标文件路径,只能是绝对路径,如果src是目录,此项必须是目录
owner:指定属主
group:指定属组
mode:指定权限,可以以数字指定比如0644
content:代替src,直接往dest文件中写内容,可以引用变量,也可以直接使用inventory中的主机变量
backup:在覆盖之前将原文件备份,备份文件包含时间信息。有两个选项:yes|no
force:
    yes:默认项,如果目标主机包含该文件,但内容不同,则强制覆盖
    no:则只有当目标主机的目标位置不存在该文件时,才复制
directory_mode:递归的设定目录的权限,默认为系统默认权限

file模块:

## 设置文件的属性
相关选项如下:
force:需要在两种情况下强制创建软链接,一种是源文件不存在,但之后会建立的情况下;另一种是目标软链接已存在,需要先取消之前的软链,然后创建新的软链,有两个选项:yes|no
group:定义文件/目录的属组
mode:定义文件/目录的权限
owner:定义文件/目录的属主
path:必选项,定义文件/目录的路径
recurse:递归设置文件的属性,只对目录有效
src:被链接的源文件路径,只应用于state=link的情况
dest:被链接到的路径,只应用于state=link的情况
state:
   directory:如果目录不存在,就创建目录
   file:即使文件不存在,也不会被创建
   link:创建软链接
   hard:创建硬链接
   touch:如果文件不存在,则会创建一个新的文件,如果文件或目录已存在,则更新其最后修改时间
   absent:删除目录、文件或者取消链接文件

## 远程文件符号链接创建
# ansible storm_cluster -m file -a "src=/etc/resolv.conf dest=/tmp/resolv.conf state=link"
## 远程文件信息查看
# ansible storm_cluster -m command -a "ls –al /tmp/resolv.conf"
## 远程文件符号链接删除
# ansible storm_cluster -m file -a "path=/tmp/resolv.conf state=absent"

文件编辑模块:lineinfile

模块参数详解:
path:指定要修改的配置文件
regexp:匹配要修改的内容
line:要增加或者修改的内容
state:
    absent:表示删除,当匹配到时进行删除
    present:表示增加,当匹配到时进行修改,当没有匹配到时在最后增加一行,默认为此项
backrefs:
    no:表示如果没有匹配到,则增加line;如果匹配成功,则替换line;
    yes:表示如果没有匹配到,则不变line;如果匹配成功,则替换line;
backup:  
    no:表示如果没有匹配到,则增加line;如果匹配成功,则替换line;不备份原文件
    yes:表示如果没有匹配到,则增加line;如果匹配成功,则替换line;备份原文件
insertafter(匹配的是此行):
    在匹配到的行之后添加一行
insertbefore(匹配的是此行):
    在匹配到的行之前添加一行

mount模块:

功能: 挂载文件系统
[root@localhost ~]# ansible 192.168.168.111 -m mount -a "path=/mnt/data src=/dev/sd0 fstype=ext3 ots=ro state=present"
注:mount已经使用path代替了原来的name参数,但是name参数还是可以使用的。

cron模块:

获取帮助:ansibe-doc -s cron

模块参数详解:

state:
    present:创建任务
    absent:删除任务
backup:对远程主机上的原任务计划内容修改之前做备份
job:要执行的任务
name:该任务的描述(必须项)
user:以哪个用户的身份运行
minute:分钟(0-59,*,*/2,……),不写默认为*
hour:小时(0-23,*,*/2,……),不写默认为*
day:日(1-31,*,*/2,……),不写默认为*
month:月(1-12,*,*/2,……),不写默认为*
weekday:周(0-7,*,……),不写默认为*

每隔10分钟同步一下时间
[root@localhost ~]#ansible web -m cron -a 'name="sync time from ntpserver" minute=*/10 job="/usr/sbin/ntpdate 3.cn.pool.ntp.org"'

group模块:

目的:在所有节点上创建一个组名为nolinux,gid为2014的组  
命令:ansible all -m group -a 'gid=2014 name=nolinux'

user模块: 模块参数详解:

name:指定用户名
password:设定用户密码,password参数需要接受md5加密后的值
state:用户状态,默认为present
    present:表示添加用户
    absent:表示删除用户
update_password:修改用户密码
    always:新密码和旧密码不同时进行修改
    on_create:为新创建的用户指定密码
createhome:创建家目录
    yes:默认项,即创建用户默认是有家目录的
    no:创建用户时不创建家目录
remove:
    yes:删除用户家目录,需要指定此参数
    no:默认项,删除用户时默认不删除用户的家目录
system:
    yes:默认创建为普通用户,而非系统用户
如果不指定默认生成的选项有:
    home:创建家目录
    shell:创建默认的shell为/bin/bash
    system:默认创建为普通用户,而非系统用户,指定是用yes
目的:在指定节点上创建一个用户名为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模块:

模块参数详解:    
name:表示要安装软件包的名字,默认最新的程序包,指明要安装的程序包,可以带上版本号
state:表示是安装还卸载
    present:默认的,表示为安装
    lastest:安装为最新的版本
    absent:表示删除

service模块:

enabled:表示设置服务开机是否启动,取值为true或者false;enabled=yes
name=:表示要控制哪一个服务
state:
    started:表示现在就启动此服务
    stopped:表示现在关闭此服务
    restarted:表示重启此服务
sleep:如果执行了restarted,在stop和start之间沉睡几秒
runlevel:定义在哪些级别可以自启动
arguments:表示向命令行传递的参数

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查询

猜你喜欢

转载自blog.csdn.net/qq_34896760/article/details/84784136