运维效率倍增！Ansible Copy 模块必知必会操作-51CTO.COM

在自动化运维中，文件分发是一个高频需求场景，例如上传配置文件、分发脚本等。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:'0644'1.
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:'0644'1.
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:'0644'1.
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模块在你的工作中试一试吧！