跳到主要内容

Node.JS

Rainbond 5.1 版本已支持源码部署 NodeJS 前端类项目,你可以直接在 Rainbond 发布 Vue, React, Angular 等项目 查看文档: nodejs-static 部署 NodeJS 前端项目到 Rainbond

NodeJS 语言识别规范

平台默认会根据源码根目录是否有package.json来识别为 NodeJS 项目.

平台编译运行机制

  1. 预编译处理会探测是否定义了启动命令配置文件Procfile,如果未定义会读取package.json文件中的script.start值来生成启动配置文件;
  2. 预编译处理完成后,会根据语言类型选择 nodejs 的 buildpack 去编译项目.在编译过程中会安装定义的 Node 版本以及 Nodejs 相关依赖;
  3. 编译完成后会检查是否在平台设置了 Procfile 参数,若配置了会重写启动命令配置文件 Procfile.

NodeJS 项目源码规范

在此步骤中,你需要提供一个可用的 NodeJS 源码程序用来部署在 Rainbond 平台上,此应用程序至少需要满足如下条件:

  1. 本地可以正常运行的 NodeJS 项目
  2. 源码程序必须托管在 gitlab 等相关 git 或者 svn 服务上
  3. 源码程序根路径下必须存在package.json,用来管理 NodeJS 项目的依赖,也是 Rainbond 识别为 NodeJS 语言的必要条件
Procfile 规范

如果项目未定义 Procfile 文件,平台会根据package.json文件中的script.start值来生成默认 Procfile。

web: npm start

上述是默认 Procfile,如果需要扩展更多启动参数,可以自定义 Procfile。

  1. web:npm之间有一个空格
  2. 文件结尾不能包含特殊字符

编译运行环境设置

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 manageryarn package manager 安装依赖包,如果存在yarn.lock 文件,使用 yarn(默认支持版本 1.9.4)安装依赖和运行脚本,否则使用 npm。

  • yarn 定义方式

    {
    "engines": {
    "yarn": "1.9.4"
    }
    }
自定义构建脚本

如果您的应用在构建时需要执行额外的操作,可以在 package.jsonscripts 节点下添加 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.jsondependenciesdevDependencies 节点下的依赖,所以自定义执行的命令也需要作为依赖添加到此节点下,否则可能会找不到命令,这些工具执行时需要的依赖也是如此。

仓库私服设置
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

示例 demo 程序

示例https://github.com/goodrain/nodejs-demo