Ansible常用模块-copy模块

郑全

一、概述
copy 模块的作用就是拷贝文件，它与之前介绍过的 fetch 模块类似，不过，fetch 模块是从远程主机中拉取文件到 ansible 管理主机，而 copy 模块是将 ansible 管理主机上的文件拷贝到远程主机中。

二、常用参数
src参数 ：用于指定需要copy的文件或目录。
dest参数 ：用于指定文件将被拷贝到远程主机的哪个目录中，dest为必须参数。
content参数 ：当不使用src指定拷贝的文件时，可以使用content直接指定文件内容，src与content两个参数必有其一，否则会报错。
force参数  :  当远程主机的目标路径中已经存在同名文件，并且与ansible主机中的文件内容不同时，是否强制覆盖，可选值有yes和no，默认值为yes，表示覆盖，如果设置为no，则不会执行覆盖拷贝操作，远程主机中的文件保持不变。
backup参数 :  当远程主机的目标路径中已经存在同名文件，并且与ansible主机中的文件内容不同时，是否对远程主机的文件进行备份，可选值有yes和no，当设置为yes时，会先备份远程主机中的文件，然后再将ansible主机中的文件拷贝到远程主机。
owner参数 : 指定文件拷贝到远程主机后的属主，但是远程主机上必须有对应的用户，否则会报错。
group参数 : 指定文件拷贝到远程主机后的属组，但是远程主机上必须有对应的组，否则会报错。
mode参数 : 指定文件拷贝到远程主机后的权限，如果你想将权限设置为”rw-r--r--“，则可以使用mode=0644表示，如果你想要在user对应的权限位上添加执行权限，则可以使用mode=u+x表示。

三、示例
1.将 ansible 管理主机中 /testdir/copytest 文件复制到远程主机的 /testdir 目录下。
ansible 管理主机中的文件内容为：
[root@ansible-manager ~]# cat /testdir/copytest
123
456123
执行 copy：

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/"
ansible-demo3 | FAILED! => {
    "changed": false,
    "checksum": "47ce3ac56f911ac44537d6a3802b72ceed71e152",
    "msg": "Aborting, target uses selinux but python bindings (libselinux-python) aren't installed!"
}123456
根据报错信息，ansible-demo3 主机需要安装 libselinux-python。

[root@ansible-demo3 ~]# yum install libselinux-python -y1
安装完毕后，再次执行：

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/"
ansible-demo3 | SUCCESS => {
    "changed": true,
    "checksum": "47ce3ac56f911ac44537d6a3802b72ceed71e152",
    "dest": "/testdir/copytest",
    "gid": 0,
    "group": "root",
    "md5sum": "c010aff9dc6276fdb7efefd1a2757658",
    "mode": "0644",
    "owner": "root",
    "secontext": "system_u:object_r:default_t:s0",
    "size": 8,
    "src": "/root/.ansible/tmp/ansible-tmp-1526023671.74-99930404286274/source",
    "state": "file",
    "uid": 0
}12345678910111213141516
成功执行后，看看 ansible-demo3 的 /testdir/copytest 文件：

[root@ansible-demo3 ~]# cat /testdir/copytest
123
456123
2.在远程主机的 /testdir 目录下生成文件 testfile1，testfile1 文件中有两行文本，第一行文本为  aaa，第二行为 bbb，当使用 content 指定文件内容时，dest 参数对应的值必须是一个文件，而不能是一个路径。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a 'content="aaa\nbbb\n" dest=/testdir/testfile1'
ansible-demo3 | SUCCESS => {
    "changed": true,
    "checksum": "90c206af0bfefa95541d3e724efe1dbc1ed3877f",
    "dest": "/testdir/testfile1",
    "gid": 0,
    "group": "root",
    "md5sum": "8b652b8c79f357694a04bd793f533c96",
    "mode": "0644",
    "owner": "root",
    "secontext": "unconfined_u:object_r:default_t:s0",
    "size": 8,
    "src": "/root/.ansible/tmp/ansible-tmp-1526113265.26-187047800648668/source",
    "state": "file",
    "uid": 0
}12345678910111213141516
因为 ansible-demo3 主机上面之前已经存在 /testdir/testfile1 文件，所以执行成功后返回 “changed” 为 true。
可以看到，文件内容已经改写：
执行前

