Loopback部署方案

使用loopback框架可以很方便的构建一套基于nodeJS的api服务。在完成了 coding 后, 需要部署到服务器, StrongLoop 公司给出了一套解决方案, 采用StrongLoop Process Manager进行进程和环境的管理。这个工具有很多功能, 今天只讲如何利用它来部署。

本地调试

启动pm服务

启动本地的临时pm服务, 这种启动方式不会自动重启。

slc pm

打包项目

用git的形式打包

这种方式会在本地建立deploy分支, 然后可以将该分支的代码提交到pm服务。
```
slc build
```
用tar的形式打包

这种方式会在上级目录中生成一个以项目名为开头的tar文件, 然后可以将该文件提交到pm服务。
```
slc build --pack
```
用script的形式打包(推荐)

这种方式会完整安装npm组件, 并完整编译, 以避免部署时的编译过程, 缩短部署时间。
```
slc build --install --scripts
```

几种方式的不同点:

打包时间不同
- git方式的速度最快, 它会将本地用于production的npm组件一同打包。
- tar方式的速度中等, 它会将本地的所有npm组件一同打包。
- script方式的速度最慢, 它会将本地的所有npm组件编译后打包。
清理插件
- git方式会执行npm prune, 会清理package.json下devDependencies的所有插件。
- tar方式和script方式不会清理开发所有的npm组件。
部署时间
- script方式的速度最快, 但是它要求打包和部署在同一种工作平台, 编译后可以直接运行。
- git方式和tar方式差距不大。

部署项目

默认部署项目到本地pm

slc deploy
slc deploy http:// ../appname-appversion.tgz

部署后可能发现server不能运行, 是因为server在执行npm install和编译工作, 在这两项工作完成前是无法运行的。
具体可以通过远程命令sudo service strong-pm status中的当前线程来判断和debug。
我在项目中就遇到了某个npm组件在Ubuntu下安装不成功的问题, 卡了很久。

设置环境参数

配置环境参数NODE_ENV
```
slc ctl env-set  NODE_ENV=production
```
设置cluster size
```
slc ctl set-size  
```

启动项目

一般会打开arc工具, 方便得进行可视化管理。
git项目:https://github.com/strongloop/strong-arc

运行arc服务

slc arc

打开GUI界面

http://localhost:{自动生成的端口号}/#/process-manager

在自动打开的管理页面上选择Process Manager选项
在Hosts处和Port处填入应对的参数。
点击App Status处的链接按钮, 连接arc工具到对应的pm服务上, 就可以看到当前server的情况和操作方法了。

使用slc来管理项目

启动
```
slc ctl start 
```
关闭
```
slc ctl stop 
```
查看log
```
slc ctl log-dump  --follow
```
远程命令
```
slc ctl -C http://remote_dir:port/ 
```

远程部署

安装, 运行pm服务

不同平台下安装pm服务的方法不同, 具体安装方法参考下面的文档。
Setting up a production host - Documentation

本机远程部署

使用tar的方式打包, 以避免自动清掉开发使用的npm组件。
部署到远程

slc deploy --service= http://your-pm-instance:port

这种方法会将无用的开发npm组件也部署到项目上, 比较浪费时间和资源。

远程登录后的部署方案(推荐)

在本机上远程登录服务器。
使用git pull获取最新的代码。
在远程使用script打包。
部署到对应的服务器。

在开发服务器上打包, 保证了和生产环境使用相同的工作平台, 可以使用script打包, 实现快速部署。普通的部署方式会执行一个较长编译过程, 部署期间服务是不可访问的, 所以这种方法有效的缩短了不可访问时间。

部署文档

https://docs.strongloop.com/display/SLC/Deployment+best+practices