27：对Ansible进行故障排除-1 对playbook进行故障排除

type

status

date

slug

summary

对playbook进行故障排除

1. 运行 Playbook

使用 Ansible Navigator 运行 playbook 的基本命令如下：

输出说明

在运行过程中，您将看到类似以下的输出：

在 PLAY RECAP 部分，您可以查看每个主机的任务执行结果。

2. Verbosity 选项

您可以使用不同的 -v 选项来增加输出的详细程度：

v：显示详细输出。

vv：显示输出和输入数据。

vvv：包含与受管主机连接的信息。

vvvv：提供更多执行细节，如每个远程主机上执行的脚本及用户信息。

示例命令：

3. 使用 Debug 进行调试

在 playbook 中，您可以使用 ansible.builtin.debug 模块来调试输出。例如，显示可用内存：

输出变量

您还可以显示特定变量的值：

4. 检查 Playbook 语法

在运行 playbook 之前，建议检查语法是否正确：

此命令将帮助您识别连接问题或语法错误。

5. 使用 Ansible-lint 进行最佳实践检查

您可以使用 ansible-lint 来检查 playbook 中的最佳实践：

示例输出可能包括 YAML 语法错误和风格问题：

6. Playbook 结构最佳实践

在编写 playbook 时，建议遵循以下最佳实践：

使用明确的 Play 名称：使其更易于理解。

添加注释：对每个任务进行解释，提升可读性。

有效利用垂直空白：将任务属性进行垂直组织以便于阅读。

保持一致的缩进：使用空格而非制表符，避免缩进错误。

7. 敏感信息管理

如果您担心敏感信息被记录到日志文件中，可以在 ansible-navigator 配置文件中禁用日志记录：

8. 结论

通过使用 Ansible Navigator 和遵循上述最佳实践，您可以更有效地管理和运行 Ansible playbook。无论是进行故障排除还是优化配置，这些技巧都将帮助您提高工作效率。

实验手册：Samba 服务器设置

1. 启动实验

在工作站上启动实验环境：

2. 进入实验目录

进入实验工作目录：

3. 编辑配置文件

使用 Vim 编辑 ansible.cfg 文件：

在文件中添加以下内容：

4. 运行 Samba Playbook

尝试运行 Samba Playbook，但运行失败并报错。错误原因是 random_var 变量的定义没有用双引号括起来。阅读错误消息，了解问题所在。

错误示例：

5. 确认错误日志

检查 Ansible 错误日志以确认错误：

您应该看到与上述错误消息相似的内容。

6. 修改 Playbook

编辑 samba.yml，为 random_var 的值加上双引号，修正后的 Playbook 应如下所示：

7. 语法检查

使用 --syntax-check 选项验证 Playbook 的语法：

可能的错误

如果您看到类似以下的错误消息，说明任务的缩进存在问题：

8. 删除多余空格

编辑 samba.yml，删除 Deliver samba config 任务中的多余空格。修正后的 Playbook 示例：

9. 再次进行语法检查

再次运行语法检查，确保没有其他语法错误：

10. 运行 Playbook

运行 Playbook，确保所有任务成功：

11. 调试 `install_state` 变量

确认 install_state 变量返回消息：

注意：Deliver samba config 任务仍可能出现错误，因为缺少 samba.conf.j2 文件。

12. 编辑 Playbook

修改 samba.yml，将 Deliver samba config 任务中的 src 参数更正为 samba.conf.j2。完整的文件示例如下：

13. 再次运行 Playbook

重新运行 Playbook，所有任务应成功：

14. 完成实验

在工作站计算机上，返回到 student 用户主目录，并使用 lab 命令完成本练习，以确保前面实验中的资源不会影响后续练习：

以上是完整的实验手册，包括所有步骤和必要的修改。如需进一步调整或添加其他内容，请告诉我！