Chef配置管理工具的安装步骤是什么

Chef 安装步骤总览

• 安装并初始化 Chef Server（核心服务、用户与组织、可选管理控制台）
• 安装 Chef Workstation（包含 knife、cookbook 工具链，用于编写与上传配置）
• 在目标机器安装 Chef Client 并注册为 Node（可通过 bootstrap 自动化）
• 验证连通性与基础配置分发（knife 命令、chef-client 运行）

一 安装与初始化 Chef Server

• 准备与下载
  • 选择受支持的操作系统（如 RHEL/CentOS 7/8、Ubuntu 20.04/22.04），确保主机名可解析（建议使用 FQDN），并开放必要端口（如 80/443 等）。
• 安装 Server 包
  • RHEL/CentOS：
    • 下载并安装：sudo rpm -Uvh https://packages.chef.io/files/stable/chef-server/14.14.1/el/8/chef-server-core-14.14.1-1.el8.x86_64.rpm
  • Ubuntu/Debian：
    • 使用安装脚本：curl https://omnitruck.chef.io/install.sh | sudo bash -s – -P chef-server -c stable
• 初始化与启动
  • 执行：sudo chef-server-ctl reconfigure（首次会拉起所有核心组件，耗时较长属正常）
  • 检查状态：sudo chef-server-ctl status
• 创建管理员与组织（用于后续 Workstation 认证）
  • 管理员：sudo chef-server-ctl user-create admin Admin admin@example.com ‘P@ssw0rd’ --filename /root/admin.pem
  • 组织：sudo chef-server-ctl org-create myorg “My Organization” --association_user admin --filename /root/myorg-validator.pem
• 可选 安装管理控制台（Web UI）
  • 安装：chef-server-ctl install opscode-manage --path /root
  • 重新配置：opscode-manage-ctl reconfigure && chef-server-ctl reconfigure
  • 访问：https://<server_fqdn>/ 使用管理员登录
  • 说明：控制台便于可视化管理 节点、数据包、角色、环境、RBAC 等

二 安装与配置 Chef Workstation

• 安装 Workstation（推荐）
  • Ubuntu/Debian：
    • 下载并安装：wget https://packages.chef.io/files/stable/chef-workstation/21.10.640/ubuntu/20.04/chef-workstation_21.10.640-1_amd64.deb
    • 安装：sudo dpkg -i chef-workstation_*.deb
  • RHEL/CentOS：
    • 下载并安装：sudo rpm -ivh chef-workstation-*.rpm
• 验证安装
  • chef -v（查看 Chef Workstation 版本）
  • chef-client -v（验证客户端工具链）
• 配置与连接 Server
  • 方式 A（推荐）从 Server 控制台下载 Starter Kit（内含 .chef 目录与 knife.rb），解压后即可使用 knife 与 Server 通信
  • 方式 B 手动配置 knife.rb（示例）
    • 目录：mkdir -p ~/chef-repo/.chef
    • 拷贝密钥：将 admin.pem 与 myorg-validator.pem 放入 ~/chef-repo/.chef
    • knife.rb 示例：
      • current_dir = File.dirname(FILE)
      • node_name “admin”
      • client_key “#{current_dir}/admin.pem”
      • validation_client_name “myorg-validator”
      • validation_key “#{current_dir}/myorg-validator.pem”
      • chef_server_url “https://<server_fqdn>/organizations/myorg”
      • cookbook_path [ “#{current_dir}/…/cookbooks”, “#{current_dir}/…/site-cookbooks” ]
    • 验证：knife user list、knife client list（能列出对象即连通成功）

三 安装 Chef Client 并注册为 Node

• 在目标节点安装 Client
  • Ubuntu/Debian：sudo apt-get update && sudo apt-get install chef-client
  • RHEL/CentOS：sudo yum install chef-client -y
  • 或使用 Omnitruck 脚本安装指定版本：curl -L https://omnitruck.chef.io/install.sh | sudo bash -s – -P chef
• 从 Workstation 引导注册 Node（推荐）
  • 基本引导：knife bootstrap <node_ip> -x <ssh_user> -P ‘<ssh_pass>’ -N <node_name>
  • 免交互密钥登录：knife bootstrap <node_ip> -x <ssh_user> -i <ssh_key> -N <node_name>
  • 说明：knife bootstrap 会自动安装（如未安装）并注册节点，完成后可在 Server 侧看到该 Node
• 验证
  • 列表：knife node list
  • 详情：knife node show <node_name>
  • 在节点上手动执行一次：sudo chef-client（应从 Server 拉取并应用配置）

四 快速验证与常见问题

• 快速验证
  • Server：sudo chef-server-ctl status（所有服务应为 up）
  • Workstation：knife user list / knife client list / knife node list（返回预期对象）
  • Node：sudo chef-client（首次运行成功即表示注册与拉取配置正常）
• 常见问题与处理
  • 主机名与 DNS：确保 FQDN 可解析，/etc/hosts 正确；Server 与 Node 时钟偏差不宜过大（建议 < 15 分钟）
  • SSL 连接错误：安装或重启后偶发 SSL_connect reset，可尝试重启 Server 或检查证书信任链
  • 离线环境：提前下载 chef-server-core、chef-workstation、chef-client 安装包与所需 cookbook，必要时自定义 bootstrap 模板从内网源安装 chef-client