平滑升级和回滚
-
-
- [1. 平滑升级流程](#1. 平滑升级流程)
- [2. 平滑升级和回滚案例](#2. 平滑升级和回滚案例)
-
有时候我们需要对Nginx版本进行升级以满足对其功能的需求，例如添加新模块，需要新功能，而此时 Nginx又在跑着业务无法停掉，这时我们就可能选择平滑升级
1. 平滑升级流程
- 平滑升级四个阶段
- 只有旧版nginx的master和worker进程
- 旧版和新版nginx的master和worker进程并存,由旧版nginx接收处理用户的新请求
- 旧版和新版nginx的master和worker进程并存,由新版nginx接收处理用户的新请求
- 只有新版nginx的master和worker进程
bash
将旧Nginx二进制文件换成新Nginx程序文件（注意先备份)
向master进程发送USR2信号启动新nginx进程
master进程修改pid文件名加上后缀.oldbin,成为nginx.pid.oldbin
master进程用新Nginx文件启动新master进程及worker子进程成为旧master的子进程
系统中将有新旧两个Nginx主进程和对应的worker子进程并存
当前新的请求仍然由旧Nginx的worker进程进行处理
将新生成的master进程的PID存放至新生成的pid文件nginx.pid
向旧的Nginx服务进程发送WINCH信号，使旧的Nginx worker进程平滑停止
向旧master进程发送QUIT信号，关闭旧master，并删除Nginx.pid.oldbin文件
如果发现升级有问题,可以回滚∶向旧master发送HUP，向新master发送QUIT2. 平滑升级和回滚案例
bash
# 在nginx编译安装的基础上（可以参考编译安装脚本）
# 下载最新稳定版
[root@Ubuntu2204 ~]#wget https://nginx.org/download/nginx-1.26.1.tar.gz
[root@Ubuntu2204 ~]#tar xvf nginx-1.26.1.tar.gz
[root@Ubuntu2204 ~]#cd nginx-1.26.1/
# 查看当前使用的版本及编译选项
[root@Ubuntu2204 nginx-1.26.1]#nginx -V
nginx version: nginx/1.22.1
built by gcc 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04)
built with OpenSSL 3.0.2 15 Mar 2022
TLS SNI support enabled
configure arguments: --prefix=/apps/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
# configure arguments后面是以前编译时的参数。现在编译使用一样的参数
# 开始编译新版本
[root@Ubuntu2204 nginx-1.26.1]#./configure --prefix=/apps/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
# 只要make无需要make install
[root@Ubuntu2204 nginx-1.26.1]#objs/nginx -v
nginx version: nginx/1.26.1
# 查看两个版本
[root@Ubuntu2204 nginx-1.26.1]#ll objs/nginx /apps/nginx/sbin/nginx
-rwxr-xr-x 1 nginx nginx 5884536 Jul 12 09:43 /apps/nginx/sbin/nginx*
-rwxr-xr-x 1 root root 6013648 Jul 12 10:04 objs/nginx*
# 把之前的旧版的nginx命令备份
[root@Ubuntu2204 nginx-1.26.1]#cp /apps/nginx/sbin/nginx /opt/nginx.old
# 把新版本的nginx命令复制过去覆盖旧版本程序文件,注意:需要加 -f 选项强制覆盖,否则会提示Text file busy
[root@Ubuntu2204 nginx-1.26.1]#cp -f ./objs/nginx /apps/nginx/sbin/
# 检测一下有没有问题
[root@Ubuntu2204 nginx-1.26.1]#/apps/nginx/sbin/nginx -t
nginx: the configuration file /apps/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /apps/nginx/conf/nginx.conf test is successful
# 发送信号USR2 平滑升级可执行程序,将存储有旧版本主进程PID的文件重命名为nginx.pid.oldbin，并启动新的nginx
# 此时两个master的进程都在运行,只是旧的master不在监听,由新的master监听80
# 此时Nginx开启一个新的master进程，这个master进程会生成新的worker进程，这就是升级后的Nginx进程，此时老的进程不会自动退出，但是当接收到新的请求不作处理而是交给新的进程处理。
[root@Ubuntu2204 nginx-1.26.1]#kill -USR2 `cat /apps/nginx/logs/nginx.pid`
# 可以看到两个master,新的master是旧版master的子进程,并生成新版的worker进程
[root@Ubuntu2204 ~]#ps auxf | grep nginx
root 904 0.0 0.0 10168 944 ? Ss 09:48 0:00 nginx: master process /apps/nginx/sbin/nginx
nginx 906 0.0 0.1 10904 3684 ? S 09:48 0:00 \_ nginx: worker process
root 5234 0.0 0.3 10188 6416 ? S 10:15 0:00 \_ nginx: master process /apps/nginx/sbin/nginx
nginx 5235 0.0 0.1 10924 3716 ? S 10:15 0:00 \_ nginx: worker process
root 5240 0.0 0.1 6480 2240 pts/1 S+ 10:16 0:00 | \_ grep --color=auto nginx
[root@Ubuntu2204 ~]#lsof -i :80
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
nginx 904 root 6u IPv4 31463 0t0 TCP *:http (LISTEN)
nginx 906 nginx 6u IPv4 31463 0t0 TCP *:http (LISTEN)
nginx 5234 root 6u IPv4 31463 0t0 TCP *:http (LISTEN)
nginx 5235 nginx 6u IPv4 31463 0t0 TCP *:http (LISTEN)
# 先关闭旧nginx的worker进程,而不关闭nginx主进程方便回滚
# 向原Nginx主进程发送WINCH信号，它会逐步关闭旗下的工作进程（主进程不退出），这时所有请求都会由新版Nginx处理
[root@Ubuntu2204 nginx-1.26.1]#kill -WINCH `cat /apps/nginx/logs/nginx.pid.oldbin`
# 如果旧版worker进程有用户的请求,会一直等待处理完后才会关闭
[root@Ubuntu2204 ~]#ps auxf | grep nginx
root 904 0.0 0.0 10168 944 ? Ss 09:48 0:00 nginx: master process /apps/nginx/sbin/nginx
root 5234 0.0 0.3 10188 6416 ? S 10:15 0:00 \_ nginx: master process /apps/nginx/sbin/nginx
nginx 5235 0.0 0.1 10924 3716 ? S 10:15 0:00 \_ nginx: worker process
##################### 注意：此处如果是虚拟机先做快照方便回滚 ####################
# 经过一段时间测试，新版本服务没问题，最后发送QUIT信号,退出老的master
[root@Ubuntu2204 nginx-1.26.1]#kill -QUIT `cat /apps/nginx/logs/nginx.pid.oldbin`
# 查看版本是不是已经是新版了
[root@Ubuntu2204 nginx-1.26.1]#nginx -v
nginx version: nginx/1.26.1
[root@Ubuntu2204 nginx-1.26.1]#curl -I 127.0.0.1
HTTP/1.1 200 OK
Server: nginx/1.26.1
Date: Fri, 12 Jul 2024 02:28:11 GMT
Content-Type: text/html
Content-Length: 615
Last-Modified: Fri, 12 Jul 2024 01:43:39 GMT
Connection: keep-alive
ETag: "66908a4b-267"
Accept-Ranges: bytes
bash
# 回滚 （虚拟机恢复之前做的快照）
[root@Ubuntu2204 ~]#ps aux | grep nginx
root 904 0.0 0.0 10168 944 ? Ss 09:51 0:00 nginx: master process /apps/nginx/sbin/nginx
root 5234 0.0 0.3 10188 6416 ? S 10:18 0:00 nginx: master process /apps/nginx/sbin/nginx
nginx 5235 0.0 0.1 10924 3716 ? S 10:18 0:00 nginx: worker process
root 5659 0.0 0.1 6612 2252 pts/3 S+ 10:31 0:00 grep --color=auto nginx
# 如果升级的版本发现问题需要回滚,可以发送HUP信号,重新拉起旧版本的worker
[root@Ubuntu2204 ~]#kill -HUP `cat /apps/nginx/logs/nginx.pid.oldbin`
[root@Ubuntu2204 ~]#ps aux | grep nginx
root 904 0.0 0.0 10168 944 ? Ss 09:51 0:00 nginx: master process /apps/nginx/sbin/nginx
root 5234 0.0 0.3 10188 6416 ? S 10:18 0:00 nginx: master process /apps/nginx/sbin/nginx
nginx 5235 0.0 0.1 10924 3716 ? S 10:18 0:00 nginx: worker process
nginx 5661 0.0 0.1 10904 3684 ? S 10:32 0:00 nginx: worker process
root 5663 0.0 0.1 6612 2240 pts/3 S+ 10:32 0:00 grep --color=auto nginx
[root@Ubuntu2204 ~]#pstree -p | grep nginx
|-nginx(904)-+-nginx(5234)---nginx(5235)
| `-nginx(5661)
# 最后关闭新版的master
[root@Ubuntu2204 ~]#kill -QUIT `cat /apps/nginx/logs/nginx.pid`
# 恢复旧版的文件
[root@Ubuntu2204 ~]#mv /opt/nginx.old /apps/nginx/sbin/nginx