initializbuildpacks/yarn-install

Yarn Install CNB

镜像概述和主要用途

Yarn Install CNB（Cloud Native Buildpack）是一个专为Node.js应用设计的构建组件，核心功能是通过Yarn包管理器处理依赖管理流程。它作为Cloud Native Buildpack生态的一部分，在构建Node.js应用容器镜像时，自动识别并安装项目依赖，确保构建环境的一致性和可靠性。

核心功能和特性

• 依赖自动安装：识别项目中的package.json和yarn.lock文件，基于锁定文件安装精确版本的依赖项
• Yarn生态兼容：支持标准Yarn工作流，包括依赖缓存、离线安装和版本解析
• CNB流程集成：无缝融入Cloud Native Buildpack构建生命周期，与基础镜像、构建器等组件协同工作
• 依赖缓存优化：缓存已安装的依赖包，减少重复构建时的网络请求，提升构建效率

使用场景和适用范围

• Node.js应用构建：适用于所有使用Yarn作为包管理器的Node.js项目
• 云原生环境：特别适合在Cloud Native Buildpacks（如Paketo、Heroku Buildpacks）环境中构建容器镜像
• CI/CD流水线：可集成到自动化构建流程中，确保依赖安装的标准化和可重复性

使用方法和配置说明

基本使用流程

在Cloud Native Buildpacks环境中，Yarn Install CNB会通过以下方式自动激活：

1. 项目根目录存在package.json和yarn.lock文件
2. 构建器（Builder）已包含Yarn Install CNB组件

典型构建命令示例：

bash
pack build my-node-app --builder paketobuildpacks/builder:base

（注：需确保使用的builder已集成Yarn Install CNB）

配置参数

环境变量

项目配置要求

为确保依赖正确安装，项目需满足：

• 根目录包含有效的package.json文件（定义项目依赖）
• 根目录包含yarn.lock文件（锁定依赖版本，确保一致性）
• 网络环境可访问Yarn仓库（或配置离线镜像源）

示例：指定生产环境安装

构建生产环境镜像（仅安装dependencies，忽略devDependencies）：

bash
pack build my-node-app --builder paketobuildpacks/builder:base \
  --env NODE_ENV=production \
  --env YARN_FLAGS=--frozen-lockfile