企业官网建设流程全解析

python_pip完全教程：5步用Chef批量安装、升级与锁定Python包版本

【免费下载链接】pythonTHIS COOKBOOK IS DEPRECATED – Chef cookbook to install Python and related tools项目地址: https://gitcode.com/gh_mirrors/python10/python

📖 前言：python_pip 能帮你解决什么

python_pip是 Chef 官方 python cookbook 提供的一个轻量级资源（LWRP），让运维人员可以在一次 Chef 运行中批量安装、升级、删除和锁定 Python 包版本，而不是登录每一台服务器手动执行pip install。本项目是一个用于安装 Python、pip 与 virtualenv 的 Chef cookbook（注意：官方已标记该 cookbook 处于 deprecated 状态，新项目建设推荐评估 poise-python，但既有环境仍可稳定使用），核心资源定义在providers/pip.rb，默认配置在attributes/default.rb。

👉 5 步走完全文，你就能把一套 Python 环境的部署变成可重复、可审计、可回滚的自动化流程。

第1步：获取 cookbook 并了解安装方式

如果本地已有 Chef 工作区，可直接拉取代码（如需克隆仓库）：

git clone https://gitcode.com/gh_mirrors/python10/python

cookbook 支持 5 个子配方，在metadata.rb中均有声明：

安装方式由属性node['python']['install_method']控制，默认值package，可在角色/节点属性中改为source（见attributes/default.rb第 21 行）。

第2步：一键批量安装 Python、pip 与 virtualenv

把python加入节点 run list 即可：

include_recipe "python"

recipes/default.rb会自动串联三件事：按平台装 Python（recipes/package.rb会智能处理 Debian/RHEL/FreeBSD 等平台的包名差异）、用内置的files/default/get-pip.py安装 pip、再装好 virtualenv。整个过程天然幂等——pip 已存在时（not_if判断pip二进制路径）会自动跳过，重复执行不会出错。

💡 小贴士：recipes/pip.rb还会顺带执行python_pip 'setuptools'的升级动作，并通过属性node['python']['setuptools_version']控制版本。

第3步：用 python_pip 批量安装 Python 包

在任意 recipe 中，python_pip的用法和package资源几乎一致，因此极易上手：

python_pip "gunicorn" # 安装最新版 python_pip "django" do version "1.1.4" # 锁定指定版本 end

一次声明、批量下发，Chef 会并行处理数十台节点。资源支持的常用参数（完整逻辑见providers/pip.rb）：

• version：不填则装最新版，填了则精确安装该版本
• virtualenv：指定把包装进哪个隔离环境
• options：透传额外 pip 命令行参数
• timeout：安装超时（秒），默认 900，适合大型依赖包
• user/group：以指定用户运行 pip（配合 virtualenv 使用）

支持的 action 包括:install（默认）、:upgrade、:remove、:purge，其中:purge对 pip 包等价于:remove。

第4步：升级与锁定版本（幂等是关键）

python_pip 的聪明之处在于先探测当前版本再决定动作：

1. 每次运行先执行pip list解析出已安装版本（current_installed_version方法）；
2. 声明的版本与当前版本不一致才会真正安装，一致则直接跳过；
3. :upgradeaction 会对比当前版本与目标版本，仅在落后时执行pip install --upgrade。

这意味着：把version "2.1.2"写进 recipe，就是版本锁——所有节点被永久钉在 2.1.2；升级时统一改一处，所有节点同步漂移。测试用例test/cookbooks/python_test/recipes/test_pip.rb就演示了连续声明两次相同版本，第二次不会重复安装（通过 notify 写文件验证幂等）。

⚠️ 注意：版本号会拼成包名==版本传给 pip；如果安装的是源码归档或 git 地址（如git+...），provider 会自动不加版本后缀，避免命令报错。

第5步：用 virtualenv 隔离环境并验证结果

生产环境建议每个应用独立环境，python_virtualenv资源负责创建：

python_virtualenv "/home/ubuntu/my_ve" do owner "ubuntu" group "ubuntu" options "--system-site-packages" # 可选：共享全局包 action :create end python_pip "flask" do virtualenv "/home/ubuntu/my_ve" # 包只装进这个环境 end

验证环节推荐用 Test Kitchen：Berksfile已配好python_test集成测试 cookbook，按TESTING.md的说明安装依赖后执行kitchen test，即可在真实虚拟机里跑通「装环境 → 装包 → 幂等检查」的全链路（测试脚本见test/integration/与test/cookbooks/python_test/）。

📋 常见参数速查

❓ 新手常见问题

Q：这个 cookbook 还能用吗？A：官方 README 明确标注 deprecated，会持续保留以兼容存量环境，未来版本将逐步精简为 poise-python 的封装层。新项目建议评估 poise-python；本文用法对理解 Chef 包管理范式仍然非常有用。

Q：支持哪些系统？A：Debian、Ubuntu、CentOS、Red Hat、Fedora、FreeBSD、SmartOS，平台差异已在recipes/package.rb的包名映射中处理（老版本 RHEL 5 会自动挂 EPEL 源）。

Q：想装特定版本的 Python 解释器本身怎么办？A：设置node['python']['install_method'] = 'source'，再改node['python']['version']与checksum，recipes/source.rb会下载源码、编译并建立默认 python 软链。

结语

从一键装环境到批量锁版本，python_pip 把「Python 依赖漂移」这个运维痛点变成了 recipe 里的一行声明。配合 virtualenv 隔离与 Test Kitchen 验证，你获得的不只是几台装好 Python 的服务器，而是一套可重复、可审计的批量交付能力——这正是 Chef 自动化运维的核心价值。🚀

【免费下载链接】pythonTHIS COOKBOOK IS DEPRECATED – Chef cookbook to install Python and related tools项目地址: https://gitcode.com/gh_mirrors/python10/python