部分ansible常用模块

模块查询命令

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'

selinux模块：管理selinux

关闭selinux：ansible all -m selinux -a 'state=disabled'