【NGINX 做平滑升级】

Nginx 平滑升级

nginx 方便地帮助我们实现了平滑升级。其原理简单概括，就是：

（1）在不停掉老进程的情况下，启动新进程。

（2）老进程负责处理仍然没有处理完的请求，但不再接受处理请求。

（3）新进程接受新请求。

（4）老进程处理完所有请求，关闭所有连接后，停止。

这样就很方便地实现了平滑升级。一般有两种情况下需要升级 nginx，一种是确实要升级 nginx 的版本，另一种是要为 nginx 添加新的模块。

多进程模式下的请求分配方式：

nginx 默认工作在多进程模式下，即主进程（master process）启动后完成配置加载和端口绑定等动作，fork()出指定数量的工作进程（worker process），这些子进程会持有监听端口的文件描述符（fd），并通过在该描述符上添加监听事件来接受连接。

1.Nginx 信号简介:

主进程支持的信号:

TERM, INT : 立刻退出
QUIT : 等待工作进程结束后再退出
KILL : 强制终止进程
HUP : 重新加载配置文件，使用新的配置启动工作进程，并逐步关闭旧进程。
USR1 : 重新打开日志文件
USR2 : 启动新的主进程，实现热升级
WINCH : 逐步关闭工作进程

工作进程支持的信号:

TERM, INT : 立刻退出
QUIT : 等待请求处理结束后再退出
USR1 : 重新打开日志文件

2.Nginx 平滑升级步骤：

1.查看现在的nginx编译参数：

2.把新版本的源码包，解压到/usr/local/

按照原来的编译参数安装 nginx 的方法进行安装，只需要到 make，千万不要 make install 。如果make install 会将原来的配置文件覆盖。

tar -xf nginx-1.25.4.tar.gz -C /usr/local/
cd /usr/local/nginx-1.25.4/

# ./configure  把/usr/local/nginx/sbin/nginx -V 下方的configure arguments:后面粘贴上去
./configure  \
--prefix=/usr/local/nginx --group=nginx --user=nginx \
--sbin-path=/usr/local/nginx/sbin/nginx --conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log \
--http-client-body-temp-path=/tmp/nginx/client_body \
--http-proxy-temp-path=/tmp/nginx/proxy --http-fastcgi-temp-path=/tmp/nginx/fastcgi \
--pid-path=/var/run/nginx.pid --lock-path=/var/lock/nginx \
--with-http_stub_status_module --with-http_ssl_module --with-http_gzip_static_module \
--with-pcre --with-http_realip_module --with-stream

# 直接make
make

3.备份原 nginx 二进制文件

备份老版本nginx二进制启动文件和 nginx 的配置文件（期间nginx不会停止服务）


mv /usr/local/nginx/sbin/nginx  /usr/local/nginx/sbin/nginx.old
# 把新版本的启动文件 复制到 /sbin/下
cp /usr/local/nginx-1.25.4/objs/nginx  /usr/local/nginx/sbin/

4.测试新版本是否正常：

/usr/local/nginx/sbin/nginx -t
/usr/local/nginx/sbin/nginx -V

5.给nginx发送平滑迁移信号（若不清楚pid路径，请查看nginx配置文件）：

# USR2: 启动新的主进程，实现热升级
kill -USR2 `cat /var/run/nginx.pid`

# 查看nginx pid，会出现一个nginx.pid.oldbin
ll /var/run/nginx.pid*

6.从容关闭旧的Nginx进程(WINCH: 逐步关闭工作work进程)：

kill -WINCH `cat /var/run/nginx.pid.oldbin`

# HUP: 重新加载配置文件，使用新的配置启动工作进程，并逐步关闭旧进程。
kill -HUP `cat /var/run/nginx.pid.oldbin`

7.结束工作进程，完成此次升级:

# QUIT: 等待请求处理结束后再退出
kill -QUIT `cat /var/run/nginx.pid.oldbin`

杀死旧版本的worker 进程 (生产环境勿用)

kill -9 4544

8.验证Nginx是否升级成功:

/usr/local/nginx/sbin/nginx -V

9.验证访问：

curl  -I localhost