使用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组件。
- git方式会执行
- 部署时间
- 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_ENVslc ctl env-set <service_name> NODE_ENV=production -
设置
cluster sizeslc ctl set-size <service_name> <number>
启动项目
一般会打开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 <server_name> -
关闭
slc ctl stop <service_name> -
查看log
slc ctl log-dump <service_name> --follow -
远程命令
slc ctl -C http://remote_dir:port/ <cmd>
远程部署
安装, 运行pm服务
不同平台下安装pm服务的方法不同, 具体安装方法参考下面的文档。
Setting up a production host - Documentation
本机远程部署
- 使用tar的方式打包, 以避免自动清掉开发使用的npm组件。
- 部署到远程
slc deploy --service=<your-service-name> http://your-pm-instance:port
这种方法会将无用的开发npm组件也部署到项目上, 比较浪费时间和资源。
远程登录后的部署方案(推荐)
- 在本机上远程登录服务器。
- 使用
git pull获取最新的代码。 - 在远程使用script打包。
- 部署到对应的服务器。
在开发服务器上打包, 保证了和生产环境使用相同的工作平台, 可以使用script打包, 实现快速部署。普通的部署方式会执行一个较长编译过程, 部署期间服务是不可访问的, 所以这种方法有效的缩短了不可访问时间。
