Ansible Copy 模块

{"position":0,"title":"介绍","layout":"doc-fullscreen","text":"## 介绍nn在本实验中，你将探索 Ansible 的 Copy 模块，该模块允许你将文件和目录复制到远程主机。Copy 模块提供了一种灵活且高效的方式，作为 Ansible 自动化任务的一部分来传输文件。n","need_verify":false,"has_solution":false},{"position":1,"title":"将文件复制到远程主机","layout":"doc-workbench-split","text":"## 将文件复制到远程主机nn在这一步骤中，你将使用 Ansible 的 Copy 模块将文件从控制机复制到远程主机。nn首先，创建一个新的 Ansible playbook 文件，命名为 `/home/labex/project/copy-module-playbook.yaml`，并在文本编辑器中打开它。 n将以下内容添加到 playbook 文件中：nn```ymln- hosts: localhostn tasks:n - name: Copy a file to remote hostn copy:n src: /home/labex/file.txtn dest: /home/labex/project/file.txtn```nn- `copy`：使用 Ansible 的 `copy` 模块，该模块用于将文件从控制节点（本地主机）复制到远程主机。n- `src`：指定源文件路径，表示本地主机上要复制的文件路径。n- `dest`：指定目标文件路径，表示文件应复制到远程主机的哪个位置。nn通过此 playbook 任务，文件 `/home/labex/file.txt` 将被复制到远程主机的 `/home/labex/project/file.txt` 路径。Ansible 的 `copy` 模块使文件复制过程更加高效。nn接下来，在 `/home/labex` 目录下创建一个名为 `file.txt` 的文件。nn```bashnecho "This is the content of the file." > /home/labex/file.txtn```nn然后，使用以下命令运行 playbook：nn```bashnansible-playbook copy-module-playbook.yamln```nn示例输出：nn```bashn[WARNING]: No inventory was parsed, only implicit localhost is a vailablen[WARNING]: provided hosts list is empty, only localhost is a vailable. Note thatnthe implicit localhost does not match 'all'nnPLAY [localhost] ***************************************************************nnTASK [Gathering Facts] *********************************************************nok: [localhost]nnTASK [Copy a file to remote host] **********************************************nchanged: [localhost]nnPLAY RECAP *********************************************************************nlocalhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn最后，验证文件 `file.txt` 是否存在于远程主机的指定目标路径中。nn```bashncat /home/labex/project/file.txtn```nn示例输出：nn```bashnThis is the content of the file.n```nn这里的 `"This is the content of the file."` 与 `/home/labex/file.txt` 文件的内容相同，这意味着 `/home/labex/file.txt` 文件已成功复制到 `/home/labex/project/file.txt`。n","need_verify":true,"has_solution":false},{"position":2,"title":"将目录复制到远程主机","layout":"doc-workbench-split","text":"## 将目录复制到远程主机nn在这一步骤中，你将使用 Ansible 的 Copy 模块将目录从控制机复制到远程主机。nn首先，修改现有的 playbook 文件，删除所有内容并添加以下内容到 playbook 文件中：nn```ymln- hosts: localhostn tasks:n - name: Copy a directory to remote hostn copy:n src: /home/labex/directoryn dest: /home/labex/project/n```nn如果 `src` 设置为目录，此 Playbook 任务会将 `/home/labex/directory` 目录复制到远程主机的 `/home/labex/project/` 路径。nn接下来，在 `/home/labex` 目录下创建一个名为 `directory` 的目录，并在 `directory` 目录中创建一个名为 `file2.txt` 的文件。nn```bashnmkdir /home/labex/directoryntouch /home/labex/directory/file2.txtn```nn然后，使用以下命令运行 playbook：nn```bashnansible-playbook copy-module-playbook.yamln```nn示例输出：nn```bashn[WARNING]: No inventory was parsed, only implicit localhost is a vailablen[WARNING]: provided hosts list is empty, only localhost is a vailable. Note thatnthe implicit localhost does not match 'all'nnPLAY [localhost] ***************************************************************nnTASK [Gathering Facts] *********************************************************nok: [localhost]nnTASK [Copy a directory to remote host] *****************************************nchanged: [localhost]nnPLAY RECAP *********************************************************************nlocalhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn最后，验证目录 `directory` 及其内容是否存在于远程主机的指定目标路径中。nn```bashntree /home/labex/projectn```nn预期输出：nn```bashn/home/labex/projectn├── copy-module-playbook.yamln├── directoryn│ └── file2.txtn└── file.txtnn1 directory, 3 filesn```nn你可以看到，`directory` 目录和 `file2.txt` 文件已成功复制到目标主机的 `/home/labex/project` 目录中。n","need_verify":true,"has_solution":false},{"position":3,"title":"保留文件属性","layout":"doc-workbench-split","text":"## 保留文件属性nn在这一步骤中，你将学习如何在使用 Ansible Copy 模块时保留文件属性，例如权限和时间戳。nn首先，修改现有的 playbook 文件，删除所有内容并添加以下内容到 playbook 文件中：nn```ymln- hosts: localhostn tasks:n - name: Preserve file attributesn copy:n src: /home/labex/file.txtn dest: /tmp/file.txtn mode: preserven```nn- `mode: preserve`：此参数在复制过程中保留源文件的模式（权限），确保目标文件保留与源文件相同的权限。nn通过此 playbook 任务，文件 `/home/labex/file.txt` 将被复制到远程主机的 `/tmp/file.txt`，同时保留文件的属性，例如权限。nn然后，使用以下命令运行 playbook：nn```bashnansible-playbook copy-module-playbook.yamln```nn示例输出：nn```bashn[WARNING]: No inventory was parsed, only implicit localhost is a vailablen[WARNING]: provided hosts list is empty, only localhost is a vailable. Note thatnthe implicit localhost does not match 'all'nnPLAY [localhost] ***************************************************************nnTASK [Gathering Facts] *********************************************************nok: [localhost]nnTASK [Preserve file attributes] ****************************最后，检查一下 `file.txt` 是否已经复制到远程主机的目标路径，同时确认文件属性也一并保留下来了。 先用 `ll` 查看 `/home/labex/file.txt` 的详细信息： ```bash ll /home/labex/file.txt ``` 示例输出： ```bash -rw-rw-r-- 1 labex labex 33 Mar 9 08:34 /home/labex/file.txt ``` 再用 `ll` 查看 `/tmp/file.txt` 的详细信息： ```bash ll /tmp/file.txt ``` 示例输出： ```bash -rw-rw-r-- 1 labex labex 33 Mar 9 09:00 /tmp/file.txt ``` 从结果可以看出，这个 Ansible playbook 在复制文件时，能够把权限模式（权限位）以及所有者信息一并保留下来。laybook 文件，删除所有内容并添加以下内容到 playbook 文件中：nn```ymln- hosts: localhostn tasks:n - name: Handle permissionsn copy:n src: /home/labex/file.txtn dest: /tmp/file1.txtn mode: "0644"n```nn- `mode`：将 `"0644"` 替换为所需的文件权限模式。有关权限模式的更多信息，请参考 [chmod](https://en.wikipedia.org/wiki/Chmod) 文档。nn通过此 playbook 任务，文件 `/home/labex/file.txt` 将被复制到远程主机的 `/tmp/file1.txt`，并设置指定的权限 `0644`。nn然后，使用以下命令运行 playbook：nn```bashnansible-playbook copy-module-playbook.yamln```nn示例输出：nn```bashn[WARNING]: No inventory was parsed, only implicit localhost is a vailablen[WARNING]: provided hosts list is empty, only localhost is a vailable. Note thatnthe implicit localhost does not match 'all'nnPLAY [localhost] ***************************************************************nnTASK [Gathering Facts] *********************************************************nok: [localhost]nnTASK [Handle permissions] ******************************************************nchanged: [localhost]nnPLAY RECAP *********************************************************************nlocalhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn最后，验证文件 `file1.txt` 是否以设置的权限复制到远程主机的指定目标路径。 n使用 `ll` 查看 `/home/labex/file.txt` 的详细信息：nn```bashnll /home/labex/file.txtn```nn示例输出：nn```bashn-rw-rw-r-- 1 labex labex 33 Mar 9 08:34 /home/labex/file.txtn```nn使用 `ll` 查看 `/tmp/file1.txt` 的详细信息：nn```bashnll /tmp/file1.txtn```nn示例输出：nn```bashn-rw-r--r-- 1 labex labex 33 Mar 9 09:11 /tmp/file1.txtn```nn此 Ansible playbook 可用于为远程主机上的文件设置特定权限，例如读取、写入和执行权限。n","need_verify":true,"has_solution":false},{"position":5,"title":"幂等复制","layout":"doc-workbench-split","text":"## 幂等复制nn在这一步骤中，你将使用 Ansible Copy 模块实现复制操作的幂等性。你将确保仅在远程主机上不存在该文件或源文件已更改时，才复制文件。nn首先，修改现有的 playbook 文件，删除所有内容并添加以下内容到 playbook 文件中：nn```ymln- hosts: localhostn tasks:n - name: Idempotent copyn copy:n src: /home/labex/file.txtn dest: /tmp/file2.txtn remote_src: yesn```nn- `remote_src: yes`：此参数指定 `src` 路径位于远程主机上，允许 Ansible 将文件从远程主机传输到另一个位置。nn通过此 playbook 任务，仅在远程主机上不存在该文件或源文件已更改时，远程主机上的 `/home/labex/file.txt` 文件才会被复制到 `/tmp/file2.txt`。nn接下来，检查 `/tmp/file2.txt` 文件是否存在。nn```bashnll /tmp/file2.txtn```nn示例输出：nn```bashnls: cannot access '/tmp/file2.txt': No such file or directoryn```nn然后，使用以下命令运行 playbook：nn```bashnansible-playbook copy-module-playbook.yamln```nn示例输出：nn```bashn[WARNING]: No inventory was parsed, only implicit localhost is a vailablen[WARNING]: provided hosts list is empty, only localhost is a vailable. Note thatnthe implicit localhost does not match 'all'nnPLAY [localhost] ***************************************************************nnTASK [Gathering Facts] *********************************************************nok: [localhost]nnTASK [Idempotent copy] *********************************************************nchanged: [localhost]nnPLAY RECAP *********************************************************************nlocalhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn最后，验证仅在远程主机上不存在该文件或源文件已更改时，文件 `file2.txt` 才会被复制到远程主机的指定目标路径。nn```bashnll /tmp/file2.txtn```nn示例输出：nn```bashn-rw-rw-r-- 1 labex labex 33 Mar 9 08:34 /tmp/file2.txtn```nn此时，再次运行 playbook。nn```bashnansi运行命令示例：ble-playbook copy-module-playbook.yaml 示例输出： ```bash [WARNING]: No inventory was parsed, only implicit localhost is a vailable [WARNING]: provided hosts list is empty, only localhost is a vailable. Note that the implicit localhost does not match 'all' PLAY [localhost] *************************************************************** TASK [Gathering Facts] ********************************************************* ok: [localhost] TASK [Idempotent copy] ********************************************************* ok: [localhost] PLAY RECAP ********************************************************************* localhost : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 ``` 这里要注意，`changed=1` 已经变成了 `changed=0`。这恰恰说明，这个 Ansible playbook 具备幂等性：只有当远程主机上还没有这个文件，或者源文件内容确实发生变化时，才会执行复制。":true,"has_solution":false},{"position":6,"title":"总结","layout":"doc-fullscreen","text":"## 总结nn恭喜！你已成功完成 Ansible Copy 模块实验。你已经学习了如何使用 Copy 模块将文件和目录复制到远程主机、保留文件属性、处理权限以及确保幂等性。nnCopy 模块是 Ansible 自动化任务中传输文件的强大工具。它提供了多种参数，可根据你的需求自定义复制操作。nn现在你已经对 Copy 模块有了深入的了解，可以在你的 Ansible playbook 中利用其功能，高效管理文件传输和基础设施中的同步。祝你使用 Ansible 愉快地进行复制操作！n","need_verify":false,"has_solution":false}