运维效率倍增！Ansible Copy 模块必知必会操作

运维效率倍增！Ansible Copy 模块必知必会操作

引用

CSDN

1.

https://m.blog.csdn.net/sinat_28521487/article/details/145126009

在自动化运维中，文件分发是一个高频需求场景，例如上传配置文件、分发脚本等。Ansible提供了强大的copy模块，帮助我们快速完成文件的分发任务。本文将结合实际案例，详细讲解copy模块的用法，助你在生产中得心应手。

Copy模块简介

copy模块用于从Ansible控制节点向目标主机上传文件或目录。支持文件权限设置、内容替换等功能，是实现文件管理的利器。

ansible <pattern> -m copy \
-a "src=<source_path> dest=<destination_path> [other options]"

模块参数：

• <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'

命令运行：

ansible-playbook -i hosts copy_example.yml

• ad-hoc语法示例：

ansible test -m copy \
-a "src=/etc/ansible/playbooks/config.txt dest=/home/config.txt owner=root group=root mode=0664"

结果：

文件

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'

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.103

命令运行：

ansible-playbook -i hosts multi_env_copy.yml

结果：

每个环境的主机接收到对应的配置文件：

• 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'

命令运行：

ansible-playbook -i hosts dynamic_content.yml

结果：

目标主机/etc/app/config.txt的内容如下：

主机名：dev-server-01
IP地址：192.168.1.101

copy模块 vs template模块

copy模块虽然简单高效，但在处理动态内容时需要通过content参数显式定义。而template模块专为动态内容设计，结合Jinja2模板更灵活。

总结

copy模块是Ansible文件分发的基础工具，无论是单文件上传、多环境管理，还是动态内容生成，它都能快速满足需求。在实际运维中，根据场景选择适当的方法，搭配其他模块使用，可以大大提高自动化效率。快用copy模块在你的工作中试一试吧！