Ansible Local Action 模块

## 介绍 欢迎来到 Ansible Local Action 模块实验！在这个实验里，会系统学习 Ansible Local Action 模块的用法。Local Action 模块可以让任务直接在执行 Ansible 的控制机器上运行。遇到需要本地执行操作的场景时，它就派上用场了，比如执行 shell 命令或者运行脚本。 让我们开始吧！ ## 在本地执行简单命令 在这一步中，将学习如何使用 Ansible Local Action 模块在控制机器上执行一个简单的命令。这样可以更直观地理解这个模块的基本用法和语法。 首先，完成 `/home/labex/project/execute_local_command.yml` 文件。 在 playbook 文件中添加以下内容： ```yaml - name: Executing a Simple Command Locally gather_facts: false hosts: localhost tasks: - name: Print a message locally local_action: module: command cmd: echo "Hello, World!" register: result - name: Debug the output debug: var: result.stdoutn```nn- `gather_facts`：指定 Ansible 是否应收集目标主机的事实信息。在这里设置为 `false`，表示不收集事实信息。n- `hosts`：指定运行 playbook 的目标主机。在这里，目标主机是 `localhost`，因此 playbook 将在本地主机上运行。n- `tasks`：这是要执行的任务列表。n- `local_action`：表示操作应在运行 Ansible 的控制机器上本地执行。n- `module`：指定用于操作的 Ansible 模块。在这里使用的是 `command` 模块。n- `cmd`：这是要执行的实际命令。在这里是 shell 命令 `echo "Hello, World!"`，它将在控制台打印消息 "Hello, World!"。n- `register`：将命令的输出注册到 `result` 变量中，以便在 playbook 中后续使用。n- `debug`：这是用于打印调试信息的 Ansible 模块。n- `var`：这是 `debug` 模块的参数，用于指定要调试的变量。在这里是 `result.stdout`，它包含上一个任务中执行的命令的标准输出。nn总结来说，这个 playbook 在控制机器上本地执行了一个简单的命令 `echo "Hello, World!"`，注册了输出，然后使用 `debug` 模块打印输出。nn接下来，显示 Ansible playbook 中命令的输出。nn```bashnansible-playbook /home/labex/project/execute_local_command.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 [Local Action Module Challenge] *******************************************nnTASK [Print a message locally] *************************************************nchanged: [localhost]nnTASK [Debug the output] ********************************************************nok: [localhost] => {n "result.stdout": "Hello, World!"n}nnPLAY RECAP *********************************************************************nlocalhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn在这里，`"result.stdout": "Hello, World!"` 是 `echo "Hello, World!"` 命令的输出。n","need_verify":true,"has_solution":false},{"position":2,"title":"使用变量替换执行命令","layout":"doc-workbench-split","text":"## 使用变量替换执行命令nn在这一步中，你将通过引入变量替换来加深对 Local Action 模块的理解。这将允许你根据 playbook 中定义的变量动态更改要执行的命令。nn首先，完成 `/home/labex/project/execute_command_with_variable_substitution.yml` 文件。 n在 playbook 文件中添加以下内容：nn```yamln- name: Executing a Command with Variable Substitutionn gather_facts: falsen hosts: localhostn vars:n message: "Hello, Ansible!"nn tasks:n - name: Print a message with variable substitutionn local_action:n module: commandn cmd: echo "{{ message }}"n register: resultnn - name: Debug the outputn debug:n var: result.stdoutn```nn- `vars`：此部分用于定义变量。在这个 playbook 中，它定义了一个名为 `message` 的变量，其值为 `"Hello, Ansible!"`。n- `local_action`：表示操作应在运行 Ansible 的控制机器上本地执行。n- `module`：指定用于操作的 Ansible 模块。在这里使用的是 `command` 模块。n- `cmd`：这是要执行的实际命令。在这里是 shell 命令 `echo "{{ message }}"`，其中 `{{ message }}` 会被替换为之前定义的 `message` 变量的值。n- `register`：将命令的输出注册到 `result` 变量中，以便在 playbook 中后续使用。n- `debug`：这是用于打印调试信息的 Ansible 模块。n- `var`：这是 `debug` 模块的参数，用于指定要调试的变量。在这里是 `result.stdout`，它包含上一个任务中执行的命令的标准输出。nn总结来说，这个 playbook 在控制机器上本地执行了命令 `echo "{{ message }}"`，其中 `{{ message }}` 被替换为 `vars` 部分中定义的 `message` 变量的值。它注册了命令的输出，然后使用 `debug` 模块打印输出。nn接下来，显示 Ansible playbook 中命令的输出。nn```bashnansible-playbook /home/labex/project/execute_command_with_variable_substitution.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 [Local Action Module Challenge] *******************************************nnTASK [Print a message with variable substitution] ******************************nchanged: [localhost]nnTASK [Debug the output] ********************************************************nok: [localhost] => {n "result.stdout": "Hello, Ansible!"n}nnPLAY RECAP *********************************************************************nlocalhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn在这里，`"result.stdout": "Hello, Ansible!"` 是 `echo "{{ message }}"` 命令的输出。n","need_verify":true,"has_solution":false},{"position":3,"title":"执行复杂的本地操作","layout":"doc-workbench-split","text":"## 执行复杂的本地操作nn在这一步中，你将探索 Ansible Local Action 模块的更复杂用法。你将在本地执行一个 shell 脚本，并向脚本传递参数。nn首先，完成 `/home/labex/project/execute_complex_local_action.yml` 文件。 在 playbook 文件中加入以下内容： ```yaml - name: Executing a Complex Local Action gather_facts: false hosts: localhost tasks: - name: Execute a shell script with arguments local_action: module: shell cmd: ./script.sh 5 7 register: result - name: Debug the output debug: var: result.stdout ``` - `local_action`：表示这项操作会在运行 Ansible 的控制机器上本地执行。 - `module`：指定要使用的 Ansible 模块。这里用的是 `shell` 模块。 - `cmd`：实际执行的 shell 命令。这里是 `./script.sh 5 7`，也就是运行名为 `script.sh` 的脚本，并传入参数 `5` 和 `7`。 - `register`：把命令输出保存到 `result` 变量中，方便后续在 playbook 里继续使用。 - `debug`：用于打印调试信息的 Ansible 模块。 - `var`：`debug` 模块的参数，用来指定要调试的变量。这里是 `result.stdout`，它包含上一条任务执行后的标准输出。 总结来说，这个 playbook 会在控制机器上本地执行一个 shell 脚本 `script.sh`，并传递了参数 `5` 和 `7`。它注册了脚本的输出，然后使用 `debug` 模块打印输出。nn> **提示：** 我们已经为你准备好了这个 shell 脚本，它位于 `/home/labex/project/` 目录下，名为 `script.sh`。该脚本的功能是计算两个参数的和。nn接下来，显示 Ansible playbook 中命令的输出。nn```bashnansible-playbook /home/labex/project/execute_complex_local_action.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 [Local Action Module Challenge] *******************************************nnTASK [Execute a shell script with arguments] ***********************************nchanged: [localhost]nnTASK [Debug the output] ********************************************************nok: [localhost] => {n "result.stdout": "The sum of 5 and 7 is 12."n}nnPLAY RECAP *********************************************************************nlocalhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n```nn在这里，`"result.stdout": "The sum of 5 and 7 is 12."` 是 `./script.sh 5 7` 脚本的输出。n","need_verify":true,"has_solution":false},{"position":4,"title":"总结","layout":"doc-fullscreen","text":"## 总结nn恭喜你完成了 Ansible Local Action 模块实验！在本实验中，你学习了如何使用 Ansible Local Action 模块在本地执行命令和脚本。从简单的命令执行开始，你逐步掌握了变量替换以及执行带参数的复杂 shell 脚本。nn通过完成本实验，你获得了利用 Local Action 模块在控制机器上执行任务的宝贵经验。继续探索 Ansible 及其模块，进一步提升你的自动化能力。nn祝你自动化愉快！n","need_verify":false,"has_solution":false}