Node.JS
Rainbond 5.1 版本已支持源码部署 NodeJS 前端类项目，你可以直接在 Rainbond 发布 Vue, React, Angular 等项目 查看文档： nodejs-static 部署 NodeJS 前端项目到 Rainbond
NodeJS 语言识别规范
平台默认会根据源码根目录是否有package.json来识别为 NodeJS 项目.
平台编译运行机制
- 预编译处理会探测是否定义了启动命令配置文件Procfile,如果未定义会读取
package.json文件中的script.start值来生成启动配置文件; - 预编译处理完成后,会根据语言类型选择 nodejs 的 buildpack 去编译项目.在编译过程中会安装定义的 Node 版本以及 Nodejs 相关依赖;
- 编译完成后会检查是否在平台设置了 Procfile 参数,若配置了会重写启动命令配置文件 Procfile.
NodeJS 项目源码规范
在此步骤中，你需要提供一个可用的 NodeJS 源码程序用来部署在 Rainbond 平台上,此应用程序至少需要满足如下条件:
- 本地可以正常运行的 NodeJS 项目
- 源码程序必须托管在 gitlab 等相关 git 或者 svn 服务上
- 源码程序根路径下必须存在
package.json,用来管理 NodeJS 项目的依赖,也是 Rainbond 识别为 NodeJS 语言的必要条件
Procfile 规范
如果项目未定义 Procfile 文件,平台会根据package.json文件中的script.start值来生成默认 Procfile。
web: npm start
上述是默认 Procfile,如果需要扩展更多启动参数,可以自定义 Procfile。
web:和npm之间有一个空格- 文件结尾不能包含特殊字符
编译运行环境设置
Node 版本支持
当前 Rainbond 支持 Node 如下版本为：
4.9.1
5.12.0
6.14.4
7.10.1
8.12.0
9.11.2
10.13.0
11.1.0
平台默认版本使用8.12.0。可以在 package.json 里使用 engines 指定版本：
{
"name": "myapp",
"description": "a really cool app",
"version": "0.0.1",
"engines": {
"node": "4.8.7"
}
}
0.8.5 之后的版本包括 0.11.13 也是支持的，以下是使用 0.11.x 版本的例子：
{
"engines": {
"node": "0.11.x"
}
}
npm 版本不是必须的，可以省略，因为 npm 是跟 node 绑定的。
依赖包安装
Node 项目支持使用 npm package manager 和 yarn package manager 安装依赖包，如果存在yarn.lock 文件，使用 yarn(默认支持版本 1.9.4)安装依赖和运行脚本，否则使用 npm。
-
yarn 定义方式
{
"engines": {
"yarn": "1.9.4"
}
}
自定义构建脚本
如果您的应用在构建时需要执行额外的操作，可以在 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": "9.3.0"
}
}
系统默认不自带 grunt、gulp、bower 这些工具，但是会安装 package.json 中 dependencies 和devDependencies 节点下的依赖，所以自定义执行的命令也需要作为依赖添加到此节点下，否则可能会找不到命令，这些工具执行时需要的依赖也是如此。
仓库私服设置
npm 私服设置
npm 构建默认使用淘宝私服地址： https://registry.npm.taobao.org
如果希望能够自定义 npm install 时使用的私服仓库地址，则需要添加自定义环境变量：
BUILD_NPM_REGISTRY=http://X.X.X.X:8080/repository/npm-group/
yarn 私服设置
yarn 构建并不支持环境变量设置私服，但是可以通过 preinstall 关键字设置私服地址。
"scripts": {
"preinstall": "bash preinstall.sh",
"build": "/tmp/build/node_modules/.bin/vue-cli-service build --mode test"
},
在上述的 package.json 文件中，关键字 preinstall 指定了在安装依赖（yarn install）前所做的操作。示例中为执行代码根目录下的一个脚本文件，其内容为设置构建私服：
#!/bin/bash
yarn config set registry http://X.X.X.X:8080/repository/npm-group/ --global