1、 文件组装模块-assemble
assemble主要是将多份配置文件组装为一份配置文件。
参数 |
必填 |
默认 |
选项 |
说明 |
Backup |
否 |
No |
Yes/no |
是否创建备份文件,使用时间戳 |
Delimiter |
否 |
|
|
配置文件内容之间的分隔符 |
Dest |
是 |
|
|
目的文件用来连接所有的源文件 |
Follow |
否 |
No |
Yes/no |
表示文件系统的链接,如果存在,应该follow |
Group |
否 |
|
|
文件所属组,相当于chown |
Mode |
否 |
|
|
文件属性,0644,记住保留前面的0 |
Owner |
否 |
|
|
文件所属用户 |
Regexp |
否 |
|
|
组装的时候是否匹配相关的文件进行组合 |
Remote_src |
否 |
True |
True/False |
False表示src文件在本机上,True表示src在远程主机上 |
Src |
是 |
|
|
已经存在的目录文件 |
1.1 将本机上的配置文件组装发送到远程主机
[root@ansibleserver kel]# ansible pythonserver -m assemble -a "src=/root/kel/ dest=/tmp/kel.conf remote_src=False" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/tmp/kel.conf", "gid": 0, "group": "root", "md5sum": "23245453347840c2aa288bcc274bc298", "mode": "0600", "owner": "root", "size": 32, "src": "/root/.ansible/tmp/ansible-tmp-1453144282.9-4482221307096/src", "state": "file", "uid": 0 } |
在本机目录/root/kel的文件进行组装,发送到远程配置文件/tmp/kel.conf中,在此注意参数remote_src为False表示组装本机的配置文件
如果在本机目录中不存在文件,那么将会显示python代码和乱码
1.2 使用分隔符
[root@ansibleserver kel]# ansible pythonserver -m assemble -a "src=/root/kel/ dest=/tmp/kel.conf remote_src=False delimiter='####'" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/tmp/kel.conf", "gid": 0, "group": "root", "md5sum": "b46dcc49d69688a6be5bfd5b82737c0c", "mode": "0600", "owner": "root", "size": 42, "src": "/root/.ansible/tmp/ansible-tmp-1453144492.01-279709420329993/src", "state": "file", "uid": 0 } |
使用分隔符进行分割每个配置文件的内容,分隔符参数为delimiter
2、 文件复制模块-copy
copy模块是将本机中的文件复制到远程主机当中,fetch模块是将远程主机中的内容复制到本机中,如果在复制文件的过程当中需要使用变量,那么就使用template模块
参数 |
必填 |
默认 |
选项 |
说明 |
Backup |
否 |
No |
Yes/no |
是否创建备份文件,使用时间戳 |
Content |
否 |
|
|
当使用content替代src的时候,可以把文档中内容设定为特定值 |
Dest |
是 |
|
|
文件复制的目的地 |
Follow |
否 |
No |
Yes/no |
表示文件系统的链接,如果存在,应该follow |
Group |
否 |
|
|
文件所属组,相当于chown |
Mode |
否 |
|
|
文件属性,0644,记住保留前面的0 |
Owner |
否 |
|
|
文件所属用户 |
Directory_mode |
否 |
|
|
设定目录的权限,只有在新建的时候才会使用,不会影响已经存在的目录 |
Remote_src |
否 |
True |
True/False |
False表示src文件在本机上,True表示src在远程主机上 |
Src |
否 |
|
|
已经存在的目录文件 |
Force |
否 |
No |
Yes/no |
是否覆盖 |
Validate |
否 |
|
|
复制前是否需要检验复制的目的地 |
2.1 设定权限进行拷贝
[root@ansibleserver kel]# ansible pythonserver -m copy -a "src=/root/kel/1 dest=/tmp/kel owner=root group=root mode=0777" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/tmp/kel", "gid": 0, "group": "root", "md5sum": "799e373c68e4b72dd2eb7ed715cfced9", "mode": "0777", "owner": "root", "size": 4, "src": "/root/.ansible/tmp/ansible-tmp-1453145233.73-276909183600356/source", "state": "file", "uid": 0 } |
设定了文件的权限,设定mode为0777,用户和组均为root
2.2 拷贝的时候备份
[root@ansibleserver kel]# ansible pythonserver -m copy -a "src=/root/kel/1 dest=/tmp/kel owner=root group=root backup=yes" SSH password: 192.168.1.60 | success >> { "backup_file": "/tmp/kel.2016-01-18@14:34~", "changed": true, "dest": "/tmp/kel", "gid": 0, "group": "root", "md5sum": "a8cb3ba3ab8a8840e019c6b21521c483", "mode": "0777", "owner": "root", "size": 8, "src": "/root/.ansible/tmp/ansible-tmp-1453145701.59-117060156554446/source", "state": "file", "uid": 0 } |
备份的时候,只有在文件发生了变化的时候,那么会在远程主机上进行备份,而不是在本机上进行备份源文件,备份的是远程主机上被修改的文件
2.3 拷贝文件之后进行验证
[root@ansibleserver kel]# ansible pythonserver -m copy -a "src=/etc/sudoers dest=/tmp/2 validate='visudo -cf %s'" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/tmp/2", "gid": 0, "group": "root", "md5sum": "4093e52552d97099d003c645f15f9372", "mode": "0644", "owner": "root", "size": 3797, "src": "/root/.ansible/tmp/ansible-tmp-1453146150.33-246902811238377/source", "state": "file", "uid": 0 } |
拷贝之后进行验证
3、 文件拉取模块-fetch
文件拉取模块主要是将远程主机中的文件拷贝到本机中,和copy模块的作用刚刚相反,并且在保存的时候使用hostname来进行保存,当文件不存在的时候,会出现错误,除非设置了选项fail_on_missing为yes
参数 |
必填 |
默认值 |
选项 |
说明 |
Dest |
Yes |
|
|
用来存放文件的目录,例如存放目录为backup,源文件名称为/etc/profile在主机pythonserver中,那么保存为/backup/pythonserver/etc/profile |
Fail_on_missing |
No |
No |
Yes/no |
当源文件不存在的时候,标识为失败 |
Flat |
No |
|
|
允许覆盖默认行为从hostname/path到/file的,如果dest以/结尾,它将使用源文件的基础名称 |
Src |
Yes |
|
|
在远程拉取的文件,并且必须是一个file,不能是目录 |
Validate_checksum |
No |
Yes |
Yes/no |
当文件fetch之后进行md5检查 |
3.1 fetch一个文件进行保存
[root@ansibleserver ~]# ansible pythonserver -m fetch -a "src=/root/123 dest=/root" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/root/192.168.1.60/root/123", "md5sum": "31be5a34915d52fe0a433d9278e99cac", "remote_md5sum": "31be5a34915d52fe0a433d9278e99cac" } |
src表示为远程主机上需要传送的文件路径,dest表示为本机上的路径,在传送过来的文件,是按照IP地址进行分类,然后路径是源文件的路径
在拉取文件的时候,必须拉取的是文件,不能拉取文件夹
3.2 指定路径目录进行保存
[root@ansibleserver ~]# ansible pythonserver -m fetch -a "src=/root/Ssh.py dest=/root/kel/ flat=yes" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/root/kel/Ssh.py", "md5sum": "63f8a200d1d52d41f6258b41d7f8432c", "remote_md5sum": "63f8a200d1d52d41f6258b41d7f8432c" } |
在使用参数为flat的时候,如果dest的后缀名为/,那么就会保存在目录中,然后直接保存为文件名;当dest后缀不为/的时候,那么就会直接保存为kel的文件,如上例所示。
主要是在于dest是否已/结尾,从而来区分这是个目录还是路径。
4、 文件管理模块-file
主要用来设置文件、链接、目录的属性,或者移除文件、链接、目录,很多其他的模块也会包含这种作用,例如copy,assemble和template
参数 |
必填 |
默认 |
选项 |
说明 |
Follow |
No |
No |
Yes/no |
这个标识说明这是系统链接文件,如果存在,应该遵循 |
Force |
No |
No |
Yes/no |
强制创建链接在两种情况下:源文件不存在(过会会存在);目标存在但是是文件(创建链接文件替代) |
Group |
No |
|
|
文件所属用户组 |
Mode |
No |
|
|
文件所属权限 |
Owner |
No |
|
|
文件所属用户 |
Path |
Yes |
|
|
要控制文件的路径 |
Recurse |
No |
No |
Yes/no |
当文件为目录时,是否进行递归设置权限 |
Src |
No |
|
|
文件链接路径,只有状态为link的时候,才会设置,可以是绝对相对不存在的路径 |
State |
No |
File |
File/link Directory Hard/touch Absent |
如果是目录不存在,那么会创建目录;如果是文件不存在,那么不会创建文件;如果是link,那么软链接会被创建或者修改;如果是absent,那么目录下的所有文件都会被删除,如果是touch,会创建不存在的目录和文件 |
4.1 设置文件属性
[root@ansibleserver ~]# ansible pythonserver -m file -a "path=/root/123 owner=kel group=kel mode=0644" SSH password: 192.168.1.60 | success >> { "changed": true, "gid": 500, "group": "kel", "mode": "0644", "owner": "kel", "path": "/root/123", "size": 294, "state": "file", "uid": 500 } |
文件路径为path,表示文件路径,设定所属用户和所属用户组,权限为0644
[root@ansibleserver ~]# ansible pythonserver -m file -a "path=/tmp/kel/ owner=kel group=kel mode=0644 recurse=yes" SSH password: 192.168.1.60 | success >> { "changed": true, "gid": 500, "group": "kel", "mode": "0644", "owner": "kel", "path": "/tmp/kel/", "size": 4096, "state": "directory", "uid": 500 } |
文件路径为path,使用文件夹进行递归修改权限,使用的参数为recurse表示为递归
4.2 创建目录
[root@ansibleserver ~]# ansible pythonserver -m file -a "path=/tmp/kel state=directory mode=0755" SSH password: 192.168.1.60 | success >> { "changed": true, "gid": 0, "group": "root", "mode": "0755", "owner": "root", "path": "/tmp/kel", "size": 4096, "state": "directory", "uid": 0 } |
创建目录,使用的参数主要是state为directory
4.3 修改权限
[root@ansibleserver ~]# ansible pythonserver -m file -a "path=/tmp/kel mode=0444" SSH password: 192.168.1.60 | success >> { "changed": true, "gid": 0, "group": "root", "mode": "0444", "owner": "root", "path": "/tmp/kel", "size": 4096, "state": "directory", "uid": 0 } |
直接使用mode来进行修改权限
4.4 创建软连接
[root@ansibleserver tmp]# ansible pythonserver -m file -a "src=/tmp/1 dest=/tmp/2 owner=kel state=link" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/tmp/2", "gid": 0, "group": "root", "mode": "0777", "owner": "kel", "size": 6, "src": "/tmp/1", "state": "link", "uid": 500 } |
src表示已经存在的文件,dest表示创建的软连接的文件名,最后的state状态为link
5、 ini文件管理模块-ini_file
Ini_file模块主要是用来设置ini文件的格式的文件。
添加、删除、修改单独的ini格式的文件,其中主要是用来修改部分的配置信息,而不是template或者是assemble,添加失去的section。
参数 |
必填 |
默认 |
选择 |
说明 |
Backup |
No |
No |
Yes/no |
在修改之前进行备份 |
Dest |
Yes |
|
|
Ini类型文件的路径,如果不存在会创建 |
Follow |
No |
No |
Yes/no |
标识是否文件系统链接,如果存在,那么将遵循 |
Group |
No |
|
|
组名 |
Mode |
No |
|
|
权限 |
Option |
No |
|
|
如果需要修改一个值,那么可以设置,如果添加删除一个整段,那么可以忽略 |
Others |
No |
|
|
文件模块所使用的参数可以在这里使用 |
Owner |
No |
|
|
用户名 |
Section |
Yes |
|
|
在ini文件中的section名称,如果状态为present并且设置了一个值,那么会添加 |
State |
No |
Present |
Absent Present |
新增/删除 |
Value |
No |
|
|
这个值和option相关联,如果删除那么会忽略 |
5.1 添加其中的节的值
[root@ansibleserver tmp]# ansible pythonserver -m ini_file -a "dest=/tmp/kel section=kel option=kel value=kel mode=0600 backup=yes" SSH password: 192.168.1.60 | success >> { "changed": true, "dest": "/tmp/kel", "gid": 0, "group": "root", "mode": "0600", "msg": "OK", "owner": "root", "size": 29, "state": "file", "uid": 0 } |
表示在ini文件格式中添加一个值,路径为/tmp/kel,节名称为kel,字符为kel值为kel,在修改之前进行备份,ini文件格式如下:
[section]
key=value