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 ’

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’