Ansible（三）模块

3213213

1.查看模块帮助
~]# man-ansible-doc（查看Ansible自带的模块文档信息）
~]# ansible-doc -l（列出支持的所有模块）
~]# ansible-doc -s MODULE_NAME（查看模块支持的配置指令）

2.使用语法
ansible <host-pattern> [-m module_name] [-a args] [options]
OPTIONS
host-pattern：对哪些主机生效，支持组名
-f：启动并发线程数，指定一批处理主机数量
-m：使用模块
-a：模块特有的参数

3.常见模块
command（命令模块，默认模块，用于在远程执行命令）




cron（任务计划）

1 2 3 4 5 6

~]# ansible websrvs -m cron -a 'minute="*/10" job="/bin/echo hello" name="test cron job" state=present' #默认state=present（安装），可省略不写 ~]# ansible websrvs -m cron -a 'minute="*/10" job="/bin/echo hello" name="test cron job" state=absent' #state=absent（移除） ~]# ansible websrvs -a 'crontab -l' #查看任务列表

user（用户账号管理）

1	~]# ansible all -m user -a 'name=user1'

group（组管理）

1 2 3

~]# ansible websrvs -m group -a 'name=mysql gid=306 system=yes' ~]# ansible websrvs -m user -a 'name=mysql uid=306 system=yes group=mysql' #定义为system用户，则shell为nologin，无需再额外指定

copy

1 2	~]# ansible all -m copy -a 'src=/etc/fstab dest=/tmp/fstab.ansible owner=root mode=640' ~]# ansible all -m copy -a 'content="Hello World\nHello China\n" dest=/tmp/test.ansible'

OPTIONS
src：本地源文件路径，支持相对路径和绝对路径，如果指定目录，则复制目录下所有文件
dest：远端目标文件路径，仅支持绝对路径
owner：属主
group：属组，不指定默认与owner一致
mode：权限
content：取代src，直接生成目标文件内容，两者不能同时使用

file（设置文件属性）

1 2	~]# ansible all -m file -a 'owner=mysql group=mysql mode=644 path=/tmp/fstab.ansible' #path：指定文件路径，可以使用name或dest来替换

1 2	~]# ansible all -m file -a 'path=/tmp/fstab.link src=/tmp/fstab.ansible state=link' #创建符号链接，指定link模式

OPTIONS
src：源文件
path：符号链接文件路径

ping（测试远程主机连通性）

1	~]# ansible all -m ping

service（指定运行状态）

1 2 3

~]# ansible websrvs -a 'service httpd status' ~]# ansible websrvs -a 'chkconfig --list httpd' ~]# ansible websrvs -m service -a 'enabled=true name=httpd state=started'

OPTIONS
enabled：true/false，定义是否开机启动
name：服务名
state：started/stoped/restarted


shell（类似command，用到管道等复杂命令建议使用）

1 2 3

~]# ansible all -m shell -a 'echo test | passwd --stdin user1' ~]# ansible all -m command -a 'echo test | passwd --stdin user1' #command命令无法传递，上述命令执行后无法设定密码

script（将本地脚本复制到远程主机，并运行，脚本仅支持相对路径）

1 2	~]# vim test.sh #编辑脚本

1 2 3

#!/bin/bash echo "hello world" > /tmp/script.ansible #脚本内容

1 2 3 4

~]# chomd +x test.sh #加入执行权限 ~]# ansible all -m script -a 'test.sh' #脚本仅支持相对路径

yum

1 2 3

~]# ansible all -m yum -a 'name=httpd' #默认安装，可不指定state=present ~]# ansible all -m yum -a 'name=httpd state=absent'

OPTIONS
name：指明安装程序包及版本，不指定版本则安装最新版本
state：present（安装）\latest（安装最新版）\absent（卸载）

setup（收集远程主机的facts）
每个被管理节点在接受并运行管理命令之前，会将自己主机相关信息，如OS版本、IP等报告给远程的ansible主机
~]# ansible all -m setup
#默认显示全部信息

崩啥卡拉卡

楼主，你好，我刚学这个，第一条测试命令
[iyunv@testserver ~]# ansible web -m command -a 'date'
192.168.100.129 | FAILED | rc=0 >>
this module requires key=value arguments (['<<INCLUDE_ANSIBLE_MODULE_ARGS>>
这是什么问题，麻烦帮我看下，我是yum安装的，做了免密码登录了