如何编写第一个 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

登录后查看全文

项目优选

收起

本项目是CANN提供的transformer类大模型算子库，实现网络在NPU上加速计算。

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

Ascend Extension for PyTorch

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

458

445

ops-math

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

本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本，由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用，3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。

CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。

openJiuwen agent-studio提供零码、低码可视化开发和工作流编排，模型、知识库、插件等各资源管理能力

华为昇腾面向大规模分布式训练的多模态大模型套件，支撑多模态生成、多模态理解。

Python

151

253

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

什么是 Chef 配方单？

环境准备与安装

创建第一个配方单

配方单语法详解

资源的基本结构

常用资源类型

配方单最佳实践

保持配方单简洁

使用变量和属性

错误处理

运行配方单

高级配方单技巧

条件执行

通知机制

常见问题与解决方案

配方单调试技巧

性能优化建议

总结

热门内容推荐

最新内容推荐

项目优选

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

什么是 Chef 配方单？

环境准备与安装

创建第一个配方单

配方单语法详解

资源的基本结构

常用资源类型

配方单最佳实践

保持配方单简洁

使用变量和属性

错误处理

运行配方单

高级配方单技巧

条件执行

通知机制

常见问题与解决方案

配方单调试技巧

性能优化建议

总结

相关内容推荐

热门内容推荐

最新内容推荐

项目优选