新手如何上手Chef配置

下面用新手视角给你一份「从零上手 Chef」的实用路线，不堆术语，先让你能跑起来，再逐步深入。

一、先搞清楚 Chef 是干什么的

Chef = 用代码管理服务器配置

• 你写“菜谱（Recipe）”
• Chef 把服务器变成你定义的样子（装软件、改配置、启服务）

核心概念（先记住这 4 个）：

1. Recipe：具体做什么（如装 nginx）
2. Cookbook：Recipe 的集合（一个功能一个 Cookbook）
3. Node：被管理的服务器
4. Chef Server / Workstation：
   • Workstation：你写代码的地方
   • Server：存配置、分发
   • Node：执行配置

二、新手最推荐的上手方式（别一上来就搭 Server）

✅ 方案 1：Chef Solo / chef-client local（最快）

适合：

• 学习
• 单机 / 少量机器

# 安装 chef 工作站
curl -L https://omnitruck.chef.io/install.sh | sudo bash

写第一个 Recipe：

# cookbooks/hello/recipes/default.rb
file '/tmp/hello.txt' do
  content 'Hello Chef!'
end

本地执行：

chef-client --local-mode hello/recipes/default.rb

✅ 看到 /tmp/hello.txt 生成，你就入门了

三、推荐学习顺序（很重要）

第 1 周：基础

• 资源（Resource）用法
  • package
  • service
  • file
  • template
• 写 3 个 Cookbook：
  • 装 nginx
  • 配 timezone
  • 建用户

第 2 周：结构

• Cookbook 目录结构
• attributes（变量）
• templates（配置文件）

第 3 周：进阶

• roles / environments
• data bags
• Chef Server（可选）

四、一个最小可用例子（nginx）

package 'nginx'

service 'nginx' do
  action [:enable, :start]
end

template '/etc/nginx/nginx.conf' do
  source 'nginx.conf.erb'
end

五、新手常见坑

❌ 一上来就用 Chef Server
✅ 先用 local mode

❌ 写复杂逻辑
✅ 一个 Recipe 只做一件事

❌ 手写太多 bash
✅ 多用内置 Resource

六、学习资源（精选）

• 官方：learn.chef.io（最系统）
• 书：《Chef Infrastructure Automation》
• 命令速查：

chef-client --local-mode
knife cookbook create xxx

七、你可以现在就做的下一步

告诉我：

1. 你是 Linux / macOS / Windows？
2. 想管 几台机器？
3. 主要用途（Web / 数据库 / 学习）？

我可以直接给你一套可复制的入门 Cookbook。