部署nodejs项目到服务器的一些总结

4,918 阅读4分钟

「这是我参与11月更文挑战的第8天,活动详情查看:2021最后一次更文挑战

安装nodejs

首先在服务器上安装nodejs并配置环境,这个可以参考官方的文档,就不细说了

拷贝项目到服务器上

这里其实可以通过git直接clone在服务器上。当然正常发版一般是将代码打包上传到服务器上部署,可以通过pcsp传送文件到服务器上:

(1)确保服务器(linux)已经准备好,开通了相应接口。(具体做法直接百度)

(2)将项目打包压缩gz文件(windows下可以使用7-zip,先压缩成tar,再压缩成gz)

(3)打开电脑终端,进入pscp的目录,输入命令:

pscp [项目压缩包的路径] [username]@192.168.1.1:/home/[username]

然后输入服务器的用户密码,即可将压缩包传送到服务器的/home/[username]下。

注意:用户一定要有该文件夹的写权限,否则无法传送。

(4)解压到指定目录即可。

部署项目

我们使用pm2来进行项目部署,通过终端登上服务器,安装pm2。

npm install -g pm2

然后进入项目目录,通过下面的命令进行部署:

pm2 start bin/www

nodejs的入口js文件默认是bin/www,所以我们启动这个文件。

启动完成后就可以通过ip和端口访问这个服务了。如果我们为这个端口绑定了域名,也可以直接通过域名进行访问。

防火墙

如果在外网无法访问这个接口,那么很可能是防火墙引起的。我们需要关闭防火墙或将这个端口加入白名单。

下面是防火墙的一些常用指令:

启动: systemctl start firewalld

关闭: systemctl stop firewalld

查看状态: systemctl status firewalld

开机禁用  : systemctl disable firewalld

开机启用  : systemctl enable firewalld

下面是端口相关的一些指令:

添加: firewall-cmd --zone=public --add-port=80/tcp --permanent   

(--permanent永久生效,没有此参数重启后失效)

重新载入: firewall-cmd --reload

查看: firewall-cmd --zone= public --query-port=80/tcp

删除: firewall-cmd --zone= public --remove-port=80/tcp --permanent

pm2命令

下面是一些常用的pm2命令:

安装:npm install -g pm2

启动并命名进程:pm2 start bin/www --name <my-api>

启动命名进程,设置cpu数为x:pm2 start bin/www -i x --name <my-api>

启动程序:pm2 start <app_name|id|all>

列举进程:pm2 list

退出程序:pm2 stop <app_name|id|all>

重起应用:pm2 restart <app_name|id|all>

程序信息:pm2 describe id|all

监控:pm2 monit

实时集中log处理: pm2 logs

查看错误日志: pm2 logs <app_name|id>

API:pm2 web (端口:9615 )

日志

如果启动失败或服务异常退出,可以通过日志进行排查。

pm2的错误日志位于/root/.pm2/logs/目录下,日志文件以进程名命名。

在终端执行pm2 logs,可以实时的看到nodejs的console信息了。

多环境

可以使用json配置来启动项目,这样就可以启动不同的环境(开发/生产)

pm2 start xxx.json

可以在nodejs项目下配置不同环境的配置文件,尤其是使开发和生产环境使用不用的端口和名称

配置文件的简单示例:

dev.json

{
  "apps": [
    {
      "name": "custom-dev",
      "script": "./bin/www",
      "env": {
        "PORT": "10008",
      }
    }
  ]
}

release.json

{
  "apps": [
    {
      "name": "custom",
      "script": "./bin/www",
      "env": {
        "PORT": "8000",
      }
    }
  ]
}

在nodejs默认生成的入口文件bin/www中,端口会默认获取进程env的配置,如下

var port = normalizePort(process.env.PORT || '8000');

所以通过上面的方式进行启动,不同的环境就会使用不同的端口。

调试

有时我们需要在服务端进行简单的调试,虽然我们可以用pm2 logs查看实时console信息,但是如果服务器上同时运行多个项目,那么就会有很多无效信息。我们可以直接使用node命令来启动

node ./bin/www

但是这样启动的话会直接使用我们在www里设置好的接口,而这个接口很可能是生产环境的接口,所以我们要避免使用这个接口,加上端口即可,如下:

PORT=1234 node ./bin/www

这样就是以1234接口启动了