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

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

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/chef 是一个用于自动化运维的 Chef 应用程序。适合在自动化运维和配置管理中使用。特点是提供了丰富的功能、易于使用的 API 和多种平台的支持。

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

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

leetcode

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

Ascend Extension for PyTorch

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

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。

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

336

178