nginx的平滑升级及版本回滚

官方源码包下载地址：nginx: download

一、编译安装Nginx-1.24.0

$root@Nginx \~$ # dnf install gcc pcre-devel zlib-devel openssl-devel -y

$root@Nginx \~$ # mkdir /nginx #创建目录，将nginx-1.24.0.tar.gz放在这个目录里

$root@Nginx nginx$ # tar zxf nginx-1.24.0.tar.gz

$root@Nginx nginx-1.24.0$ # useradd -s /sbin/nologin -M nginx

$root@Nginx nginx$ # cd nginx-1.24.0/

$root@Nginx nginx-1.24.0$ # ls

$root@Nginx nginx-1.24.0$ # ./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_stub_status_module --with-http_gzip_static_module --with-pcre --with-stream --with-stream_ssl_module --with-stream_realip_module

bash 复制代码

[root@Nginx nginx-1.24.0]# ./configure --prefix=/usr/local/nginx \
--user=nginx \ # 指定nginx运行用户
--group=nginx \ # 指定nginx运行组
--with-http_ssl_module \ # 支持https://
--with-http_v2_module \ # 支持http版本2
--with-http_realip_module \ # 支持ip透传
--with-http_stub_status_module \ # 支持状态页面 
--with-http_gzip_static_module \ # 支持压缩 
--with-pcre \ # 支持正则
--with-stream \ # 支持tcp反向代理
--with-stream_ssl_module \ # 支持tcp的ssl加密
--with-stream_realip_module # 支持tcp的透传ip

$root@Nginx nginx-1.24.0$ # make && make install

nginx完成安装以后，有四个主要的目录

$root@Nginx nginx-1.24.0$ # ls /usr/local/nginx/

conf html logs sbin

conf：保存nginx所有的配置文件，其中nginx.conf是nginx服务器的最核心最主要的配置文件，其他的.conf则是用来配置nginx相关的功能的，例如fastcgi功能使用的是fastcgi.conf和fastcgi_params 两个文件，配置文件一般都有一个样板配置文件，是以.default为后缀，使用时可将其复制并将default后缀去掉即可。

html目录中保存了nginx服务器的web文件，但是可以更改为其他目录保存web文件,另外还有一个50x的web 文件是默认的错误页面提示页面。

logs：用来保存nginx服务器的访问日志错误日志等日志，logs目录可以放在其他路径，比如/var/logs/nginx里面。

sbin：保存nginx二进制启动脚本，可以接受不同的参数以实现不同的功能。

二、验证版本及编译参数

$root@Nginx \~$ # vim ~/.bash_profile

export PATH=$PATH:/usr/local/nginx/sbin

$root@Nginx \~$ # source ~/.bash_profile

$root@Nginx \~$ # nginx -V

nginx version: nginx/1.24.0

三、Nginx 启动文件

$root@Nginx \~$ # vim /lib/systemd/system/nginx.service

$root@Nginx \~$ # systemctl daemon-reload

$root@Nginx \~$ # systemctl start nginx

四、平滑升级和回滚

有时候我们需要对Nginx版本进行升级以满足对其功能的需求，例如添加新模块，需要新功能，而此时 Nginx又在跑着业务无法停掉，这时我们就可能选择平滑升级。

4.1 平滑升级流程

将旧Nginx二进制文件换成新Nginx程序文件（注意先备份)
向master进程发送USR2信号
master进程修改pid文件名加上后缀.oldbin,成为nginx.pid.oldbin
master进程用新Nginx文件启动新master进程成为旧master的子进程,系统中将有新旧两个Nginx主进程共同提供Web服务,当前新的请求仍然由旧Nginx的worker进程进行处理,将新生成的master进程的PID存放至新生成的pid文件nginx.pid
向旧的Nginx服务进程发送WINCH信号，使旧的Nginx worker进程平滑停止
向旧master进程发送QUIT信号，关闭老master，并删除Nginx.pid.oldbin文件
如果发现升级有问题,可以回滚∶向老master发送HUP，向新master发送QUIT

4.2 将nginx-1.24.0平滑升级成nginx-1.26.2

1、将nginx-1.26.2.tar.gz和echo-nginx-module-0.63.tar放进/nginx目录里，并解压

$root@Nginx nginx$ # tar zxf nginx-1.26.2.tar.gz

$root@Nginx nginx$ # tar zxf echo-nginx-module-0.63.tar

2、开始编译新版本

$root@Nginx nginx$ # cd nginx-1.26.2/

$root@Nginx nginx$ # ./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --add-module=/nginx/echo-nginx-module-0.63 --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_stub_status_module --with-http_gzip_static_module --with-pcre --with-stream --with-stream_ssl_module --with-stream_realip_module

$root@Nginx nginx-1.26.2$ # make

#查看两个版本

$root@Nginx nginx-1.26.1$ # ll objs/nginx /usr/local/nginx/sbin/nginx

-rwxr-xr-x 1 root root 1239416 Jul 18 15:08 objs/nginx

-rwxr-xr-x 1 root root 5671488 Jul 18 11:41 /usr/local/nginx/sbin/nginx

3、把之前的旧版的nginx命令备份

$root@Nginx \~$ # cd /usr/local/nginx/sbin/

$root@Nginx sbin$ # cp nginx nginx.24

4、把新版本的nginx命令复制过去

$root@Nginx sbin$ # \cp -f /root/nginx/nginx-1.26.2/objs/nginx /usr/local/nginx/sbin

5、检查

$root@Nginx sbin$ # nginx -t

nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok

nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

6、开始平滑升级

$root@Nginx sbin$ # ps aux | grep nginx

USR2 平滑升级可执行程序,将存储有旧版本主进程PID的文件重命名为nginx.pid.oldbin，并启动新的 nginx。

此时两个master的进程都在运行,只是旧的master不在监听,由新的master监听80。

此时Nginx开启一个新的master进程，这个master进程会生成新的worker进程，这就是升级后的Nginx进程，此时老的进程不会自动退出，但是当接收到新的请求不作处理而是交给新的进程处理。

$root@Nginx sbin$ # kill -USR2 9511

$root@Nginx sbin$ # ps aux | grep nginx

$root@Nginx sbin$ # curl -I(大写i) localhost

这时候依旧是旧版本生效，需要回收旧版本的worker进程

$root@Nginx sbin$ # kill -WINCH 9511

$root@Nginx sbin$ # ps aux | grep nginx

$root@Nginx sbin$ # curl -I(大写i) localhost

到这里，平滑升级就完成啦！

4.3 回滚

如果升级的版本发现问题需要回滚,可以重新拉起旧版本的worker。

1、将备份好的nginx.26覆盖nginx

$root@Nginx sbin$ # cp nginx nginx.26

$root@Nginx sbin$ # ls nginx nginx.24 nginx.26

$root@Nginx sbin$ # mv nginx.24 nginx

mv: overwrite 'nginx'? y

2、重新换醒旧版本的worker进程：

$root@Nginx sbin$ # kill -WINCH 9511

3、回收新版本的worker进程

$root@Nginx sbin$ # kill -WINCH 12893

这时候就回滚到旧版本啦。