heroku/buildpack-nodejs-pnpm-engine

Heroku Node.js pnpm Engine 构建包

镜像概述和主要用途

Heroku Node.js pnpm Engine 构建包是 Heroku 官方提供的组件，作为 heroku/nodejs 构建包的一部分，专门用于在 Heroku 云平台上支持使用 pnpm 作为包管理器的 Node.js 项目。它负责处理 pnpm 相关的依赖安装、版本管理及构建流程，确保采用 pnpm 的 Node.js 应用能够在 Heroku 环境中正确构建和运行。

核心功能和特性

• pnpm 集成支持：原生支持 pnpm 包管理器，能够识别和处理 pnpm-lock.yaml 文件，确保依赖准确安装。
• 与 Heroku Node.js 构建包协同：作为 heroku/nodejs 构建包的组件，无缝集成到 Heroku 的 Node.js 应用构建流程中。
• 依赖管理优化：利用 pnpm 的特性（如共享依赖存储、硬链接）提升依赖安装效率，减少存储空间占用。
• 版本兼容性：支持主流 pnpm 版本，与 Heroku 平台的 Node.js 版本管理机制兼容。

使用场景和适用范围

• 适用项目：采用 pnpm 作为包管理器的 Node.js 应用（如 Express、React、Vue 等 Node.js 后端或前端项目）。
• 部署环境：Heroku 云平台，需配合 heroku/nodejs 构建包使用。
• 开发团队：偏好 pnpm 包管理工具（如追求更快安装速度、更小存储空间占用）的开发团队。

使用方法和配置说明

前提条件

• 已在 Heroku 上创建 Node.js 应用。
• 项目中包含 pnpm-lock.yaml 文件（由 pnpm 生成）。

启用构建包

Heroku 通常会自动检测项目中的包管理器配置。若需显式配置，可通过 Heroku CLI 设置构建包顺序：

bash
heroku buildpacks:set heroku/nodejs

（注：heroku/nodejs 构建包已包含 pnpm Engine 组件，无需单独添加）

配置 pnpm 版本（可选）

如需指定 pnpm 版本，可在项目根目录创建 .npmrc 或 .pnpmrc 文件，添加：

pnpm-version=8.6.0  # 指定所需 pnpm 版本

构建和部署

通过 Git 推送触发 Heroku 构建：

bash
git push heroku main

Heroku 将自动使用 pnpm 安装依赖（基于 pnpm-lock.yaml），完成应用构建和部署。