开始安装前，请确保您的云服务器满足以下条件：

• 运行CentOS/RHEL 7+或Ubuntu 16.04+操作系统
• 拥有root或sudo权限
• 至少2GB内存（建议4GB以上）
• 稳定的网络连接

提示： 大多数云服务商都提供符合这些条件的标准镜像。

1. 更新系统软件包

# CentOS/RHEL
sudo yum update -y

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y

2. 安装必要依赖

# CentOS/RHEL
sudo yum install -y curl wget git

# Ubuntu/Debian
sudo apt install -y curl wget git

Workstation是开发人员编写Cookbook的主要环境：

1. 下载安装包

# 最新稳定版
wget https://packages.chef.io/files/stable/chef-workstation/21.10.640/ubuntu/20.04/chef-workstation_21.10.640-1_amd64.deb

# 对于CentOS/RHEL
wget https://packages.chef.io/files/stable/chef-workstation/21.10.640/el/8/chef-workstation-21.10.640-1.el8.x86_64.rpm

2. 执行安装

# Ubuntu/Debian
sudo dpkg -i chef-workstation_*.deb

# CentOS/RHEL
sudo rpm -ivh chef-workstation-*.rpm

3. 验证安装

chef -v

应显示类似"Chef Workstation version: 21.10.640"的版本信息。

如需搭建私有Chef Server：

1. 下载安装包

wget https://packages.chef.io/files/stable/chef-server/14.1.0/el/8/chef-server-core-14.1.0-1.el8.x86_64.rpm

2. 安装与配置

sudo rpm -ivh chef-server-core-*.rpm
sudo chef-server-ctl reconfigure

3. 创建管理员账户

sudo chef-server-ctl user-create admin Admin User [email protected] 'password' --filename /etc/chef/admin.pem

在被管理节点上安装：

1. 通过curl安装

curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -P chef -v 17.5.22

2. 验证安装

chef-client --version

1. 依赖冲突

如果遇到ruby版本冲突，建议使用rvm或rbenv管理ruby环境。

2. 证书问题

SSL验证失败时可临时设置：

export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt

3. 防火墙配置

确保开放以下端口：

• 80/443 - Web UI和API
• 8989 - Bookshelf服务
• 5432 - PostgreSQL