ansible常用模块

1.setup

该模块主要用于收集信息，是通过调用facts组件来实现的

ansible-doc -s setup
ansible mysql -m setup #查看mysql服务器上所有信息

查看远程主机基本信息
ansible all -m setup

2.ping

测试远程主机运行状态
ansible all  -m ping

3.file

该模块主要用于设置文件的属性，比如创建文件、创建链接文件、删除文件等

ansible-doc -s file
touch /opt/file.txt
ansible mysql -m file -a 'path=/opt/file.txt owner=test02 group=mysql mode=666'
#对test文件设置属主、属组、权限

当然，也可以创建空文件，操作相对简单
ansible mysql -m file -a 'path=/opt/abc.txt state=touch' #创建空文件
ansible mysql -m file -a 'path=/opt/abc.txt state=absent' #删除

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

远程文件链接创建
ansible  [HostGroup or IP]  -m file -a "src=/etc/resolv.conf dest=/tmp/resolv.conf state=link"

远程文件链接删除
ansible all  -m file -a "path=/tmp/resolv.conf state=absent"

4.copy

这个模块用于将文件复制到远程主机，同时支持给定内容生成文件和修改权限等

ansible-doc -s copy
ansible all -m copy -a 'src=/etc/fstab dest=/opt/fstab.bk owner=root mode=644'
#src:原文件 dest：复制后目标文件 owner：属主 mode：权限
ansible mysql -a 'ls -l /opt' #在控制主机上查看

ansible mysql -m copy -a 'content="hello world!" dest=/opt/hello.txt'
#复制文件hello.txt中写入“hello world！”
ansible mysql -a 'cat /opt/test.txt'  #在控制主机上查看

复制文件到远程主机
相关选项：
backup：在覆盖之前，将源文件备份，备份文件包含时间信息。有两个选项：yes|no
content：用于替代“src”，可以直接设定指定文件的值
dest：必选项。要将源文件复制到的远程主机的绝对路径，如果源文件是一个目录，
那么该路径也必须是个目录
directory_mode：递归设定目录的权限，默认为系统默认权限
force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，
则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes
others：所有的file模块里的选项都可以在这里使用
src：被复制到远程主机的本地文件，可以是绝对路径，也可以是相对路径。
如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用“/”来结尾，
则只复制目录里的内容，如果没有使用“/”来结尾，则包含目录在内的整个内容全部复制，
类似于rsync。

将本地文件“/root/1.txt ”复制到远程服务器
ansible all -m copy -a "src=/root/1.txt dest=/tmp/1.txt owner=root group=root mode=0644"

5.command

这个模块可以直接在远程主机上执行命令，并将结果返回本主机。注意，该命令不支持 | 管道命令

ansible [主机] [-m 模块] [-a args]
ansible-doc -l #列出所有安装模块（q退出）
ansible-doc -s yum  #列出yum模块描述信息和操作动作
ansible all -m command -a 'date'  #查询date
ansible all -a 'ls /'  #如果不加-m模块，默认运行command模块

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

ansible all -m command -a "uptime"
 #执行命令不写入history

远程文件信息查看
ansible  all  -m command -a "ls –l /tmp/1.txt"

6.shell

shell模块可以在远程主机上调用shell解释器运行命令，支持shell的各种功能，例如管道等

ansible-doc -s shell
ansible webserver -m user -a 'name=jerry'
ansible webserver -m shell -a 'echo abc123 | passwd --stdin jerry' 
#创建用户，免交互设置密码

切换到shell执行指定的指令，参数与command相同。
与command不同的是，此模块可以支持命令管道，同时还有另一个模块也具备此功能：raw

先在本地创建一个SHELL脚本
vim /tmp/test.sh
#!/bin/sh
date +%F_%H:%M:%S

chmod +x /tmp/test.sh
将创建的脚本文件分发到远程
ansible all  -m copy -a "src=/tmp/test.sh dest=/tmp/test.sh owner=root group=root mode=0755"

远程执行
ansible all  -m shell -a "/tmp/test.sh"

7.cron

该模块适用于管理cron计划任务的

创建和删除计划任务
ansible [HostGroup or IP] -m cron -a "name='....' job='.....' $time"
-m 跟模块，使用的是 cron 模块
name= 指定计划任务的名字，方便日后管理
job= 指定具体的任务
$time 指定具体的执行时间，minute分钟，hour小时，day 天，month 月份。weekday 0 或者 7 代表周末。
state= 选项用来指定 name 并删除

增加计划任务
ansible all -m cron -a "name='test cron' job='/bin/bash /tmp/test.sh' weekday=6"

删除计划任务
ansible all   -m cron -a "name='test cron' state=absent"

8.user

该模块主要是用来管理用户账号

ansible-doc -s user
ansible all -m user -a 'name=test' #创建用户

ansible mysql -m command -a 'tail /etc/passwd'
ansible mysql -m user -a 'name=test01 state=absent' #删除用户

9.yum

ansible-doc -s yum
ansible webserver -m yum -a 'name=httpd'  #安装httpd
ansible webserver -m yum -a 'name=httpd state=absent' #移除httpd

10.service

该模块用于服务程序的管理

ansible-doc -s service
ansible webserver -m service -a 'name=httpd enabled=true state=started'
#开启httpd服务 ； enabled：开机自启动
ansible webserver -m service -a 'name=httpd enabled=true state=stopped' #关闭httpd服务

ansible-doc -l 列出ansible所有的模块

ansible-doc -s MODULE_NAME 查看指定模块具体适用