如何优雅的升级 Nginx(热部署)版本

1. 升级

1.1. 下载、编译新版本的 Nginx

1
2
3
4
5
➜  ~ wget https://nginx.org/download/nginx-1.15.6.tar.gz
➜ ~ tar zxvf nginx-1.15.6.tar.gz
➜ ~ cd nginx-1.15.6
➜ ~ ./configure --prefix=/usr/local/nginx
➜ ~ make

备份原 Nginx 二进制文件,并用新版本替换

1
2
➜  ~ cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.old
➜ ~ \cp -rf objs/nginx /usr/local/nginx/sbin/nginx

1.2. 切换 Nginx 的新老进程

1
2
3
4
5
➜  ~ cd /usr/local/nginx/sbin/
➜ ~ ps -ef | grep nginx
root 6680 1 0 12:17 ? 00:00:00 nginx: master process ./nginx
nobody 6681 6680 0 12:17 ? 00:00:00 nginx: worker process
root 31579 3601 0 12:28 pts/0 00:00:00 grep --color=auto nginx

向正在运行的老版本的 master 进程发送热部署信号

1
2
3
4
5
6
7
8
9
10
➜  ~ kill -USR2 6680

# Nginx 将使用新的二进制文件启动新版本的 master 和 worker 进程
# 并将所有用户请求平滑的过渡到新的进程
➜ ~ ps -ef | grep nginx
root 6680 1 0 12:17 ? 00:00:00 nginx: master process ./nginx
nobody 6681 6680 0 12:17 ? 00:00:00 nginx: worker process
root 31581 6680 0 12:29 ? 00:00:00 nginx: master process ./nginx
nobody 31582 31581 0 12:29 ? 00:00:00 nginx: worker process
root 31584 3601 0 12:29 pts/0 00:00:00 grep --color=auto nginx

向老版本的 master 进程发送信号,让其优雅关闭所有 worker 进程

1
2
3
4
5
6
➜  ~ kill -WINCH 6680
➜ ~ ps -ef | grep nginx
root 6680 1 0 12:17 ? 00:00:00 nginx: master process ./nginx
root 31581 6680 0 12:29 ? 00:00:00 nginx: master process ./nginx
nobody 31582 31581 0 12:29 ? 00:00:00 nginx: worker process
root 31587 3601 0 12:31 pts/0 00:00:00 grep --color=auto nginx

⚠️ 注意:老版本的 master 进程不会自动退出,以方便执行版本回退操作。当新版本稳定运行后,再发送信号退出老版本的 master 进程。

2. 版本回退

  1. 向老版本的 Nginx 进程发送信号,重启其 worker 进程

    1
    2
    3
    4
    5
    6
    7
    ➜  ~ kill -HUP 6680
    ➜ ~ ps -ef | grep nginx
    root 6680 1 0 12:17 ? 00:00:00 nginx: master process ./nginx
    root 31581 6680 0 12:29 ? 00:00:00 nginx: master process ./nginx
    nobody 31582 31581 0 12:29 ? 00:00:00 nginx: worker process
    nobody 31588 6680 0 12:35 ? 00:00:00 nginx: worker process
    root 31590 3601 0 12:35 pts/0 00:00:00 grep --color=auto nginx
  1. 等老版本的 Nginx worker 进程启动后,向新版本的 Nginx master 进程发送信号,让其退出打开的所有 worker 进程

    1
    2
    3
    4
    5
    6
    ➜  ~ kill -WINCH 31581
    ➜ ~ ps -ef | grep nginx
    root 6680 1 0 12:17 ? 00:00:00 nginx: master process ./nginx
    root 31581 6680 0 12:29 ? 00:00:00 nginx: master process ./nginx
    nobody 31588 6680 0 12:35 ? 00:00:00 nginx: worker process
    root 31590 3601 0 12:35 pts/0 00:00:00 grep --color=auto nginx
  2. 最后退出新版本的 master 进程

    1
    2
    3
    4
    5
    ➜  ~ kill -QUIT 31581
    ➜ ~ ps -ef | grep nginx
    root 6680 1 0 12:17 ? 00:00:00 nginx: master process ./nginx
    nobody 31588 6680 0 12:35 ? 00:00:00 nginx: worker process
    root 31592 3601 0 12:36 pts/0 00:00:00 grep --color=auto nginx