Node APP 布署简易教程
环境 (System):
CentOS 7
准备 (Requirement)
- git: 分布式代码版本管理工具
- node: 基于 Chrome V8 引擎的 JavaScript 服务端运行环境
- npm: node 的倚赖包管理器
- pm2: node 应用进程管理器
安装 (Install)
一般在 Linux 系统中安装程序有三种方式:
- 下载源码,手动编译
- 直接下载二进制文件
- 用 yum 安装
这里推荐用第二种。
Install git1
安装倚赖:
1
yum install -y curl-devel expat-devel gettext-devel openssl-devel zlib-devel gcc perl-ExtUtils-MakeMaker
前往 github 下载安装包,拷贝至
/usr/src
,或者直接用 wget:1
2
3
4cd /usr/src
yum install -y wget
wget https://www.kernel.org/pub/software/scm/git/git-2.10.2.tar.gz
tar xvzf git-2.10.2.tar.gzmake 安装:
1
2make prefix=/usr/local all
make prefix=/usr/local install检查 git 是否安装成功:
1
git --version
安装 node 和 npm:
前往 node official site 下载对应的编译好的 Linux 源码,或者直接用 wget 下载:
1
2
3cd /usr/src
wget https://nodejs.org/dist/v6.9.1/node-v6.9.1-linux-x64.tar.xz
tar xvf node-v6.9.1-linux-x64.tar.xz创建软链接至
/usr/local/bin
1
2ln -s /usr/src/node-v6.9.1-linux-x64/bin/node /usr/local/bin/node
ln -s /usr/src/node-v6.9.1-linux-x64/bin/npm /usr/local/bin/npm检查 node 与 npm 是否生效
1
2node -v
npm -v接下来要配置一下 npm,将 npm 的默认全局安装路径自定义到
/$HOME/.node
:1
npm config set prefix $HOME/.node
添加国内 registry:
1
npm config set registry https://registry.npm.taobao.org/
配置系统路径,使 npm 全局安装的模块命令行 bin 生效:
1
2echo "export PATH=$PATH:$HOME/.node/bin" >> ~/.bashrc
source ~/.bashrc
安装 pm2:
1 | npm install -g pm2 |
布署 (Deploy)
布署分为不用 git 和基于 git 两种方式。前者主要是用于 git 代码网络属于内网的环境下。
不用 git 的话,下载公司 gitlab 项目的 tag 包,拷贝至目标主机。
推荐使用 git
为了更好的版本管理与更轻松的解决版本倚赖,推荐使用 git。
git 的传输协议有 https 和 ssh 两种,我们采用更加安全快速的后者。服务器只需 git 的只读权限,因此不必配置 git user,只需生成 ssh key 做为项目的 deploy key<span class=”hint–top hint–error hint–medium hint–rounded hint–bounce” aria-label=”gitlab 项目右上角的菜单中选择 “Deploy Keys”,在此添加服务器的公钥 “id_rsa.pub” 中的内容”>2。
(ps. 关于如何生成 ssh key,可参见此,这里要输入的邮箱改为服务器名即可)。
接下来 clone 项目代码至服务器:
1
git clone git@git.cairenhui.com:<GROUP>/<PROJECT>.git <NODE_APP_DIR>
注:尖括号内的为变量
检出版本
1
2
3
4
5// 查看当前所有版本
git tag
// 切换到指定版本,这里的 <TAG> 是演示,比如可以是 1.0.0
git checkout <TAG>安装倚赖:
1
2
3
4
5// 如果没用到 bower,跳过此步骤
bower install --allow-root
// 安装 node 倚赖包
npm install --production
注:不采用 git 布署的话,只需执行最后一步
至此,无论是否使用 git,布署都已完成。
运行 (Run)
在项目根目录下,运行 pm2 start pm2.json
即可。
pm2.json
中的 name
字段为 App name,pm2 可以全局地操作它:pm2 stop <APP_NAME>
另外有几个比较有用的命令:
- 查看所有的 node 应用进程:
pm2 list
- 查看某个应用的具体信息:
pm2 show <APP_NAME>
- 监控 CPU / Memory:
pm2 monit
- 查看应用消息日志:
pm2 logs <APP_NAME>
- 重启应用程序:
pm2 restart <APP_NAME>
更多的命令用法请查看:https://github.com/Unitech/pm2#main-features
更新或回滚 (Update/Rollback)
不使用 git:之前已提到过,直接在 gitlab 上下载 tag 包,解压缩覆盖至服务器
使用 git:先通过 git 获取更新
1
git fetch origin --tags
再切换:
1
git checkout <NEW_TAG>
回滚也非常简单:
1
git checkout <PREV_TAG>