用pm2在本地部署服务器node项目,全栈实用技能，pm2部署node应用到服务器

好东西就要拿来分享，不管你的目标是前端还是全栈，都值得一看。

背景介绍

一般的，我们开发一个前端项目通常是在本地通过Node.js搭一个服务器，所有的开发测试过程基本上都是在本地搞定。有时候，我们需要把我们的作品上线，好让更多的人能够访问到。比较传统的方法可能就是将本地代码通过ssh、ftp等方式上传到服务器，然后通过ssh登入到服务器，配置好环境，然后手动启动我们的应用。

然而，很多时候我们的源码会不断的更新，如果全部由我们手动上传然后再启动，总显得太过繁琐。作为一个高大上的前端开发人员，这种方法实在太Low了。

通常，我们的代码都会用到Git版本控制工具。本篇文章，主要介绍基于 git + pm2 + node 的一键部署应用到服务器。

写在前面

网上大部分教程都只介绍方法，然而并没有提到实现原理，对于没有这方面概念的人来说，根本就不知道这是在干嘛。

三个概念

Git服务器：用来保存你代码的仓库，比如：Github。也可以是你自己搭建的Git服务器。为了统一，后面全部都叫Github。

目标服务器：就是你要将你的项目部署到的那个服务器，以下统一都叫服务器(Server)。

本地环境：就是你开发用的PC，就叫它Local吧。

实现原理

我不会画图，可以想象一下这个流程：我们在本地(Local)写好一个项目，再提交(commit)到远程Github上。然后让我们的目标服务器(Server)去远程的Github上获取(clone或pull)我们刚刚提交的最新版本，并通过npm install命令来安装所需的模块，最后启动服务器。

每当我们项目更新后，再重新执行此过程。这些过程都是通过pm2来实现的，而不用我们一步一步的手动去操作。

环境搭建

服务器端(Server)

需要安装node.js、pm2、git。

以下所有命令只针对CentOS 7发行版，其他版本可供参考，其原理都是一样的。

# 更新 yum

$ yum update -y

# 1. 安装node.js

$ yum install nodejs -y

# 2. 安装git

$ yum install git -y

# 3. 安装pm2

$ npm install -g pm2

建议使用yum来安装，会省去很多麻烦。如果通过其他方式安装，必须要保证node、npm、git、pm2都是全局安装(已添加到当前用户的环境变量中)。

本地(Local)

与服务器(Server)端一样，需要正确安装node、git和pm2。

配置SSH

根据上面的原理说明，可以得出以下3点：

本地(Local)要能够提交和拉取Github上的仓库(这个就不做介绍了，只要你使用GitHub，一般都已经配置好了)；

服务器(Server)要能够拉取Github上的仓库；

本地(Local)要能够免密码登录到服务器(Server)。

这也是3个前提条件，没有配置好后面就无法正常部署。

在Github上添加Deploy Keys

在服务器(Server)上执行：

# 生成ssh key，一路回车即可

$ ssh-keygen -t rsa

# 查看公钥内容

$ cat ~/.ssh/id_rsa.pub

然后复制整个内容，并添加到Github上对应的项目仓库Settings下的Deploy keys中。(只读权限即可)

本地(Local)自动登录到服务器(Server)

在本地(Local)执行：

# 生成ssh key，一路回车即可

$ ssh-keygen -t rsa

# 将本地key添加到服务器的authorized_keys中

# name 是你的服务器用户名 server 是你服务器的地址

# 默认是22端口，否则你需要指定端口号

$ ssh-copy-id name@serer

pm2部署

如果你已经配置好环境，接下来就可以进入主题了。

这里给一个官方的连接吧，我基本上也是参照官方介绍来操作的。

配置文件介绍

在项目的根目录下，执行：

$ pm2 ecosystem

然后会在根目录下生成一个ecosystem.config.js文件，官方文档中写的是ecosystem.json文件，可能两种都支持吧，这不是重点，主要看里面的配置：

// ecosystem.config.js

module.exports = {

/**

* Application configuration section 应用配置部分

* http://pm2.keymetrics.io/docs/usage/application-declaration/

*/

apps : [

// First application

{

// 项目名称

name : 'wchat-sv',

// 程序入口

script : 'index.js',

env: {

COMMON_VARIABLE: 'true'

},

env_production : {

NODE_ENV: 'production'

}

},

// 还可以配置第二个应用

{

// ...

}

],

/**

* Deployment section 部署部分

* http://pm2.keymetrics.io/docs/usage/deployment/

*/

deploy : {

production : {

// 因为pm2要登录到服务器(Server)中执行命令，所以要提供 name 和 host

// 这里没有提供密码，也就是为什么要配置ssh免密码登录

user : 'root', // 服务器用户名

host : '45.63.48.141', // 服务器地址

// 服务器(Server)需要获取GitHub上的仓库

// 所以要配置Deploy Keys

ref : 'origin/master', // 仓库名称，没有更改过的话默认即可

repo : 'git@github.com:moohng/wchat-sv.git', // Github上的仓库地址

path : '/root/server/production', // 应用部署到服务器的路径

'post-deploy' : 'npm install && pm2 reload ecosystem.config.js --env production' // 在服务器上执行的脚本命令，会在从Github上获取到最新的版本后执行

},

dev : {

user : 'node',

host : '212.83.163.1',

ref : 'origin/master',

repo : 'git@github.com:repo.git',

path : '/var/www/development',

'post-deploy' : 'npm install && pm2 reload ecosystem.config.js --env dev',

env : {

NODE_ENV: 'dev'

}

}

}

};

该配置主要包括两个部分：apps和deploy。

apps是一个数组，可以配置多个应用。其中name是应用名称(随意)，script是你应用启动的入口。

deploy又分为production和staging，其实也就是两个不同的环境。

基本需求上面的配置已经够用了，更多请参考官方文档。

部署

初始化服务器(Server)应用

$ pm2 deploy ecosystem.config.js production setup

开始部署

$ pm2 deploy ecosystem.config.js production

如果你的环境配置正确，那么现在你的应用就已经部署成功了。

错误总结

如果部署失败，根据提示信息来操作。

无法登录到你的服务器(Server)：没有正确添加本地(Local)ssh key到服务器(Server)的authorized_keys中。

服务器(Server)没有权限获取Github上的项目：Github没有正确添加Deploy Keys。

服务器(Server)找不到npm、git或pm2命令：没有正确全局安装。

对于第2个问题，有个注意的地方：如果你是首次从服务器获取Github上的仓库，需要先手动在服务器(Server)上执行一遍git clone ...操作，会有一个提示，输入yes即可。我猜可能是pm2不能自动输入yes来确认吧，网上都没有提到这个问题，是我自己遇到的，不知道是不是都这样。

防火墙相关操作

如果你已经部署成功，但却不能访问，那么很可能是端口没有开放。CentOS 7 默认是firewall防火墙，如果你的是iptables，请自行百度。

开放端口

# 开放某个端口，带--permanent参数是永久开放

$ firewall-cmd --zone=public --add-port=8080/tcp --permanent

# 重启

$ firewall-cmd --reload

# 查看开启的端口

$ firewall-cmd --list-ports

# --------------

# 移除开放的端口

$ firewall-cmd --zone=public --remove-port=8080/tcp --permanent

更多firewall的使用可以通过man firewall-cmd命令来查看。

pm2开机自启

$ pm2 startup centos

网上的教程好像还说要执行其他什么命令，不过我好像就执行这一些命令就搞定了。不知道是不是版本更新了，我使用的是目前最新的版本。

总结

我觉得这个技能很实用，也是因为最近的一个需求才了解到的，就拿出来分享一下。