ansible模块
第1章 Ansible模块
1.1 Command模块
1.1.1 详解
使用ansible自带模块执行命令 如果要用 > < | & ' ' 使用shell模块
1.1.3 例如：
[root@node2 ~/.ssh]# ansible all -m command -a "ls /root/.ssh" node4 | success | rc=0 >> authorized_keys known_hosts node3 | success | rc=0 >> authorized_keys known_hosts [root@node2 ~/.ssh]#
1.1.4 相关命令如下
creates：一个文件名，当该文件存在，则该命令不执行
free_form：要执行的linux指令
chdir：在执行指令之前，先切换到该目录
removes：一个文件名，当该文件不存在，则该选项不执行
executable：切换shell来执行指令，该执行路径必须是一个绝对路径
1.2 shell模块
1.2.1 详解
执行linux命令时可以用
调用bash执行命令 类似 cat /tmp/stanley.md | awk -F'|' '{print $1,$2}' &> /tmp/stanley.txt 这些复杂命令，即使使用shell也会失败，解决办法：写到脚本时，copy到远程，执行，再把需要的结果拉回执行命令的机器（执行Ansible命令的机器往往称为：Master机或者中控机或者堡垒机）。
注意：command和shell模块的核心参数直接为命令本身；而其它模块的参数通常为“key=value”格式；
1.3 Copy模块
1.3.1 详解
复制本地文件至远程服务器，并且能够改属性等
1.3.1 例如：
l 直接复制
l 生成内容的复制
注意：这两种方法是互斥的，即src和content不能同时使用
1.33 相关选项如下：
backup：在覆盖之前，将源文件备份，备份文件包含时间信息。有两个选项：yes|no
content：用于替代“src”，可以直接设定指定文件的值
dest：必选项。要将源文件复制到的远程主机的绝对路径，如果源文件是一个目录，那么该路径也必须是个目录
directory_mode：递归设定目录的权限，默认为系统默认权限
force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes
others：所有的file模块里的选项都可以在这里使用
src：被复制到远程主机的本地文件，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用“/”来结尾，则只复制目录里的内容，如果没有使用“/”来结尾，则包含目录在内的整个内容全部复制，类似于rsync。
1.4 File模块
1.4.1 详解
设置文件属性
1.4.2 例如
-a "path=PATH state=directory" # 创建目录 [root@node2 ~]# ansible all -m file -a "path=/tmp/hehe state=directory" -a "path=PATH src=FILE state=link" #创建链接文件 [root@node2 ~]# ansible all -m file -a "path=/root/haha src=/tmp/hehe state=link" -a "path=PATH state=absent" #删除文件 [root@node2 ~]# ansible all -m file -a "path=/root/haha state=absent"
1.4.3 相关选项如下
force：需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no group：定义文件/目录的属组 mode：定义文件/目录的权限 owner：定义文件/目录的属主 path：必选项，定义文件/目录的路径 recurse：递归设置文件的属性，只对目录有效 src：被链接的源文件路径，只应用于state=link的情况 dest：被链接到的路径，只应用于state=link的情况 state： directory：如果目录不存在，就创建目录 file：即使文件不存在，也不会被创建 link：创建软链接 hard：创建硬链接 touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间 absent：删除目录、文件或者取消链接文件
1.5 fetch模块
1.5.1 详解
从远程服务器拉取文件至本机，只能fetch文件，不能fetch目录,如果拉目录，先tar/zip 再拉到本机即可
1.5.2 例如
[root@node2 ~]# ansible all -m fetch -a "src=/tmp/txt dest=/root/txt.txt"
1.6 Cron模块
1.6.1 详解
管理cron计划任务
1.6.2 例如
[root@node2 ~]# ansible all -m corn -a "minute='*/5' job='/usr/sbin/ntpdate 172.16.0.1 &> /dev/null' name='Synctime'" #每5分钟同步一下时间 [root@node2 ~]# ansible all -m corn -a "state=absent name='Synctime'" #删除上面的定时任务
1.6.3 相关命令如下
- a "": 设置管理节点生成定时任务 action: cron 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 )
1.7 yum模块
1.7.1 详解
yum安装软件，也有apt,zipper
1.7.2 例如
[root@node2 ~]# ansible all -m yum -a "name=httpd state=latest" #安装httpd包
1.7.3 相关命令如下
conf_file #设定远程yum安装时所依赖的配置文件。如配置文件没有在默认的位置。 disable_gpg_check #是否禁止GPG checking，只用于`present' or `latest'。 disablerepo #临时禁止使用yum库。 只用于安装或更新时。 enablerepo #临时使用的yum库。只用于安装或更新时。 name= #所安装的包的名称 state #present安装， latest安装最新的, absent 卸载软件。 update_cache #强制更新yum的缓存。
1.8 Server模块
1.8.1 详解
服务程序管理
1.8.2 例如
[root@node2 ~]# ansible all -m service -a "name=httpd state=restarted" #重启httpd [root@node2 ~]# ansible all -m service -a "name=httpd enabled=true" #开机启动
1.8.3 相关命令如下
arguments #命令行提供额外的参数 enabled #设置开机启动。 name= #服务名称 runlevel #开机启动的级别，一般不用指定。 sleep #在重启服务的过程中，是否等待。如在服务关闭以后等待2秒再启动。 state #started启动服务， stopped停止服务， restarted重启服务， reloaded重载配置
1.9 group模块
1.9.1 详解
组管理
1.9.2 例如and相关信息
[root@node2 ~]# ansible-doc -s group - name: 添加或删除组 action: group gid # 设置组的GID号 name= # 管理组的名称 state # 指定组状态，默认为创建，设置值为absent为删除 system # 设置值为yes，表示为创建系统组
1.10 user模块
1.10.1 详解
用户管理
1.10.1 相关信息如下
-a "" action: user 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 #指明密码的过期时间 ansible all -m user -a 'name=magedu home=/tmp/magedu/ shell=/bin/bash uid=2000 comment="test user" group=root'
1.11 ping模块
检测主机存货
1.12 Setup模块
获取指定主机facts
l #指定应用selinux的配置文件。
l state=enforcing|permissive|disabled #对应于selinux配置文件的SELINUX。
l policy=targeted|minimum|mls #对应于selinux配置文件的SELINUXTYPE
facts就是变量，内建变量 。每个主机的各种信息，cpu颗数、内存大小等。会存在facts中的某个变量中。调用后返回很多对应主机的信息，在后面的操作中可以根据不同的信息来做不同的操作。如redhat系列用yum安装，而debian系列用apt来安装软件。
1.12.1 例如
ansible node3 -m setup
1.13 selinux模块
管理selinux模块
1.13.1 例如
ansible all -m selinux -a 'state=disabled'
1.13.2 相关命令
conf #指定应用selinux的配置文件。 state=enforcing|permissive|disabled #对应于selinux配置文件的SELINUX。 policy=targeted|minimum|mls #对应于selinux配置文件的SELINUXTYPE
1.14 script模块
1.14.1 详解
发送脚本到各被管理节点，并执行;不需要参数
1.14.2 例如
ansible all -m script -a 'test.sh' #直接在-a 后面指定脚本即可
