指定 Node.js 版本
Buildpack 项目支持 Node.js 的当前版本和活跃 LTS 版本。旧版 Node.js 也可以使用，但项目可能不会对旧版本主动进行维护。
使用 package.json
您可以通过在 package.json 中配置 engines.node 字段，在部署期间指定应用的 Node.js 版本。如需在部署应用时将 Buildpack 配置为使用最新版本的 Node.js v16，您可以在 package.json 中使用以下值：
"engines": {
"node": "16.x.x"
}
使用 GOOGLE_NODEJS_VERSION
还可以通过 GOOGLE_NODEJS_VERSION 环境变量指定 Node.js 版本。如果同时设置了这两个配置，则 GOOGLE_NODEJS_VERSION 值优先于 engines.node 属性。如果未提供值，则使用最新 LTS 版本的 Node.js。
如需在部署应用时将 Buildpack 配置为使用 Node.js 16，请执行以下命令：
pack build --builder=gcr.io/buildpacks/builder \
sample-functions-framework-node \
--env GOOGLE_NODEJS_VERSION=16.x.x
您还可以使用 project.toml 项目描述符对环境变量以及项目文件进行编码。请参阅使用环境变量构建应用中的说明。
提示
engines.node字段可以接受 semver 限制条件。用于 Node.js Buildpack 的特定库是 Masterminds/semver- 避免在
engines.node中使用大于号 (>) 说明符 - 将应用部署到 App Engine 标准环境时，
engines.node属性应与app.yaml中指定的运行时兼容 - 如需查看有关
package.json中engines.node配置选项的更多文档，请参阅引擎主题下的官方 NPM 文档 - 将函数部署到 Cloud Functions 时，
engines.node属性应与用于部署函数的运行时兼容
安装依赖项
使用 NPM
- NPM 是默认的软件包管理器。
- 尽可能使用
package-lock.json来提高缓存性能。 - 默认仅安装生产依赖项。
- 您可以使用
package.json文件中的engines.npm字段指定 npm 版本部分。
使用 Yarn
- 当您在项目中添加
yarn.lock文件时，系统将使用 Yarn。 - 您可以在
package.json文件的engines.yarn字段中指定要使用的 Yarn 版本。 - 如果您的项目包含
.yarn/cache，则支持 Yarn2 PnP 模式。
使用 Pnpm
- 当您在项目中添加
pnpm-lock.yaml文件时，系统会使用 Pnpm。 - 您可以在
package.json文件的engines.pnpm字段中指定 pnpm 版本。 - 如需查看有效示例，请参阅 sample-node-pnpm 应用。
在部署期间执行自定义构建步骤
默认情况下，如果 package.json 文件中指定了脚本，则系统会运行 npm run build。但是，您可以改为指定自定义构建步骤来替换默认行为，并在构建期间仅运行所需的脚本。您可以使用 GOOGLE_NODE_RUN_SCRIPTS 环境变量或 package.json 文件中的 gcp-build 来控制构建步骤。
您只能使用一种方法。请注意，GOOGLE_NODE_RUN_SCRIPTS 环境变量优先，并替换为 package.json 中的 gcp-build 指定的任何值。
默认情况下，当您配置自定义构建步骤时，系统会先安装 package.json 文件中的 dependencies 和 devDependencies，然后再执行任何脚本或命令。如需替换默认行为，您可以使用 NODE_ENV 环境变量。
使用 GOOGLE_NODE_RUN_SCRIPTS
您可以将 GOOGLE_NODE_RUN_SCRIPTS 环境变量传递给构建来控制运行的脚本。您可以指定一个或多个脚本，也可以改为传递空环境变量来阻止默认行为运行，例如 GOOGLE_NODE_RUN_SCRIPTS=。如需了解完整详情，请参阅环境变量。
使用 package.json
在 package.json 文件中添加 gcp-build 只会运行 npm run gcp-build，这意味着它会替换默认行为。您可以指定一个或多个命令，也可以改为指定空字符串来阻止任何命令运行，例如 "gcp-build":""。
"scripts": {
...
"gcp-build": "npm run lint && npm run build"
...
}
应用入口点
Node.js Buildpack 执行 package.json 的 scripts.start 字段中指定的命令。如果未设置 scripts.start，Buildpack 会运行 npm start。
我们建议您使用 Procfile，因为它会从路径中提取 npm 或 yarn。
环境变量
您可以设置环境变量以配置容器映像的构建。
Node.js Buildpack 支持使用以下环境变量来自定义容器。
NPM_CONFIG_<key>
请参阅文档。
示例：NPM_CONFIG_FLAG=value 会将 -flag=value 传递给 npm 命令。
NODE_ENV
在构建期间指定开发环境；为 npm install 设置。
示例：NODE_ENV=development 会安装 package.json 中指定的 dependencies 和 devDependencies。
GOOGLE_NODE_RUN_SCRIPTS
指定在安装依赖项后要运行的 package.json 中的 npm 脚本的有序列表。该列表必须以英文逗号分隔，并按列出每个脚本的顺序运行。
如果您指定 GOOGLE_NODE_RUN_SCRIPTS，则系统只会运行您列出的脚本。例如，如果您想要阻止默认 npm run build 运行，则可以指定环境变量而不指定值。
示例：
GOOGLE_NODE_RUN_SCRIPTS=lint,build依次运行npm run lint和npm run build。GOOGLE_NODE_RUN_SCRIPTS=不运行任何脚本。