简介
copy模块用于将本地或远程机器上的文件拷贝到远程主机上。
模块参数
| 名称 |
必选 |
默认值 |
可选值 |
备注 |
| backup |
no |
no |
yes/no |
在覆盖之前将原文件备份，备份文件包含时间信息 |
| content |
no |
|
|
当用content代替src参数的时候，可以把文档的内容设置到特定的值 |
| dest |
yes |
|
|
目标绝对路径。如果src是一个目录，dest也必须是一个目录。如果dest是不存在的路径，并且如果dest以/结尾或者src是目录，则dest被创建。如果src和dest是文件，如果dest的父目录不存在，任务将失败 |
| follow |
no |
no |
yes/no |
是否遵循目的机器中的文件系统链接 |
| force |
no |
yes |
yes/no |
当内容不同于源时，将替换远程文件。设置为no，则只有在目标不存在的情况下才会传输文件 |
| group |
no |
|
|
设置文件/目录的所属组，将被馈送到chown |
| local_follow |
no |
yes |
yes/no |
是否遵循本地机器中的文件系统链接 |
| mode |
no |
|
|
设置文件权限，模式实际上是八进制数字（如0644），少了前面的零可能会有意想不到的结果。从版本1.8开始，可以将模式指定为符号模式（例如u+rwx或u=rw,g=r,o=r） |
| owner |
no |
|
|
设置文件/目录的所属用户，将被馈送到chown |
| remote_src(2.0+) |
no |
no |
yes/no |
如果yes它会从目标机上搜索src文件 |
| src |
no |
|
|
将本地路径复制到远程服务器; 可以是绝对路径或相对的。如果是一个目录，它将被递归地复制。如果路径以/结尾，则只有该目录下内容被复制到目的地，如果没有使用/来结尾，则包含目录在内的整个内容全部复制 |
| unsafe_writes |
no |
|
yes/no |
是否以不安全的方式进行，可能导致数据损坏 |
| validate |
no |
None |
|
复制前是否检验需要复制目的地的路径 |
copy模块包含如下选项：
backup：在覆盖之前将原文件备份，备份文件包含时间信息。有两个选项：yes|no
content：用于替代"src",可以直接设定指定文件的值
dest：必选项。要将源文件复制到的远程主机的绝对路径，如果源文件是一个目录，那么该路径也必须是个目录
directory_mode：递归的设定目录的权限，默认为系统默认权限match
force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes
others：所有的file模块里的选项都可以在这里使用
src：要复制到远程主机的文件在本地的地址，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用"/"来结尾，则只复制目录里的内容，如果没有使用"/"来结尾，则包含目录在内的整个内容全部复制，类似于rsync。match
follow yes/no 当拷贝的文件夹内有link存在的时候，那么拷贝过match去的也会有link
force yes/no 默认为yes,会覆盖远程的内容不一样的文件（可能文件名一样）。如果是no，就不会拷贝文件，如果远程有这个文件
group 设定一个群组拥有拷贝到远程节点的文件权限
mode 等同于chmod，参数可以为“u+rwx or u=rw,g=r,o=r”
owner 设定一个用户拥有拷贝到远程节点的文件权限
参考： https://blog.csdn.net/bruce_6/article/details/79043529