ansible-copy模块详解

简介

• 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