模块查询命令
ansible-doc -l 查询全部的模块
ansible-doc -s MOD_NAME 查询具体模块的详细介绍
ansible在远程主机的操作的命令
ansible HOST -m MOD_NAME -a 'argruments'
ping 模块,不用跟任何参数探测主机是否存活
ansible all -m ping
command模块:在远程主机执行命令;不支持 | 管道命令
ansible storm_cluster -m command -a "ls –al /tmp/resolv.conf"
command模块内参数如下,也可以不带参数:
creates:一个文件名,当该文件存在,则该命令不执行
free_form:要执行的linux指令
chdir:在执行指令之前,先切换到该目录
removes:一个文件名,当该文件不存在,则该选项不执行
executable:切换shell来执行指令,该执行路径必须是一个绝对路径
查看/etc目录下的文件
ansible all -m command -a "ls chdir /etc"
copy模块:复制文件到远程主机,可以更改权限等
复制文件: -a "src= dest= "
给定内容生产文件: -a "content= dest= "
将本地的一个文件拷贝到远程主机
[root@k8s-master ~]# ansible all -m copy -a "src=/root/1.txt dest=/root/"
test | SUCCESS => {
"changed": true,
"checksum": "83b346b5c1ef6f294831595d05fed15e9d4c8b44",
"dest": "/root/1.txt",
"gid": 0,
"group": "root",
"md5sum": "6ba6333dc138ad441d3d2067e78f723e",
"mode": "0644",
"owner": "root",
"size": 28,
"src": "/root/.ansible/tmp/ansible-tmp-1496980500.32-74999453331400/source",
"state": "file",
"uid": 0
}
[root@k8s-master ~]# ansible all -m copy -a "content=hello/world dest=/root/2.txt"
test | SUCCESS => {
"changed": true,
"checksum": "dc3cbcf4d259d68cfc4e5909413fc703c62883a1",
"dest": "/root/2.txt",
"gid": 0,
"group": "root",
"md5sum": "c6be4e95a26409675447367b3e79f663",
"mode": "0644",
"owner": "root",
"size": 11,
"src": "/root/.ansible/tmp/ansible-tmp-1496980590.97-277106702234786/source",
"state": "file",
"uid": 0
}
backup:在覆盖之前,将源文件备份,备份文件包含时间信息。有两个选项:yes|no
content:用于替代“src”,可以直接设定指定文件的值
dest:必选项。要将源文件复制到的远程主机的绝对路径,如果源文件是一个目录,那么该路径也必须是个目录
directory_mode:递归设定目录的权限,默认为系统默认权限
force:如果目标主机包含该文件,但内容不同,如果设置为yes,则强制覆盖,如果为no,则只有当目标主机的目标位置不存在该文件时,才复制。默认为yes
others:所有的file模块里的选项都可以在这里使用
src:被复制到远程主机的本地文件,可以是绝对路径,也可以是相对路径。如果路径是一个目录,它将递归复制。在这种情况下,如果路径使用“/”来结尾,则只复制目录里的内容,如果没有使用“/”来结尾,则包含目录在内的整个内容全部复制,类似于rsync。
file模块:设置文件属性
创建目录: -a "path=。。。 state=directory"
创建链接文件:-a "path=。。。 src=... state=link"
删除文件:-a "path=。。。 state=absent"
force:需要在两种情况下强制创建软链接,一种是源文件不存在,但之后会建立的情况下;另一种是目标软链接已存在,需要先取消之前的软链,然后创建新的软链,有两个选项:yes|no
group:定义文件/目录的属组
mode:定义文件/目录的权限
owner:定义文件/目录的属主
path:必选项,定义文件/目录的路径
recurse:递归设置文件的属性,只对目录有效
src:被链接的源文件路径,只应用于state=link的情况
dest:被链接到的路径,只应用于state=link的情况
state:
directory:如果目录不存在,就创建目录
file:即使文件不存在,也不会被创建
link:创建软链接
hard:创建硬链接
touch:如果文件不存在,则会创建一个新的文件,如果文件或目录已存在,则更新其最后修改时间
absent:删除目录、文件或者取消链接文件
fetch模块:从远程某一个主机获取文件到本地
从远程主机test上拷贝/root/2.txt 到本地/pan/ansible目录下
ansible test -m fetch -a "dest=/pan/ansible src=/root/2.txt"
会得到文件 /pan/ansible/test/root/2.txt
cron模块:管理cron计划任务
添加每5分钟同步一次时间的定时任务,命名为panjunbai
ansible test -m cron -a "minute='*/5' job='/usr/sbin/ntpdate 0.centos.pool.ntp.org &>/dev/null' name='panjunbai'"
删除命名为panjunbai的ansible的cron定时任务
ansible test -m cron -a "name='panjunbai' state=absent"
backup= # 如果设置,创建一个crontab备份
cron_file= #如果指定, 使用这个文件cron.d,而不是单个用户crontab
day= # 日应该运行的工作( 1-31, , /2, etc )
hour= # 小时 ( 0-23, , /2, etc )
job= #指明运行的命令是什么
minute= #分钟( 0-59, , /2, etc )
month= # 月( 1-12, , /2, etc )
name= #定时任务描述
reboot # 任务在重启时运行,不建议使用,建议使用special_time
special_time # 特殊的时间范围,参数:reboot(重启时),annually(每年),monthly(每月),weekly(每周),daily(每天),hourly(每小时)
state #指定状态,prsent表示添加定时任务,也是默认设置,absent表示删除定时任务
user # 以哪个用户的身份执行
weekday # 周 ( 0-6 for Sunday-Saturday, *, etc )
yum模块:yum安装软件,也有apt,zypper
安装dns软件
ansible test -m yum -a "name=bind"
conf_file #设定远程yum安装时所依赖的配置文件。如配置文件没有在默认的位置。
disable_gpg_check #是否禁止GPG checking,只用于present' or
latest'。
disablerepo #临时禁止使用yum库。 只用于安装或更新时。
enablerepo #临时使用的yum库。只用于安装或更新时。
name= #所安装的包的名称
state #present安装, latest安装最新的, absent 卸载软件。
update_cache #强制更新yum的缓存。
service模块: 服务程序管理
启动docker
ansible test -m service -a "name=docker state=started"
将docker加入开机自启动
ansible test -m service -a "name=docker enabled=true"
arguments #命令行提供额外的参数
enabled #设置开机启动。
name= #服务名称
runlevel #开机启动的级别,一般不用指定。
sleep #在重启服务的过程中,是否等待。如在服务关闭以后等待2秒再启动。
state #started启动服务, stopped停止服务, restarted重启服务, reloaded重载配置
group模块:组管理
添加一个pan组gid为10001
ansible test -m group -a "name=pan gid=10001 " #如果存在pan组的话,将gid改为10001
删除pan组
ansible test -m group -a "name=pan state=absent "
user模块:用户管理
添加一个用户并设置密码:
ansible test -m user -a "name=panj password=123456"
comment # 用户的描述信息
createhom # 是否创建家目录
force # 在使用state=absent'是, 行为与
userdel --force'一致.
group # 指定基本组
groups # 指定附加组,如果指定为('groups=')表示删除所有组
home # 指定用户家目录
login_class #可以设置用户的登录类 FreeBSD, OpenBSD and NetBSD系统.
move_home # 如果设置为home='时, 试图将用户主目录移动到指定的目录 name= # 指定用户名 non_unique # 该选项允许改变非唯一的用户ID值 password # 指定用户密码 remove # 在使用
state=absent'时, 行为是与 `userdel --remove'一致.
shell # 指定默认shell
state #设置帐号状态,不指定为创建,指定值为absent表示删除
system # 当创建一个用户,设置这个用户是系统用户。这个设置不能更改现有用户。
uid #指定用户的uid
update_password # 更新用户密码
expires #指明密码的过期时间
setup模块:获取远程主机的facts,facts就是变量, 内建变量 。
每个主机的各种信息,cpu颗数、内存大小等。会存在facts中的某个变量中。调用后返回很多对应主机的信息,在后面的操作中可以根据不同的信息来做不同的操作。如redhat系列用yum安装,而debian系列用apt来安装软件。
script模块:发送脚本到各被管理节点,并执行。不需要参数
ansible all -m script -a 'test.sh'