ansible常用模块

ping

ping模块用来检查目标主机是否在线
例子：ansible webserver -m ping

yum

yum模块用来在Centos系统上使用yum命令安装软件包
选项：
name: 指定安装包的名字
state：latest 安装最新版 present 默认安装 installed 安装 absent 卸载
removed 卸载
例子：ansible webservers -m yum -a ‘name=httpd state=latest’
前三个是安装，后两个是卸载

command

command模块用来执行系统命令，但是不支持shell下的特殊符号 如：| &&等
例子：ansible webservers -m command -a ‘echo 李想’

shell

shell模块和command模块使用方法基本一致，但是他可以支持shell的特殊符号，如： | && 等
例子：ansible webservers -m shell -a “cd /opt/ && touch lixiang”

service

service模块用来管理centos上的服务的启动、关闭、重启和重载
选项：
name： 服务名字
state： started(启动) stopped(停止) restarted(重启) reloaded(重载)
enabled： 默认是no，将服务设置为开机自启

file

file模块用来创建文件、目录、链接文件
选项：
group：定义文件/目录的属组
mode：定义文件/目录的权限
owner：定义文件/目录的属主
path：必选项，定义文件/目录的路径
recurse：递归的设置文件的属性，只对目录有效
src：要被链接的源文件的路径，只应用于state=link的情况
dest：被链接到的路径，只应用于state=link的情况
state：
directory：如果目录不存在，创建目录
file：即使文件不存在，也不会被创建
link：创建软链接
hard：创建硬链接
touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间
absent：删除目录、文件或者取消链接文件

user

user模块用来创建用户
选项：
home： 指定创建的家目录
groups：指定用户组
uid：指定UID
password：设置密码，密码必须是密文
Openssl passwd
name：创建的用户名字
createhome：是否创建家目录(yes/no)
state: 是创建还是删除。（present，absent），默认是创建
shell： 指定用户登录的shell环境
remove：删除用户家目录，默认为no

group

group用来创建用户组
选项
 gid：指定用的gid。
name：指定用户名。
state：是创建还是删除。（present，absent）

copy

copy模块用来复制文件至目标主机
选项：
src：文件在管理主机的据对路径或者相对路径
dest：将文件复制到目标主机的路径
backup：是否将目标主机的同名文件备份，默认为no
mode: 授权
directory_mode：递归授权
例子：
ansible webservers -m copy -a ‘src=/root/nginx.sh dest=/opt/’

unarchive

unarchive模块用来解压文件
选项：
copy：在解压文件之前，是否先将文件复制到远程主机，默认为yes。若为no，则要求目标主机上压缩包必须存在
creates：指定一个文件名，当该文件存在时，则解压指令不执行
dest：远程主机上的一个路径，即文件解压的绝对路径。
group：解压后的目录或文件的属组
mode：解压后文件的权限
src：如果copy为yes，则需要指定压缩文件的源路径
owner：解压后文件或目录的属主
例子：
ansible webservers -m unarchive -a ‘src=/root/nginx.tar.gz dest=/opt/ group=www ower=www mode=777 ’

cron模块

用于管理计划任务
backup：对远程主机上的原任务计划内容修改之前做备份
cron_file：如果指定该选项，则用该文件替换远程主机上的cron.d目录下的用户的任务计划
day：日（1-31，，/2,……）
hour：小时（0-23，，/2，……）
minute：分钟（0-59，，/2，……）
month：月（1-12，，/2，……）
weekday：周（0-7，*，……）
job：要执行的任务，依赖于state=present
name：该任务的描述
special_time：指定什么时候执行，参数： reboot,yearly,annually,monthly,weekly,daily,hourly
state：确认该任务计划是创建还是删除
user：以哪个用户的身份执行

get_url

get_url模块，该模块主要用于从http、ftp、https服务器上下载文件（类似于wget
选项：
url： 指定要下载的文件的URL地址
例子：
ansible webservers -m get_url -a ‘url= http://nginx.org/download/nginx-1.15.7.tar.gz dest=/root/’

synchronize

使用rsync同步文件，将主控方目录推送到指定节点的目录下,使用此模块需要先安装rsync
delete： 删除不存在的文件，delete=yes 使两边的内容一样（即以推送方为主），默认no
src： 要同步到目的地的源主机上的路径; 路径可以是绝对的或相对的。如果路径使用”/”来结尾，则只复制目录里的内容，如果没有使用”/”来结尾，则包含目录在内的整个内容全部复制
dest：目的地主机上将与源同步的路径; 路径可以是绝对的或相对的。
dest_port：默认目录主机上的端口 ，默认是22，走的ssh协议。
mode: push或pull，默认push，一般用于从本机向远程主机上传文件，pull 模式用于从远程主机上取文件。
rsync_opts：通过传递数组来指定其他rsync选项。

fetch

fetch模块它用于从远程机器获取文件，并将其本地存储在由主机名组织的文件树中。
选项：
src：远程系统上要获取的文件。 这必须是一个文件，而不是一个目录。 后续版本可能会支持递归提取。
dest：保存文件的目录

setup

setup 模块用于收集远程主机的一些基本信息。
选项：
filter参数：用于进行条件过滤。如果设置，仅返回匹配过滤条件的信息。
常用的过滤关键词：
ansible_all_ipv4_addresses：仅显示ipv4的信息
ansible_devices：仅显示磁盘设备信息
ansible_distribution：显示是什么系统，例：centos,suse等
ansible_distribution_major_version：显示是系统主版本
ansible_distribution_version：仅显示系统版本
ansible_machine：显示系统类型，例：32位，还是64位
ansible_eth0：仅显示eth0的信息
ansible_hostname：仅显示主机名
ansible_kernel：仅显示内核版本
ansible_lvm：显示lvm相关信息
ansible_memtotal_mb：显示系统总内存
ansible_memfree_mb：显示可用系统内存
ansible_memory_mb：详细显示内存情况
ansible_swaptotal_mb：显示总的swap内存
ansible_swapfree_mb：显示swap内存的可用内存
ansible_mounts：显示系统磁盘挂载情况
ansible_processor：显示cpu个数(具体显示每个cpu的型号)
ansible_processor_vcpus：显示cpu个数(只显示总的个数)
ansible_python_version：显示python版本
例子：
获取目标主机的ipv4地址
ansible webservers -m setup -a ‘filter=ansible_all_ipv4_addresses’