在自动化运维中，文件分发是一个高频需求场景，例如上传配置文件、分发脚本等。Ansible提供了强大的copy模块，帮助我们快速完成文件的分发任务。本文将结合实际案例，详细讲解copy模块的用法，助你在生产中得心应手。
Copy模块简介
copy 模块用于从Ansible控制节点向目标主机上传文件或目录。支持文件权限设置、内容替换等功能，是实现文件管理的利器。
复制
ansible <pattern> -m copy \
-a "src=<source_path> dest=<destination_path> [other options]"1.2.
模块参数：
<pattern>：指定要操作的主机或主机组，例如 all、webservers。-m copy：指定使用copy模块。src：源文件路径，必须是控制节点上的文件。dest：目标路径，指定文件在目标主机上的存放位置。owner：文件所有者。group：文件所属组。mode：文件权限。content：直接指定文件内容。基础用法示例
上传文件到远程主机
在控制节点的 /etc/ansible/playbooks/ 目录下，有一个 config.txt 文件需要分发到所有目标主机的 /etc/app/ 目录。
Playbook语法示例：
复制
- name:使用copy模块上传文件
hosts:test
tasks:
-name:上传配置文件到目标主机
ansible.builtin.copy:
src:/etc/ansible/playbooks/config.txt
dest:/home/config.txt
owner:root
group:root
mode:06441.2.3.4.5.6.7.8.9.10.
命令运行：
复制
ansible-playbook -i hosts copy_example.yml1.
ad-hoc语法示例：
复制
ansible test -m copy \
-a "src=/etc/ansible/playbooks/config.txt dest=/home/config.txt owner=root group=root mode=0664"1.2.
结果：
文件config.txt被成功上传到目标主机的 /etc/app/目录，权限设置为0644，并且把所有者和组设置为root。
多环境文件分发
在生产环境中，需要将不同的配置文件分发到开发、测试和生产环境。配置文件根据环境名称存储在控制节点的不同目录中：
/etc/ansible/configs/dev/config.txt/etc/ansible/configs/test/config.txt/etc/ansible/configs/prod/config.txt
动态路径分发
Playbook 示例：
复制
- name:多环境配置文件分发
hosts:all
vars:
env:"{{ inventory_hostname | regex_replace((.*)-(.*), \\2) }}"# 提取环境名
tasks:
-name:根据环境分发配置文件
ansible.builtin.copy:
src:"/etc/ansible/configs/{{ env }}/config.txt"
dest:"/etc/app/config.txt"
owner:root
group:root
mode:06441.2.3.4.5.6.7.8.9.10.11.12.
**hosts**** 文件示例：**
复制
[dev]
dev-server-01 ansible_host=192.168.1.101
[test]
test-server-01 ansible_host=192.168.1.102
[prod]
prod-server-01 ansible_host=192.168.1.1031.2.3.4.5.6.7.8.
命令运行：
复制
ansible-playbook -i hosts multi_env_copy.yml1.
结果：
每个环境的主机接收到对应的配置文件：
dev-server-01：收到 dev/config.txt。test-server-01：收到 test/config.txt。prod-server-01：收到 prod/config.txt。替换目标文件内容
在上传文件时，需要动态替换其中的占位符，例如替换为主机名或IP地址。
使用 content 参数
Playbook 示例：
复制
- name:动态生成配置文件
hosts:all
tasks:
-name:根据模板生成配置文件
ansible.builtin.copy:
dest:/etc/app/config.txt
content:|
主机名：{{ inventory_hostname }}
IP地址：{{ ansible_default_ipv4.address }}
owner:root
group:root
mode:06441.2.3.4.5.6.7.8.9.10.11.12.
命令运行：
复制
ansible-playbook -i hosts dynamic_content.yml1.
结果：
目标主机 /etc/app/config.txt 的内容如下：
复制
主机名：dev-server-01
IP地址：192.168.1.1011.2.
copy模块 vs template 模块
copy 模块虽然简单高效，但在处理动态内容时需要通过 content 参数显式定义。而 template 模块专为动态内容设计，结合Jinja2模板更灵活。
总结
copy模块是Ansible文件分发的基础工具，无论是单文件上传、多环境管理，还是动态内容生成，它都能快速满足需求。在实际运维中，根据场景选择适当的方法，搭配其他模块使用，可以大大提高自动化效率。快用copy模块在你的工作中试一试吧！
