前端Linux部署命令与流程记录

以前写过一篇在Linux上从零开始部署前后端分离的Vue+Spring boot项目，但那时候是部署自己的个人项目，磕磕绊绊地把问题解决了，后来在公司有了几次应用到实际生产环境的经验，发现还有很多可以补充的地方，很多指令和下载地址每次用到的时候再找就相对麻烦，通过这篇文章可以做一个记录。

另外，之前漏掉了很重要的Linux版本，因为以前不太了解，一直使用的都是CentOS 7，这次选择系统的时候看到CentOS后续会停止维护，所以决定换一个版本学习一下，Linux版本非常多，通常我们可以选择CentOS、Debian、Ubuntu等，具体的区别可以自己去查下，这里我选择了Debian 11.1作为新的系统环境。

npm和node（通过NVM安装）

前端部署最先想到的就是NPM和Node，但是Node的版本切换可能是个问题，所以使用了NVM，这里之前也写过一篇NVM、NPM、Node.js的安装选择，不过是针对Windows系统的，实际在Linux上运行还有些许不同。

写文档时NVM的最新版本为0.39.3，使用时可以按需要更改版本。

1. 安装

1.1 在线安装

NVM的GitHub地址

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

1.2 手动安装

也可以下载GitHub的Release版本文件上传到服务器手动安装，安装目录是/root/.nvm。

创建安装目录

mkdir /root/.nvm

解压文件到安装目录

tar -zxvf nvm-0.39.3.tar.gz --strip-components 1  -C /root/.nvm

2. 配置环境变量

如果选择了手动安装，需要自己配置一下环境变量才能在全局使用nvm指令。

#编辑文件
vim ~/.bashrc
#按“i”进入insert模式，将下面两行代码写入文件，按“esc”退出insert模式，按“:”进入底行模式，输入“wq!”回车，即保存并退出
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
#刷新配置
source ~/.bashrc

3. 判断是否安装成功

nvm -v

4.安装node和npm

#查看线上版本的指令与Windows版不同
nvm ls-remote
#选择一个LTS版本，如下图所示18.13.0，关于版本选择的问题以前也说过
nvm install 18.13.0

前端Linux部署命令与流程记录

5.查看和切换版本

#查看npm和node版本
npm -v
node -v
#如果提示没有找到指令，则查看已安装的node版本
nvm ls
#切换到18.13.0版本
nvm use 18.13.0

nrm

nrm（npm registry manager）是npm的镜像源管理工具，直接使用连接国外资源下载有时会慢，可以切换至其他镜像源。

#全局安装
npm install -g nrm
#查看可选的源
nrm ls
#切换至淘宝源
nrm use taobao

Nginx

Debian安装

如果使用的是Debian的系统，可以通过如下代码直接安装，但实际生产环境多半要添加模块，还是需要手动下载源码编译，参考下文的步骤。

sudo apt update
sudo apt install nginx

下载

Nginx下载

选择稳定版本下载，上传到服务器

或者通过远程仓库下载

wget http://nginx.org/download/nginx-1.22.1.tar.gz

安装


# 1.解压文件
tar -zxvf nginx-1.22.1.tar.gz
# 2.进入目录
cd nginx-1.22.1

按需编译

没有特殊需求的话，在nginx的解压目录里执行 make && make install 就可以编译安装nginx了，但是实际的线上环境还需要添加一些模块来满足线上的业务需求，我们的项目中用到了两个插件：

编译前要先安装依赖，虽然两个系统要安装的库不同，但是功能类似，从上到下依次是：

# CentOS
yum install gcc
yum install pcre-devel
yum install zlib zlib-devel
yum install openssl openssl-devel

# Debian
apt install -y build-essential
apt install -y libpcre3 libpcre3-dev
apt install -y zlib1g-dev
apt install -y openssl libssl-dev

编译操作如下:

#查看可用模块
./configure  --help  
#配置
./configure \
--prefix=/usr/local/nginx \
--with-http_ssl_module \
--with-http_realip_module \

参数说明：

没有安装依赖的话这里会提示错误，正确执行的结果如下：

前端Linux部署命令与流程记录

接下来就是编译安装：

#编译
make
#安装
make install
#可以简写成
make && make install

创建软链接

安装完成后，通过 nginx -V 查看一下已安装的模块信息，会提示没有这样的指令，这是因为指令只能在对应目录下执行，对于需要频繁使用的工具来说并不方便，想要在全局使用，可以创建一个软链接：

sudo ln -s /usr/local/nginx/sbin/nginx /usr/sbin/nginx

之后就可以在任意目录执行nginx指令，执行 nginx -V 可以看到编译安装的模块：

前端Linux部署命令与流程记录

日志

nginx日志默认记录在安装目录的 logs 文件夹下，访问日志全部写入在 access.log 文件中，随着时间推移，日志文件体积会逐渐增加，单个文件过大会导致可读性变差。通过修改配置的方式，我们可以让nginx日志自动按日期分割。

#日志时间变量
map $time_iso8601 $logdate {
  '~^(?<ymd>\d{4}-\d{2}-\d{2})' $ymd;
  default    'date-not-found';
}
log_format  json_log  escape=json '{"host":"$http_host $request","time":"$time_local","timestamp":"$msec","from_ip":"$remote_addr","real_ip":"$http_x_forwarded_for","user_agent":"$http_user_agent"}';
access_log  logs/access-$logdate.log  json_log;

加在下图位置：

前端Linux部署命令与流程记录

在更新配置之前，还要授予文件夹权限，要按日期创建日志文件需要有在目录中写入的权限。

chmod -R 777 /usr/local/nginx/logs

在查找无权限创建文件这个问题时候，看到一些回答是修改运行nginx的用户为root，但是我觉得这样在安全上可能会有问题，虽然777也是文件夹的最高权限，任何用户都可以修改，但相对会好一些，可能还有更好的方法，欢迎评论留言。

需要的话，error.log 也可以以同样的方式按时间分割。

前端Linux部署命令与流程记录

可以创建一个软链接方便查看日志

ln -s /usr/local/nginx/logs /root/logs

启动

无论是启动还是重启，都要先测试配置，没有问题再启动。

#测试配置
nginx -t
#配置没有问题后启动
nginx
#重启
nginx -s reload

pm2

#安装
npm install pm2@latest -g
#查看
pm2 -h

如果提示命令未找到，也是与之前一样在bin目录下建立软链接

标签 , ,

发表回复