Ansible Fetch 模块

{"position":0,"title":"介绍","layout":"doc-fullscreen","text":"## 介绍nn欢迎来到 Ansible Fetch 模块实验！在本实验中，你将深入学习 Ansible Fetch 模块的使用。Fetch 模块允许你从远程机器上检索文件，并将其复制到执行 Ansible 的控制机器上。当你需要从托管主机收集特定文件或工件时，这非常有用。nn让我们开始吧！n","need_verify":false,"has_solution":false},{"position":1,"title":"获取单个文件","layout":"doc-workbench-split","text":"## 获取单个文件nn在这一步中，你将学习如何使用 Ansible 的 Fetch 模块从远程机器上获取单个文件。这将帮助你理解该模块的基本用法和语法。nn首先，完成 `/home/labex/project/fetching_a_single_file.yml` 文件。 n在文本编辑器中打开它，并将以下内容添加到 playbook 文件中：nn```yamln- name: Fetch Module Labn hosts: localhostn gather_facts: falsenn tasks:n - name: Fetch a single filen fetch:n src: /home/labex/example/example_1.txtn dest: /home/labex/project/example_1.txtn flat: truen```nn- `fetch`：这是用于从远程主机获取文件的 Ansible 模块。n- `src`：指定需要获取的远程主机上文件的路径。在本例中，路径为 `/home/labex/example/example_1.txt`。 - `dest`：指定获取的文件在本地主机上的存储路径。在本例中，路径为 `/home/labex/project/example_1.txt`。 - `flat`：此参数控制目标路径的行为。当设置为 `true` 时，确保获取的文件直接放置在目标目录中，而不会创建任何子目录。这在获取单个文件并希望保持目录结构简单时非常有用。 Ansible 中的 `fetch` 模块用于将文件从远程主机获取到本地主机。在此配置中，它用于从远程主机的 `/home/labex/example/` 目录中获取名为 "example_1.txt" 的文件，并将其存储为本地主机 `/home/labex/project/` 目录中的 "example_1.txt"。`flat: true` 参数确保获取的文件直接放置在目标目录中，而不会创建任何子目录。 然后，使用以下命令运行 playbook： ```bash ansible-playbook fetching_a_single_file.yml ``` 示例输出： ```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 [Fetch Module Lab] ************************************************** TASK [Fetch a single file] *****************************************************nchanged: [localhost]nnPLAY RECAP *********************************************************************nlocalhost : ok=1 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn最后，验证 `example_1.txt` 文件是否已从远程主机成功获取到本地。nn```bashnll /home/labex/project/example_1.txtn```nn示例输出：nn```bashn-rw-rw-r-- 1 labex labex 23 Mar 14 10:45 /home/labex/project/example_1.txtn```n","need_verify":true,"has_solution":false},{"position":2,"title":"获取多个文件","layout":"doc-workbench-split","text":"## 获取多个文件nn在这一步中，你将通过从远程机器获取多个文件来加深对 Fetch 模块的理解。这将允许你在单个任务中收集多个文件。nn首先，完成 `/home/labex/project/fetching_multiple_files.yml` 文件。 n在文本编辑器中打开它，并将以下内容添加到 playbook 文件中：nn```yamln- name: Fetch Module Labn hosts: localhostn gather_facts: falsenn tasks:n - name: Fetch multiple filesn loop:n - example_2.txtn - example_3.txtn fetch:n src: "/home/labex/example/{{ item }}"n dest: "/home/labex/project/{{ item }}"n flat: truen```nn- `loop`：此关键字用于遍历项目列表。n- `fetch`：这是用于从远程主机获取文件的 Ansible 模块。n- `src`：指定要获取的文件的源路径。`{{ item }}` 占位符会被循环中的每个项目替换，从而从 `/home/labex/example/` 目录中获取 `example_2.txt` 和 `example_3.txt`。n- `dest`：指定获取的文件在本地主机上的存储路径。同样，`{{ item }}` 占位符用于确保每个文件被放置在 `/home/labex/project/` 中的相应目录中。n- `flat`：此参数控制目标路径的行为。当设置为 `true` 时，确保获取的文件直接放置在目标目录中，而不会创建任何子目录。这在获取单个文件并希望保持目录结构简单时非常有用。nn在此配置中，它用于从本地主机的 `/home/labex/example/` 目录中获取多个文件（`example_2.txt` 和 `example_3.txt`），并将它们存储在 `/home/labex/project/` 中的相应目录中。`loop` 结构允许遍历项目列表，并为列表中的每个项目执行获取操作。nn然后，使用以下命令运行 playbook：nn```bashnansible-playbook fetching_multiple_files.ymln```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 [Fetch Module Lab] **************************************************nnTASK [Fetch multiple files] ****************************************************nchanged: [localhost] => (item=example_2.txt)nchanged: [localhost] => (item=example_3.txt)nnPLAY RECAP *********************************************************************nlocalhost : ok=1 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn最后，验证 `example_2.txt` 和 `example_3.txt` 是否已从远程主机成功获取到本地。nn```bashnll /home/labex/project/ | grep examplen```nn示例输出：nn```bashn-rw-rw-r-- 1 labex labex 23 Mar 14 10:45 example_1.txtn-rw-rw-r-- 1 labex labex 23 Mar 14 11:00 example_2.txtn-rw-rw-r-- 1 labex labex 23 Mar 14 11:00 example_3.txtn```n","need_verify":true,"has_solution":false},{"position":3,"title":"在 Fetch 模块中使用变量","layout":"doc-workbench-split","text":"## 在 Fetch 模块中使用变量nn在这一步中，你将通过引入变量来探索 Ansible Fetch 模块的更高级用法。你将根据 playbook 中定义的动态值获取文件。nn首先，完成 `/home/labex/project/using_variablesin_fetch_modules.yml` 文件。 n在文本编辑器中打开它，并将以下内容添加到 playbook 文件中：nn```yamln- name: Fetch Module Labn hosts: localhostn gather_facts: falsen vars:n file_path: "/home/labex/example/example_4.txt"n dest_path: "/home/labex/project/example_4.txt"nn tasks:n - name: Fetch files using variablesn fetch:n src: "{{ file_path }}"n dest: "{{ dest_path }}" flat: true ``` - `vars`：这一部分用于定义 playbook 中会用到的变量。 - `fetch`：这是 Ansible 中用来从远程主机获取文件的模块。 - `src`：指定要获取的文件源路径，这里通过 `file_path` 变量动态传入源文件路径。 - `dest`：指定获取到的文件在本地主机上的保存路径，这里通过 `dest_path` 变量动态传入目标文件路径。 - `flat`：这个参数决定目标路径的处理方式。设为 `true` 时，获取的文件会直接放到目标目录下，不会额外生成子目录。这在只获取单个文件、又希望目录结构保持简洁时特别实用。 在这段配置里，它的作用就是从远程主机的源文件路径（`file_path` 变量）获取文件，并将其保存到本地 Ansible 控制节点的目标文件路径（`dest_path` 变量）中。借助变量来指定路径，playbook 的灵活性和可复用性都会更强。 然后，使用以下命令运行 playbook： ```bash ansible-playbook using_variablesin_fetch_modules.yml ``` 示例输出： ```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 [Fetch Module Lab] **************************************************nnTASK [Fetch files using variables] *********************************************nchanged: [localhost]nnPLAY RECAP *********************************************************************nlocalhost : ok=1 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn接下来，验证 `example_4.txt` 文件是否已从远程主机成功获取到本地。nn```bashnll /home/labex/project/example_4.txtn```nn示例输出：nn```bashn-rw-rw-r-- 1 labex labex 23 Mar 14 11:16 /home/labex/project/example_4.txtn```nn最后，尝试使用 `-e` 选项指定 `file_path` 和 `dest_path`：nn```bashnansible-playbook using_variablesin_fetch_modules.yml -e file_path="/tmp/example_5.txt" -e dest_path="/tmp/target/example_5.txt"n```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 [Fetch Module Lab] **************************************************nnTASK [Fetch files using variables] *********************************************nchanged: [localhost]nnPLAY RECAP *********************************************************************nlocalhost : ok=1 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn验证 `example_5.txt` 文件是否已从远程主机成功获取到本地。nn```bashnll /tmp/target/example_5.txtn```nn示例输出：nn```bashn-rw-rw-r-- 1 labex labex 23 Mar 14 11:24 /tmp/target/example_5.txtn```n","need_verify":true,"has_solution":false},{"position":4,"title":"总结","layout":"doc-fullscreen","text":"## 总结nn恭喜你完成了 Ansible Fetch 模块实验！在本实验中，你学习了如何使用 Ansible 的 Fetch 模块从远程机器获取文件并将其复制到控制机器。从获取单个文件开始，你逐步掌握了获取多个文件以及使用变量实现动态文件获取的方法。nn通过完成本实验，你获得了利用 Fetch 模块从托管主机收集特定文件或工件的宝贵经验。继续探索 Ansible 及其模块，以进一步提升你的自动化能力。nn祝你自动化愉快！n","need_verify":false,"has_solution":false}