[root@ansible-demo3 ~]# cat /testdir/testfile11
执行后

[root@ansible-demo3 ~]# cat /testdir/testfile1
aaa
bbb123
3.将 ansible 主机中 /testdir/copytest 文件复制到远程主机的 /testdir 目录中时，如果远程主机中已经存在 /testdir/copytest 文件，并且文件内容与 ansible 主机中的 copytest 文件的内容不一致，则不执行拷贝操作，远程主机中的 /testdir/copytest 文件内容不会被改变。
[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ force=no"
ansible-demo3 | SUCCESS => {
    "changed": false,
    "dest": "/testdir/",
    "src": "/testdir/copytest"
}123456
4.将 ansible 主机中 /testdir/copytest 文件复制到远程主机的 /testdir 目录中时，如果远程主机中已经存在 /testdir/copytest 文件，并且文件内容与 ansible 主机中的 /testdir/copytest 文件的内容不一致，会执行拷贝操作，但是在执行拷贝操作之前，会将远程主机中的原文件重命名，以作备份，然后再进行拷贝操作。
先修改 /testdir/copytest 文件

[root@ansible-manager ~]# cat /testdir/copytest
123
456
[root@ansible-manager ~]# vi /testdir/copytest
[root@ansible-manager ~]# cat /testdir/copytest
123
456
78912345678
执行 copy

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ backup=yes"
ansible-demo3 | SUCCESS => {
    "backup_file": "/testdir/copytest.20579.2018-05-12@16:31:27~",
    "changed": true,
    "checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
    "dest": "/testdir/copytest",
    "gid": 0,
    "group": "root",
    "md5sum": "a2ef74a76b2bfcfe14817a27c511759c",
    "mode": "0644",
    "owner": "root",
    "secontext": "system_u:object_r:default_t:s0",
    "size": 12,
    "src": "/root/.ansible/tmp/ansible-tmp-1526113886.45-35720740584873/source",
    "state": "file",
    "uid": 0
}1234567891011121314151617
查看 ansible-demo3 主机 /testdir 下面的文件
copytest.20579.2018-05-12@16:31:27~ 为备份的文件

[root@ansible-demo3 ~]# ls /testdir/
copytest  copytest.20579.2018-05-12@16:31:27~  test  testfile1  testfile2
[root@ansible-demo3 ~]# cat /testdir/copytest
123
456
789
[root@ansible-demo3 ~]# cat /testdir/copytest.20579.2018-05-12\@16\:31\:27~
123
456123456789
5.拷贝文件时，指定文件的属主，需要注意，远程主机上必须存在对应的用户。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ owner=ding"
ansible-demo3 | SUCCESS => {
    "changed": true,
    "checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
    "dest": "/testdir/copytest",
    "gid": 0,
    "group": "root",
    "mode": "0644",
    "owner": "ding",
    "path": "/testdir/copytest",
    "secontext": "system_u:object_r:default_t:s0",
    "size": 12,
    "state": "file",
    "uid": 1000
}123456789101112131415
可以看到，执行前后的变化

6.拷贝文件时，指定文件的属组，需要注意，远程主机上必须存在对应的组。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ group=ding"
ansible-demo3 | SUCCESS => {
    "changed": true,
    "checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
    "dest": "/testdir/copytest",
    "gid": 1000,
    "group": "ding",
    "mode": "0644",
    "owner": "ding",
    "path": "/testdir/copytest",
    "secontext": "system_u:object_r:default_t:s0",
    "size": 12,
    "state": "file",
    "uid": 1000
}123456789101112131415


7.拷贝文件时，指定文件的权限。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ mode=0640"
ansible-demo3 | SUCCESS => {
    "changed": true,
    "checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
    "dest": "/testdir/copytest",
    "gid": 1000,
    "group": "ding",
    "mode": "0640",
    "owner": "ding",
    "path": "/testdir/copytest",
    "secontext": "system_u:object_r:default_t:s0",
    "size": 12,
    "state": "file",
    "uid": 1000
}123456789101112131415