ansible生产常用十大模块总结
注：-a参数后的命令用单引号，单引号，单引号；双引号有可能会出问题，特别是在user模块；
模块一：测试目标主机是否在线：ping模块
主机如果在线，则回复pong
|
1
2
3
4
5
6
7
8
9
10
|
测试主机是否在线
[root@localhost ~]
# ansible erp -m ping
192.168.10.6 | SUCCESS => {
"changed"
:
false
,
"ping"
:
"pong"
}
192.168.10.7 | SUCCESS => {
"changed"
:
false
,
"ping"
:
"pong"
}
|
模块二：command模块和shell
作用：用于在各被管理节点运行指定的命令
shell和command的区别：shell模块可以特殊字符，而command是不支持
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
显示各节点的日期
[root@localhost ~]
# ansible erp -m command -a 'date'
192.168.10.6 | SUCCESS | rc=0 >>
Tue Feb 7 09:20:35 CST 2017
192.168.10.7 | SUCCESS | rc=0 >>
Tue Feb 7 09:20:35 CST 2017
删除各节点的
/tmp/test
目录
[root@localhost ~]
# ansible erp -m command -a 'mkdir /tmp/test'
192.168.10.10 | SUCCESS | rc=0 >>
192.168.10.6 | SUCCESS | rc=0 >>
[root@localhost ~]
# ansible erp -m shell -a 'rm -rf /tmp/test'
192.168.10.6 | SUCCESS | rc=0 >>
192.168.10.10 | SUCCESS | rc=0 >>
|
模块三：user模块：管理用户的模块
模块参数详解：
name:指定用户名
password:设定用户密码，password参数需要接受md5加密后的值
state:用户状态，默认为present
present:表示添加用户
absent:表示删除用户
update_password:修改用户密码
always:新密码和旧密码不同时进行修改
on_create:为新创建的用户指定密码
createhome:创建家目录
yes:默认项，即创建用户默认是有家目录的
no:创建用户时不创建家目录
remove:
yes:删除用户家目录，需要指定此参数
no:默认项，删除用户时默认不删除用户的家目录
system:
yes:默认创建为普通用户，而非系统用户
如果不指定默认生成的选项有：
home:创建家目录
shell:创建默认的shell为/bin/bash
system:默认创建为普通用户，而非系统用户，指定是用yes
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
查看帮助
[root@localhost ~]
# ansible-doc -s user
user模块中的password是需要经过md5加密的
[root@localhost ~]
# echo 123456 | openssl passwd -1 -stdin
$1$Q0WiDLXN$agpzPdHVa6.LbdMLsUXqI/
增加一个用户
[root@localhost ~]
# ansible erp -m user -a 'name=liuwei1 system=yes password=$1$Q0WiDLXN$agpzPdHVa6.LbdMLsUXqI/ state=present'
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"comment"
:
""
,
"createhome"
:
true
,
"group"
: 496,
"home"
:
"/home/liuwei1"
,
"name"
:
"liuwei1"
,
"password"
:
"NOT_LOGGING_PASSWORD"
,
"shell"
:
"/bin/bash"
,
"state"
:
"present"
,
"system"
:
true
,
"uid"
: 496
}
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"comment"
:
""
,
"createhome"
:
true
,
"group"
: 496,
"home"
:
"/home/liuwei1"
,
"name"
:
"liuwei1"
,
"password"
:
"NOT_LOGGING_PASSWORD"
,
"shell"
:
"/bin/bash"
,
"state"
:
"present"
,
"system"
:
true
,
"uid"
: 496
}
删除一个用户
[root@localhost ~]
# ansible erp -m user -a 'name=liuwei remove=yes state=absent'
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"force"
:
false
,
"name"
:
"liuwei"
,
"remove"
:
true
,
"state"
:
"absent"
}
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"force"
:
false
,
"name"
:
"liuwei"
,
"remove"
:
true
,
"state"
:
"absent"
}
更新用户的密码
[root@localhost ~]
# echo 654321 | openssl passwd -1 -stdin
$1$pfBO1D1D$UfxpHN4OlUbT8dWLe8te7.
[root@localhost ~]
# ansible erp -m user -a 'name=liuwei1 update_password=always password=$1$pfBO1D1D$UfxpHN4OlUbT8dWLe8te7.'
192.168.10.10 | SUCCESS => {
"append"
:
false
,
"changed"
:
true
,
"comment"
:
""
,
"group"
: 496,
"home"
:
"/home/liuwei1"
,
"move_home"
:
false
,
"name"
:
"liuwei1"
,
"password"
:
"NOT_LOGGING_PASSWORD"
,
"shell"
:
"/bin/bash"
,
"state"
:
"present"
,
"uid"
: 496
}
192.168.10.6 | SUCCESS => {
"append"
:
false
,
"changed"
:
true
,
"comment"
:
""
,
"group"
: 496,
"home"
:
"/home/liuwei1"
,
"move_home"
:
false
,
"name"
:
"liuwei1"
,
"password"
:
"NOT_LOGGING_PASSWORD"
,
"shell"
:
"/bin/bash"
,
"state"
:
"present"
,
"uid"
: 496
}
|
模块四：任务计划模块：cron
获取帮助：ansibe-doc -s cron
模块参数详解：
state:
present:创建任务
absent:删除任务
backup:对远程主机上的原任务计划内容修改之前做备份
job:要执行的任务
name:该任务的描述(必须项)
user:以哪个用户的身份运行
minute：分钟（0-59，*，*/2，……），不写默认为*
hour：小时（0-23，*，*/2，……），不写默认为*
day：日（1-31，*，*/2,……），不写默认为*
month：月（1-12，*，*/2，……），不写默认为*
weekday：周（0-7，*，……），不写默认为*
|
1
2
|
每隔10分钟同步一下时间
[root@localhost ~]
#ansible web -m cron -a 'name="sync time from ntpserver" minute=*/10 job="/usr/sbin/ntpdate 3.cn.pool.ntp.org"'
|
模块五：远程复制备份模块：copy
获取帮助：ansible-doc -s copy
模块参数详解：
src:指定源文件路径，可以是相对路径，也可以是绝对路径，可以是目录(并非是必须的，可以使用content，直接生成文件内容)
dest=:指定目标文件路径，只能是绝对路径，如果src是目录，此项必须是目录
owner:指定属主
group:指定属组
mode:指定权限,可以以数字指定比如0644
content:代替src，直接往dest文件中写内容，可以引用变量，也可以直接使用inventory中的主机变量
backup:在覆盖之前将原文件备份，备份文件包含时间信息。有两个选项：yes|no
force:
yes:默认项，如果目标主机包含该文件，但内容不同，则强制覆盖
no:则只有当目标主机的目标位置不存在该文件时，才复制
directory_mode：递归的设定目录的权限，默认为系统默认权限
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
复制本地文件到远程主机并对原文件进行备份
[root@localhost tmp]
# ansible erp -m copy -a 'src=/tmp/abc.txt dest=/tmp/ backup=yes'
192.168.10.10 | SUCCESS => {
"backup_file"
:
"/tmp/abc.txt.2017-02-07@10:55:31~"
,
"changed"
:
true
,
"checksum"
:
"13520f9e1a6f0b2ca9557d85825616c3680b4edc"
,
"dest"
:
"/tmp/abc.txt"
,
"gid"
: 0,
"group"
:
"root"
,
"md5sum"
:
"baae19d280afe4e2df1799daa37bebba"
,
"mode"
:
"0644"
,
"owner"
:
"root"
,
"size"
: 18,
"src"
:
"/root/.ansible/tmp/ansible-tmp-1486436129.98-98537282809491/source"
,
"state"
:
"file"
,
"uid"
: 0
}
192.168.10.6 | SUCCESS => {
"backup_file"
:
"/tmp/abc.txt.2017-02-07@10:55:31~"
,
"changed"
:
true
,
"checksum"
:
"13520f9e1a6f0b2ca9557d85825616c3680b4edc"
,
"dest"
:
"/tmp/abc.txt"
,
"gid"
: 0,
"group"
:
"root"
,
"md5sum"
:
"baae19d280afe4e2df1799daa37bebba"
,
"mode"
:
"0644"
,
"owner"
:
"root"
,
"size"
: 18,
"src"
:
"/root/.ansible/tmp/ansible-tmp-1486436130.19-187127825454744/source"
,
"state"
:
"file"
,
"uid"
: 0
}
向远程主机的文件中写内容，会把原内容覆盖掉
[root@localhost tmp]
# ansible erp -m copy -a 'content="\nMy age is 26" dest=/tmp/abc.txt'
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"checksum"
:
"e1cbbec8927a295a767fa44e91dea6eeafa5a4f4"
,
"dest"
:
"/tmp/abc.txt"
,
"gid"
: 0,
"group"
:
"root"
,
"md5sum"
:
"55ec30ce5102aa8716b75ab5e98163a7"
,
"mode"
:
"0644"
,
"owner"
:
"root"
,
"size"
: 13,
"src"
:
"/root/.ansible/tmp/ansible-tmp-1486436336.05-254449966786008/source"
,
"state"
:
"file"
,
"uid"
: 0
}
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"checksum"
:
"e1cbbec8927a295a767fa44e91dea6eeafa5a4f4"
,
"dest"
:
"/tmp/abc.txt"
,
"gid"
: 0,
"group"
:
"root"
,
"md5sum"
:
"55ec30ce5102aa8716b75ab5e98163a7"
,
"mode"
:
"0644"
,
"owner"
:
"root"
,
"size"
: 13,
"src"
:
"/root/.ansible/tmp/ansible-tmp-1486436348.0-188270058505341/source"
,
"state"
:
"file"
,
"uid"
: 0
}
|
模块六：对远程文件管理的模块：file
获取帮助：ansible-doc -s file
模块参数详解：
owner:修改属主
group:修改属组
mode:修改权限
path=:要修改文件的路径
recurse：递归的设置文件的属性，只对目录有效
yes:表示使用递归设置
state:
touch:创建一个新的空文件
directory:创建一个新的目录，当目录存在时不会进行修改
link:创建软连接，结果src一起使用此选项才生效
hard:创建硬连接
absent:删除文件，目录，软连接
src:当state=link时，要被连接文件的源路径
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
新建一个文件
[root@localhost tmp]
# ansible erp -m file -a 'path=/tmp/liuwei.txt state=touch'
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"dest"
:
"/tmp/liuwei.txt"
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0644"
,
"owner"
:
"root"
,
"size"
: 0,
"state"
:
"file"
,
"uid"
: 0
}
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"dest"
:
"/tmp/liuwei.txt"
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0644"
,
"owner"
:
"root"
,
"size"
: 0,
"state"
:
"file"
,
"uid"
: 0
}
新建一个目录
[root@localhost tmp]
# ansible erp -m file -a 'path=/tmp/liuwei state=directory'
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0755"
,
"owner"
:
"root"
,
"path"
:
"/tmp/liuwei"
,
"size"
: 4096,
"state"
:
"directory"
,
"uid"
: 0
}
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0755"
,
"owner"
:
"root"
,
"path"
:
"/tmp/liuwei"
,
"size"
: 4096,
"state"
:
"directory"
,
"uid"
: 0
}
删除文件或者目录
[root@localhost tmp]
# ansible erp -m file -a 'path=/tmp/liuwei.txt state=absent'
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"path"
:
"/tmp/liuwei.txt"
,
"state"
:
"absent"
}
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"path"
:
"/tmp/liuwei.txt"
,
"state"
:
"absent"
}
递归设置文件的属主或者属组
[root@localhost tmp]
# ansible erp -m file -a 'path=/tmp/liuwei owner=root group=root recurse=yes'
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0755"
,
"owner"
:
"root"
,
"path"
:
"/tmp/liuwei"
,
"size"
: 4096,
"state"
:
"directory"
,
"uid"
: 0
}
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0755"
,
"owner"
:
"root"
,
"path"
:
"/tmp/liuwei"
,
"size"
: 4096,
"state"
:
"directory"
,
"uid"
: 0
}
为文件设置软连接
[root@localhost tmp]
# ansible erp -m file -a 'src=/tmp/liuwei state=link path=/tmp/liuzhengwei'
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"dest"
:
"/tmp/liuzhengwei"
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0777"
,
"owner"
:
"root"
,
"size"
: 11,
"src"
:
"/tmp/liuwei"
,
"state"
:
"link"
,
"uid"
: 0
}
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"dest"
:
"/tmp/liuzhengwei"
,
"gid"
: 0,
"group"
:
"root"
,
"mode"
:
"0777"
,
"owner"
:
"root"
,
"size"
: 11,
"src"
:
"/tmp/liuwei"
,
"state"
:
"link"
,
"uid"
: 0
}
|
模块七：在远程主机执行本地脚本：script
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
[root@localhost tmp]
# ansible erp -m script -a '/tmp/a.sh'
192.168.10.10 | SUCCESS => {
"changed"
:
true
,
"rc"
: 0,
"stderr"
:
""
,
"stdout"
:
"Tue Feb 7 11:26:41 CST 2017\r\n"
,
"stdout_lines"
: [
"Tue Feb 7 11:26:41 CST 2017"
]
}
192.168.10.6 | SUCCESS => {
"changed"
:
true
,
"rc"
: 0,
"stderr"
:
""
,
"stdout"
:
"Tue Feb 7 11:26:52 CST 2017\r\n"
,
"stdout_lines"
: [
"Tue Feb 7 11:26:52 CST 2017"
]
}
|
模块八：收集远程主机的信息：setup
收集可用的facts,收集每个节点的相关信息：架构信息，IP,时间，域名，网卡，MAC，主机名，CPU等信息。
这些收集的信息，可以作为变量。
|
1
|
[root@localhost tmp]
# ansible erp -m setup
|
模块九：安装模块：yum
模块参数详解：
name:表示要安装软件包的名字，默认最新的程序包，指明要安装的程序包，可以带上版本号
state:表示是安装还卸载
present:默认的，表示为安装
lastest:安装为最新的版本
absent：表示删除
模块十：服务模块：service
模块参数详解：
enabled:表示设置服务开机是否启动，取值为true或者false;enabled=yes
name=:表示要控制哪一个服务
state:
started:表示现在就启动此服务
stopped:表示现在关闭此服务
restarted:表示重启此服务
sleep:如果执行了restarted,在stop和start之间沉睡几秒
runlevel:定义在哪些级别可以自启动
arguments:表示向命令行传递的参数
|
1
|
[root@localhost tmp]
#ansible erp -m service -a 'enabled=on name=httpd state=started'
|
模块十一：文件编辑模块：lineinfile
模块参数详解：
path:指定要修改的配置文件
regexp:匹配要修改的内容
line:要增加或者修改的内容
state:
absent:表示删除，当匹配到时进行删除
present:表示增加，当匹配到时进行修改，当没有匹配到时在最后增加一行，默认为此项
backrefs:
no:表示如果没有匹配到，则增加line；如果匹配成功，则替换line；
yes:表示如果没有匹配到，则不变line；如果匹配成功，则替换line；
backup:
no:表示如果没有匹配到，则增加line；如果匹配成功，则替换line；不备份原文件
yes:表示如果没有匹配到，则增加line；如果匹配成功，则替换line；备份原文件
insertafter(匹配的是此行):
在匹配到的行之后添加一行
insertbefore(匹配的是此行)：
在匹配到的行之前添加一行
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
修改nginx.conf测试：
[root@nfs-server playbook]
# cat modify_nginx.yml
---
- hosts: 192.168.2.111
tasks:
- name:
"修改配置文件"
lineinfile:
dest:
"/etc/nginx/conf.d/default.conf"
regexp:
'listen 80;'
line:
' listen 8000;'
#backup: yes
backrefs:
yes
notify:
- reload nginx
handlers:
- name: reload nginx
service: name=nginx state=reloaded
|
注：经测试，当不添加backerfs: yes参数时，匹配到后也会进行替换，但当匹配到的内容不存在时，会在最后增加一行；所以当不增加backerfs参数时，要确定匹配到的内容存在；
替换存在的行：
|
1
|
#ansible oms -m lineinfile -a 'path=/etc/sudoers regexp="SYSTEM,SOFTWARE" line="STAPLES_ADMIN ALL=(ROOT) NOPASSWD:NETWORKING,LOCATE,STORAGE,DELEGATING,DRIVERS,SYSTEM,SOFTWARE,SERVICES,PROCESSES,FILE" backrefs=no'
|
匹配到的行后增加一行：
|
1
|
#ansible oms -m lineinfile -a 'dest=/etc/sudoers insertafter="Cmnd_Alias SYSTEM = /usr/sbin/reboot, /usr/sbin/halt, /usr/bin/ansible, /usr/bin/ssh" line="Cmnd_Alias FILE = /bin/mkdir,/bin/touch,/usr/bin/vim"'
|
删除匹配到的行：
|
1
|
#ansible oms -m lineinfile -a 'path=/etc/sudoers state=absent regexp="PROCESSES,FILE"'
|
