Chef配置出错怎么排查

Chef 配置（通常指 Chef Infra，包括 Chef Client、Chef Server、Policy/Role/Cookbook 等）出错时，排查一般遵循**“看日志 → 定位阶段 → 缩小范围 → 验证修改”**的思路。下面按常见场景给你一套排查方法。

一、先看日志（最重要）

1. Chef Client 本地日志

在节点上运行：

chef-client -l debug

或查看已有日志：

cat /var/log/chef/client.log

重点关注：

• ERROR / FATAL
• Recipe Compile Error（编译阶段）
• Converge Error（执行阶段）

2. Chef Server 日志（如果是 Server 问题）

# Chef Server
sudo journalctl -u chef-server
# 或
/var/log/opscode/

二、判断出错阶段

✅ 阶段 1：编译阶段（Compile）

错误示例：

• NoMethodError
• undefined method
• Cookbook not found
• SyntaxError

常见原因：

• Ruby 语法错误
• 变量未定义
• include_recipe 写错
• cookbook 名称拼写错误

排查：

# 本地语法检查
foodcritic cookbooks/your_cookbook
cookstyle cookbooks/your_cookbook

✅ 阶段 2：收敛阶段（Converge）

错误示例：

• Resource failed
• Permission denied
• Timeout

常见原因：

• 文件权限问题
• 服务未启动
• 网络不通
• 模板变量为空

排查：

chef-client --why-run

（Dry run，不真正改系统）

三、常见错误 & 对应排查点

1️⃣ Cookbook 找不到

Cookbook 'xxx' not found

检查：

• metadata.rb 是否声明
• Berksfile / Policyfile 是否包含
• 是否上传到 Server：

knife cookbook upload xxx

2️⃣ 模板报错

undefined method `[]' for nil

检查：

• attributes/default.rb
• node['xxx']['key'] 是否存在
• role / environment 是否覆盖

3️⃣ 节点连不上 Chef Server

Error connecting to https://chef.example.com

检查：

• client.pem 是否存在
• 时间是否同步（NTP）
• 防火墙 / 代理
• /etc/chef/client.rb

4️⃣ 权限问题

Permission denied @ dir_s_mkdir

检查：

• 运行 chef-client 的用户
• 目录 owner
• mode / owner 资源设置

四、用 Why-Run 和 Debug 快速定位

chef-client --why-run -l info

或只跑某个 recipe：

chef-client -o recipe[your_cookbook::debug]

五、结构化排查清单 ✅

• [ ] 日志中错误阶段（compile / converge）
• [ ] cookbook 是否上传
• [ ] 属性是否定义
• [ ] 语法是否通过 cookstyle
• [ ] 网络 / 证书是否正常
• [ ] 是否最小复现（单独 recipe）

六、如果你愿意，我可以直接帮你看

你可以贴：

1. 完整报错日志
2. 相关 recipe / resource
3. Chef 版本
4. 是 client / server / workstation 哪一端

我可以直接帮你定位到具体行和原因。