如何编写第一个 Chef Infra 配方单：完整实例教程

2026-01-29 11:57:37作者：苗圣禹Peter

Chef Infra, a powerful automation platform that transforms infrastructure into code automating how infrastructure is configured, deployed and managed across any environment, at any scale

项目地址：https://gitcode.com/gh_mirrors/ch/chef

Chef Infra 是一款强大的自动化运维和配置管理工具，能够帮助您轻松管理服务器配置。本文将为您详细介绍如何编写第一个 Chef 配方单，让您快速掌握 Chef 自动化配置的核心技能。💪

什么是 Chef 配方单？

Chef 配方单是 Chef 配置管理的核心组件，它是一个包含 Ruby 代码的文件，用于描述如何在目标节点上配置系统。配方单文件通常位于 cookbook 的 recipes 目录中，扩展名为 .rb。

环境准备与安装

在开始编写配方单之前，您需要安装 Chef Infra 客户端。可以通过以下命令快速安装：

curl -L https://omnitruck.chef.io/install.sh | sudo bash

或者使用包管理器安装：

# Ubuntu/Debian
sudo apt-get install chef

# CentOS/RHEL  
sudo yum install chef

创建第一个配方单

让我们从一个简单的配方单开始，这个配方单将安装 Apache 服务器并启动服务：

# recipes/apache.rb
package 'apache2' do
  action :install
end

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

file '/var/www/html/index.html' do
  content '<html><body><h1>Hello Chef!</h1></body></html>'
  mode '0644'
  owner 'www-data'
  group 'www-data'
end

这个简单的配方单展示了 Chef 的核心概念：

资源：package、service、file 都是 Chef 内置资源
动作：每个资源都有一个或多个动作，如 :install、:start、:enable

配方单语法详解

资源的基本结构

每个资源都遵循相同的语法结构：

resource_type 'resource_name' do
  attribute 'value'
  action :action_name
end

常用资源类型

package 资源：管理软件包安装
service 资源：管理系统服务
file 资源：管理文件内容
template 资源：使用模板生成文件
execute 资源：执行命令

配方单最佳实践

保持配方单简洁

每个配方单应该专注于一个特定的任务。如果一个配方单变得过于复杂，考虑将其拆分为多个配方单或创建自定义资源。

使用变量和属性

# 设置默认属性
default['apache']['port'] = 80
default['apache']['document_root'] = '/var/www/html'

错误处理

在配方单中添加适当的错误处理机制，确保配置过程的可靠性。

运行配方单

创建配方单后，您可以使用以下命令运行它：

sudo chef-client -z -o recipe[apache]

高级配方单技巧

条件执行

package 'apache2' do
  action :install
  only_if { node['platform'] == 'ubuntu' }
end

通知机制

template '/etc/apache2/apache2.conf' do
  notifies :restart, 'service[apache2]'
end

常见问题与解决方案

配方单调试技巧

使用 chef-client -l debug 获取详细日志
在配方单中添加 log 资源输出调试信息

性能优化建议

避免在配方单中执行耗时操作
使用适当的缓存机制
合理组织配方单结构

总结

通过本教程，您已经学会了如何编写第一个 Chef 配方单。记住，实践是掌握 Chef 的最佳方式。不断尝试编写不同的配方单，您将很快成为 Chef 自动化配置的专家！🚀

Chef 配方单编写是自动化运维的基础技能，掌握这一技能将大大提升您的运维效率。现在就开始动手实践，创建您的第一个 Chef 配方单吧！

chef

Chef Infra, a powerful automation platform that transforms infrastructure into code automating how infrastructure is configured, deployed and managed across any environment, at any scale

项目地址：https://gitcode.com/gh_mirrors/ch/chef

登录后查看全文

项目优选

收起

Ascend Extension for PyTorch

Claude Code 的开源替代方案。连接任意大模型，编辑代码，运行命令，自动验证 — 全自动执行。用 Rust 构建，极致性能。｜ An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get Started

Rust

395

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

本项目是CANN开源社区的核心管理仓库，包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息

647

230

kernel

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统