文字

语言识别

代码的根目录下必须有 package.json 文件,如果不存在请手动或使用 npm init 命令创建并配置需要的依赖和其它信息。

运行时版本

Node 的版本遵循 SemVer 规范,SemVer 是一种由 github 推广开的语义化
版本控制规范,使用 MAJOR.MINOR.PATCH 形式的版本控制方案:

  • MAJOR 更改不兼容的 API
  • MINOR 向后兼容的方式增加功能
  • PATCH 向后兼容的方式修复 bug

Node 的版本策略是从 Linux 学来的,其中偶数的 MINOR 版本号表示稳定的发布。以下是 node 版本的一些例子:

  • 0.8.x: 稳定
  • 0.9.x: 不稳定
  • 0.10.x: 稳定
  • 0.11.x: 不稳定
  • 0.12.x: 稳定

当前支持v0.10.*、v0.12.*、v0.8.*、v2.3.1、v4.*.*、v5.*.*、v6.*.* (目前支持到v6.5.0) 版本,在 package.json 里使用 engines 指定版本:

{
      "name": "myapp",
      "description": "a really cool app",
      "version": "0.0.1",
      "engines": {
        "node": "4.1.0"
      }
}

0.8.5 之后的版本包括 0.11.13 也是支持的,以下是使用 0.11.x 版本的例子:

{
  "engines": {
    "node": "0.11.x"
  }
}

提示: npm 版本不是必须的,可以省略,因为 npm 是跟 node 绑定的。

环境变量

系统会设置以下的环境变量,NODE_ENV 环境变量默认是 production。

# 默认 NODE_ENV 是 production
export NODE_ENV=${NODE_ENV:-production}

# 添加node的二进制文件目录到PATH
PATH=vendor/node/bin:bin:node_modules/.bin:$PATH

自定义构建

如果你的应用在构建时需要执行额外的操作,可以在 package.json 的 scripts 节点下添加 postinstall
脚本,该脚本会在 buildpack 执行完 npm install --production 后自动执行,package.json 示例:

{
  "name": "node-hello",
  "version": "0.0.1",
  "description": "nodejs demo",
  "dependencies" : {
    "bower": "~1.3.9",
    "grunt-cli": "~0.1.13",
  },
  "scripts": {
    "start": "node index.js",
    "test": "mocha",
    "postinstall": "bower install && grunt build"
  },
  "engines": {
    "node": "4.1.0"
  }
}

注意
系统默认不自带 grunt/gulp/bower 这些工具,而且只会安装 package.json 中 dependencies 节点下的依赖,所以自定义执行的命令也需要作为依赖添加到此节点下,否则可能会找不到命令,这些工具执行时需要的依赖也是如此。

我们推荐在本地编译好静态文件再上传到服务器部署,而不是在服务器端做!

因为服务器端可能会缺少某些包依赖的外部环境而无法执行某些 grunt 任务,比如:grunt-contrib-compass 和 grunt-contrib-sass 都是依赖外部的 Ruby 命令行工具的,但是平台的 nodejs 环境里是没有这些工具的。

启动命令

Procfile 文件不是必须的,系统会检查 package.json 里的 scripts.start 项,如果存在,
系统会使用 scripts.start 里的命令做为启动命令,参考上一节里 package.json 示例里的 scripts.start 脚本。

另外,您也可以自行创建 Procfile 来指定应用启动命令,如:

web: npm start

系统会优先使用 Procfile 中的启动命令。

注:请注意Profile的语法,冒号后在有一个空格。

上一篇: 下一篇:
  页面正在加载中