您的位置:首页 >在 RHEL 上排查 Ansible Playbook 和主机问题
发布于2026-08-13 阅读(0)
扫一扫,手机访问
This page has been deployed using Ansible.
n ```nn 保存文件并退出 `nano`(`Ctrl+X`,`Y`,`Enter`)。nn2. **修改 Playbook 以使用模板并引入错误**nn 现在,修改你的 `webserver.yml` playbook 以使用 `ansible.builtin.template` 模块。你还将引入两个新错误:一个未加引号的 Jinja2 变量和一个不正确的模板路径。nn 使用 `nano` 打开 `webserver.yml`:nn ```bashn nano webserver.ymln ```nn 将文件中的所有内容替换为以下内容。`become: true` 指令告诉 Ansible 使用管理员权限(使用 `sudo`)执行任务,这对于安装软件和将文件写入 `/var/www/html` 等系统目录是必需的。nn ```yamln ---n - name: Configure Web Servern hosts: localhostn become: truen vars:n package_name: httpdn welcome_message: "Welcome to Ansible with Jinja2"n tasks:n - name: Install httpd packagen ansible.builtin.dnf:n ## ERROR 1: Unquoted Jinja2 variablen name: { { package_name } }n state: presentnn - name: Create a test index page from templaten ansible.builtin.template:n ## ERROR 2: Incorrect template source pathn src: index.j2n dest: /var/www/html/index.htmln ```nn 保存并退出编辑器。nn3. **识别并修复 Jinja2 引号错误**nn 即使这是一个 Jinja2 问题,它也可能表现为 YAML 语法错误。运行语法检查器,看看 Ansible 如何解释它。nn ```bashn ansible-playbook --syntax-check webserver.ymln ```nn **预期输出(错误):** 你将收到一个语法错误,因为以 `{{` 开头的 YAML 值被视为特殊构造,必须用引号括起来才能被解释为字符串。nn ```plaintextn ERROR! A malformed block was encountered.nn The error appears to be in '/home/labex/project/ansible_troubleshooting/webserver.yml': line 11, column 19, but may be elsewhere in the file depending on the exact syntax problem.nn The offending line appears to be:nn ## ERROR 1: Unquoted Jinja2 variablen name: {{ package_name }}n ^ heren ```nn **解决方案:** 打开 `webserver.yml` 并将 Jinja2 变量用双引号括起来。nn ```bashn nano webserver.ymln ```nn 修改 `Install httpd package` 任务:nn ```yamln ## ... (rest of the file)n tasks:n - name: Install httpd packagen ansible.builtin.dnf:n ## FIX: Quote the Jinja2 expressionn name: "{{ package_name }}"n state: presentn ## ... (rest of the file)n ```nn 保存并退出。语法检查现在应该通过了。nn4. **识别并修复模板路径错误**nn 现在语法正确了,尝试运行 playbook。nn ```bashn ansible-playbook webserver.ymln ```nn **预期输出(错误):** Playbook 将会失败,但这次是运行时错误,而不是语法错误。错误消息清楚地表明找不到源文件 `index.j2`。nn ```plaintextn TASK [Create a test index page from template] **********************************n fatal: [localhost]: FAILED! => {"changed": false, "msg": "Could not find or access '/home/labex/project/ansible_troubleshooting/index.j2' on the Ansible Controller."}n ```nn 这是因为你的 playbook 中的 `src` 参数指向 `index.j2`,但你创建的文件名为 `index.html.j2`。nn **解决方案:** 最后一次打开 `webserver.yml` 并更正文件名。nn ```bashn nano webserver.ymln ```nn 修改 `Create a test index page from template` 任务中的 `src` 参数:nn ```yamln ## ... (rest of the file)n - name: Create a test index page from templaten ansible.builtin.template:n ## FIX: Correct template source filenamen src: index.html.j2n dest: /var/www/html/index.htmln ## ... (rest of the file)n ```nn 保存并退出编辑器。nn5. **成功运行 Playbook**nn 再次运行 playbook。它现在应该成功完成所有任务。nn ```bashn ansible-playbook webserver.ymln ```nn **预期输出(成功):**nn ```plaintextn PLAY [Configure Web Server] ****************************************************nn TASK [Gathering Facts] *********************************************************n ok: [localhost]nn TASK [Install httpd package] ***************************************************n changed: [localhost]nn TASK [Create a test index page from template] **********************************n changed: [localhost]nn PLAY RECAP *********************************************************************n localhost : ok=3 changed=2 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n ```n","need_verify":true,"has_solution":false},{"position":4,"title":"使用检查模式排查托管主机服务错误","layout":"doc-workbench-split","text":"## 使用检查模式排查托管主机服务错误nn在此步骤中,你将学习使用 Ansible 最强大的故障排除功能之一:**Check Mode**。Check mode(通过 `--check` 标志激活)允许你运行 playbook 来查看 *将* 做出哪些更改,而无需实际修改系统上的任何内容。这对于安全地测试 playbook 和诊断问题(例如不正确的服务名称)在它们引起实际问题之前非常有用。nn1. **创建管理服务的 Playbook**nn 你现在将创建一个名为 `service.yml` 的新 playbook,旨在确保 `httpd` Web 服务器服务正在运行。但是,你将故意使用不正确的服务名称来模拟一个常见错误。nn 使用 `nano` 在你的 `~/project/ansible_troubleshooting` 目录中创建 `service.yml` 文件。nn ```bashn nano service.ymln ```nn 复制并粘贴以下内容。请注意,服务名称设置为 `apache2`,这是 Apache Web 服务器在其他 Linux 发行版上的常见名称,但对于 RHEL 是不正确的。nn ```yamln ---n - name: Manage Web Server Servicen hosts: localhostn become: truen tasks:n - name: Ensure web server service is startedn ansible.builtin.service:n ## ERROR: Incorrect service name for RHELn name: apache2n state: startedn enabled: truen ```nn 保存文件并退出 `nano`(`Ctrl+X`,`Y`,`Enter`)。nn2. **使用 Check Mode 识别服务错误**nn 不要正常运行 playbook,而是以 check mode 执行它。这将阻止 Ansible 进行任何更改,但允许它检查系统状态并报告它 *将* 做什么。nn ```bashn ansible-playbook --check service.ymln ```nn **预期输出(错误):** Playbook 将会失败。错误消息将清楚地表明找不到名为 `apache2` 的服务。这立即告诉你 playbook 中的 `name` 参数是错误的。nn ```plaintextn TASK [Ensure web server service is started] ************************************n fatal: [localhost]: FAILED! => {"changed": false, "msg": "Could not find the requested service 'apache2': host"}nn PLAY RECAP *********************************************************************n localhost : ok=1 changed=0 unreachable=0 failed=1 skipped=0 rescued=0 ignored=0n ```nn3. **查找正确的服务名称**nn 要修复 playbook,你需要找到 RHEL 上 `httpd` 包的正确服务名称。一种可靠的方法是列出包安装的文件,并查找服务单元文件,该文件通常位于 `/usr/lib/systemd/system/`。nn 使用 `rpm` 命令查询 `httpd` 包:nn ```bashn rpm -ql httpd | grep systemdn ```nn **预期输出:** 此命令将列出与 `systemd` 相关的文件,包括服务文件。nn ```plaintextn /usr/lib/systemd/system/httpd.servicen /usr/lib/systemd/system/httpd@.servicen ...n ```nn 输出 `httpd.service` 表明正确的服务名称是 `httpd`。nn4. **更正 Playbook 并再次以 Check Mode 运行**nn 现在你知道了正确的服务名称,请编辑 `service.yml` 文件。nn ```bashn nano service.ymln ```nn 将服务 `name` 从 `apache2` 更改为 `httpd`。nn ```yamln ## ... (rest of the file)n - name: Ensure web server service is startedn ansible.builtin.service:n ## FIX: Correct service name for RHELn name: httpdn state: startedn enabled: truen ```nn 保存并退出编辑器。现在,再次以 check mode 运行 playbook。nn ```bashn ansible-playbook --check service.ymln ```nn **预期输出(Check Mode 下成功):** 这次,playbook 应该报告一个 `changed` 状态。在 check mode 下,`changed` 意味着“如果这是实际运行,将进行更改”。它表明你的 playbook 逻辑现在是正确的,并且 Ansible 已识别出需要启动 `httpd` 服务。nn ```plaintextn TASK [Ensure web server service is started] ************************************n changed: [localhost]nn PLAY RECAP *********************************************************************n localhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0n ```nn **注意:** 在这个特定的基于容器的实验环境中,没有运行完整的 `systemd` init 系统。虽然 check mode 可以正常工作,但 `ansible.builtin.service` 模块的正常运行可能仍然会遇到问题。这里的关键教训是使用 check mode 来验证你的 playbook 逻辑是否与系统的配置相符。n","need_verify":true,"has_solution":false},{"position":5,"title":"修正防火墙配置和主机不可达问题","layout":"doc-workbench-split","text":"## 修正防火墙配置和主机不可达问题nn在最后这个步骤中,你将解决两个关键的运行时问题:由防火墙等不正确的系统配置引起的问题,以及由 Ansible inventory 文件中的错误导致的连接问题。掌握这些将帮助你解决自动化中最常见的障碍。nn#### 第一部分:修正防火墙配置nn服务器配置中的一个常见任务是在防火墙中打开端口。如果 playbook 引用了目标系统中不存在的防火墙服务,它可能会失败。nn1. **安装和准备 `firewalld`**nn 首先,确保安装了 `firewalld` 包,因为它在 RHEL 上提供了防火墙管理服务。nn ```bashn sudo dnf install -y firewalldn ```nn 启动 `firewalld` 服务。nn ```bashn sudo systemctl start firewalldn ```nn 你还需要安装 `ansible.posix` collection,其中包含此实验中使用的 `firewalld` 模块。nn ```bashn ansible-galaxy collection install ansible.posixn ```nn **注意:** 你可能会看到关于 Ansible 版本兼容性的警告,但该 collection 在此实验中仍能正常工作。nn2. **创建带有防火墙错误的 Playbook**nn 创建一个名为 `firewall.yml` 的新 playbook,它尝试启用 `http` 服务。但是,你将故意使用不正确的服务名称 `web` 来触发错误。nn ```bashn nano firewall.ymln ```nn 将以下内容复制并粘贴到编辑器中:nn ```yamln ---n - name: Configure System Firewalln hosts: localhostn become: truen tasks:n - name: Allow web traffic through firewalln ansible.posix.firewalld:n ## ERROR: 'web' is not a standard firewalld servicen service: webn permanent: truen state: enabledn ```nn 保存并退出 `nano`(`Ctrl+X`,`Y`,`Enter`)。nn3. **运行 Playbook 并诊断失败**nn 执行 playbook。它将失败,因为 `firewalld` 不识别名为 `web` 的服务。nn ```bashn ansible-playbook firewall.ymln ```nn **预期输出(错误):** 错误消息清楚地表明 `web` 不是受支持的服务,直接指出了问题所在。nn ```plaintextn TASK [Allow web traffic through firewall] **************************************n fatal: [localhost]: FAILED! => {"changed": false, "msg": "web is not a supported service. This is what I ha ve."}nn PLAY RECAP *********************************************************************n localhost : ok=1 changed=0 unreachable=0 failed=1 skipped=0 rescued=0 ignored=0n ```nn4. **查找正确的防火墙服务名称**nn 要查找有效的、预定义的可用服务名称列表,你可以使用 `firewall-cmd` 命令行工具。nn ```bashn firewall-cmd --get-servicesn ```nn **预期输出:** 你将看到一个长长的可用服务列表。浏览列表以找到正确的 Web 流量服务,即 `http`。nn ```plaintextn RH-Satellite-6 ... ftp http https imaps ipp ipp-client ...n ```nn5. **更正 Playbook 并成功运行**nn 编辑 `firewall.yml` 并将不正确的服务名称 `web` 替换为正确的名称 `http`。nn ```bashn nano firewall.ymln ```nn 更正后的任务应如下所示:nn ```yamln ## ... (rest of the file)n - name: Allow web traffic through firewalln ansible.posix.firewalld:n ## FIX: Use the correct firewalld service namen service: httpn permanent: truen state: enabledn ```nn 保存并退出。现在,再次运行 playbook。它应该成功完成。nn ```bashn ansible-playbook firewall.ymln ```nn#### 第二部分:排查主机不可达问题nn“unreachable”错误意味着 Ansible 无法连接到 inventory 中列出的主机。这通常是由主机名中的简单拼写错误引起的。nn1. **模拟一个不可达的主机**nn 故意在你的 `inventory` 文件中引入一个拼写错误,并删除本地连接设置。这将强制 Ansible 尝试连接到拼写错误的主机名。nn ```bashn nano inventoryn ```nn 将 `localhost` 更改为 `localhossst` 并删除 `ansible_connection=local`。nn ```inin ## ERROR: Intentional typo in hostname, no local connectionn localhossstn ```nn 保存并退出编辑器。nn2. **修改 Playbook 以使用 Inventory 主机**nn 首先,你需要修改 `webserver.yml` playbook 以使用 inventory 主机而不是硬编码的 `localhost`。当 playbook 使用 `hosts: localhost` 时,Ansible 会将其视为特殊情况,并完全绕过 inventory 文件。nn ```bashn nano webserver.ymln ```nn 将 `hosts` 行从 `localhost` 更改为 `all`:nn ```yamln ---n - name: Configure Web Servern hosts: all ## Changed from 'localhost' to use inventory hostsn become: truen ## ... rest of the playbook remains the samen ```nn 保存并退出编辑器。nn3. **运行 Playbook 以触发错误**nn 现在尝试运行修改后的 playbook。它将失败,因为 inventory 包含拼写错误 `localhossst`。nn ```bashn ansible-playbook webserver.ymln ```nn **预期输出(错误):** Ansible 将会失败并报告主机为 `UNREACHABLE`。错误消息表明无法解析主机名。nn ```plaintextn PLAY [Configure Web Server] ****************************************************nn TASK [Gathering Facts] **********************************************************n fatal: [localhossst]: UNREACHABLE! => {"changed": false, "msg": "Failed to connect to the host via ssh: ssh: Could not resolve hostname localhossst: Name or service not known", "unreachable": true}nn PLAY RECAP *********************************************************************n localhossst : ok=0 changed=0 unreachable=1 failed=0 skipped=0 rescued=0 ignored=0n ```nn4. **更正 Inventory 文件**nn `UNREACHABLE` 状态是检查主机名和网络连接的提示。在这种情况下,修复方法是更正 `inventory` 文件中的拼写错误。nn ```bashn nano inventoryn ```nn 将 `localhossst` 改回 `localhost`。nn ```inin ## FIX: Corrected hostnamen localhost ansible_connection=localn ```nn 保存并退出。重新运行 `ansible-playbook webserver.yml` 现在将成功。nn5. **可选:恢复原始 Playbook**nn 如果你想将 playbook 恢复为使用 `hosts: localhost` 以便将来的实验,你可以将其改回:nn ```bashn nano webserver.ymln ```nn 将 `hosts` 行改回 `localhost`:nn ```yamln ---n - name: Configure Web Servern hosts: localhost ## Restored to originaln become: truen ## ... rest of the playbookn ```nn 保存并退出。此步骤演示了使用硬编码的 `localhost`(它会绕过 inventory)与使用 inventory 定义的主机之间的区别。n","need_verify":true,"has_solution":false},{"position":6,"title":"总结","layout":"doc-fullscreen","text":"## 总结nn在此次实验中,你通过安装 `ansible-core` 和配置日志记录来准备 Red Hat Enterprise Linux 环境以供 Ansible 使用,然后着手排查各种常见问题。你学会了诊断和解决 playbook 中的错误,例如修复不正确的 YAML 语法、缩进、Jinja2 引号和无效的模板路径。这些技能是编写有效且可靠的自动化代码的基础。nn此外,你还解决了与被管理主机环境相关的问题。你利用 Ansible 的检查模式(check mode)安全地执行预演(dry run),并在目标节点上识别潜在的服务故障,而无需进行实际更改。本次实验最后解决了连接问题,你修正了防火墙配置以解决主机不可达的问题,从而提供了一种从控制节点到被管理主机的全面的调试方法。n","need_verify":false,"has_solution":false}
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
正版软件
正版软件
正版软件
正版软件
正版软件
1
2
3
4
5
6
7
8
9