nginx 命令和信号
nginx命令
nginx 命令支持向其发送信号,实现不同功能
nginx 格式
nginx [-?hvVtTq] [-s signal] [-c filename] [-p prefix] [-g directives]
选项说明
帮助: -? -h
使用指定的配置文件: -c
指定配置指令:-g
指定运行目录:-p
测试配置文件是否有语法错误:-t -T
打印nginx的版本信息、编译信息等:-v -V
发送信号: -s 示例: nginx -s reload
信号说明:
立刻停止服务:stop,相当于信号SIGTERM,SIGINT
优雅的停止服务:quit,相当于信号SIGQUIT
平滑重启，重新加载配置文件: reload,相当于信号SIGHUP
重新开始记录日志文件:reopen,相当于信号SIGUSR1,在切割日志时用途较大
平滑升级可执行程序:发送信号SIGUSR2,在升级版本时使用
优雅的停止工作进程:发送信号SIGWINCH,在升级版本时使用
范例: 查看nginx帮助
[root@centos8 ~]# nginx -h
nginx version: nginx/1.16.1
Usage: nginx [-?hvVtTq] [-s signal] [-c filename] [-p prefix] [-g directives]
Options:
-?,-h : this help
-v : show version and exit
-V : show version and configure options then exit
-t : test configuration and exit
-T : test configuration, dump it and exit
-q : suppress non-error messages during configuration testing
-s signal : send signal to a master process: stop, quit, reopen, reload
-p prefix : set prefix path (default: /usr/share/nginx/)
-c filename : set configuration file (default: /etc/nginx/nginx.conf)
-g directives : set global directives out of configuration file
quit 实现worker进程优雅关闭
关闭监听句柄
关闭空闲连接
在循环中等待全部连接关闭
退出nginx所有进程
reload 流程
利用 reload 可以实现平滑修改配置并生效
向master进程发送HUP信号(reload命令)
master进程校验配置语法是否正确
master进程打开新的监听端口
master进程用新配置启动新的worker子进程
master进程向老worker子进程发送QUIT信号，老的worker对已建立连接继续处理，处理完才会优
雅退出.未关闭的worker旧进程不会处理新来的请求
老worker进程关闭监听句柄，处理完当前连接后结束进程
平滑升级和回滚
有时候我们需要对Nginx版本进行升级以满足对其功能的需求，例如添加新模块，需要新功能，而此时
Nginx又在跑着业务无法停掉，这时我们就可能选择平滑升级
平滑升级流程
将旧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
平滑升级和回滚案例
#改pid存放路径
[root@sz-kx-centos8 ~/nginx-1.20.1]# vim /apps/nginx/conf/nginx.conf
pid /apps/nginx/run/nginx.pid;
#创建并授权
[root@sz-kx-centos8 ~/nginx-1.20.1]# mkdir -p /apps/nginx/run
[root@sz-kx-centos8 ~/nginx-1.20.1]# chown -R nginx.nginx /apps/nginx/run
重启服务
[root@sz-kx-centos8 ~/nginx-1.20.1]# systemctl restart nginx
[root@sz-kx-centos8 ~]# wget http://nginx.org/download/nginx-1.20.1.tar.gz
[root@sz-kx-centos8 ~]# tar xf nginx-1.20.1.tar.gz
[root@sz-kx-centos8 ~]# cd nginx-1.20.1/
[root@sz-kx-centos8 ~/nginx-1.20.1]# nginx -V
nginx version: nginx/1.18.0
built by gcc 8.4.1 20200928 (Red Hat 8.4.1-1) (GCC)
built with OpenSSL 1.1.1g FIPS 21 Apr 2020
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
[root@sz-kx-centos8 ~/nginx-1.20.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@sz-kx-centos8 ~/nginx-1.20.1]# make
[root@sz-kx-centos8 ~/nginx-1.20.1]# objs/nginx -v
nginx version: nginx/1.20.1
#查看两个版本
[root@sz-kx-centos8 ~/nginx-1.20.1]# ll objs/nginx /apps/nginx/sbin/nginx
-rwxr-xr-x 1 root root 7595024 Jun 9 22:10 /apps/nginx/sbin/nginx
-rwxr-xr-x 1 root root 7727184 Jun 10 14:58 objs/nginx
#把之前的旧版的nginx命令备份
[root@sz-kx-centos8 ~/nginx-1.20.1]# mv /apps/nginx/sbin/nginx{,.bak}
#把新版本的nginx命令复制过去
[root@sz-kx-centos8 ~/nginx-1.20.1]# cp objs/nginx /apps/nginx/sbin/
#检测一下有没有问题
[root@sz-kx-centos8 ~/nginx-1.20.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@sz-kx-centos8 ~]# cat /apps/nginx/run/nginx.pid
9240
[root@sz-kx-centos8 ~]# ps auxf | grep nginx
root 9309 0.0 0.0 12108 1064 pts/0 S+ 15:30 0:00 \_ grep --color=auto nginx
root 9240 0.0 0.2 41192 3836 ? Ss 15:28 0:00 nginx: master process /apps/nginx/sbin/nginx
nginx 9278 0.0 0.2 74272 4488 ? S 15:29 0:00 \_ nginx: worker process
[root@sz-kx-centos8 ~]# kill -USR2 `cat /apps/nginx/run/nginx.pid`
[root@sz-kx-centos8 ~]# ps auxf | grep nginx
root 9333 0.0 0.0 12108 1080 pts/0 S+ 15:31 0:00 \_ grep --color=auto nginx
root 9240 0.0 0.2 41192 3836 ? Ss 15:28 0:00 nginx: master process /apps/nginx/sbin/nginx
nginx 9278 0.0 0.2 74272 4488 ? S 15:29 0:00 \_ nginx: worker process
root 9330 0.0 0.3 41060 5924 ? S 15:31 0:00 \_ nginx: master process /apps/nginx/sbin/nginx
nginx 9331 0.0 0.2 74144 4436 ? S 15:31 0:00 \_ nginx: worker process
#先关闭旧nginx的worker进程,而不关闭nginx主进程方便回滚
#向原Nginx主进程发送WINCH信号，它会逐步关闭旗下的工作进程（主进程不退出），这时所有请求都会由新版Nginx处理
[root@sz-kx-centos8 ~]# ll /apps/nginx/run/nginx.pid
-rw-r--r-- 1 root root 5 Jun 10 15:31 /apps/nginx/run/nginx.pid
[root@sz-kx-centos8 ~]# kill -WINCH `cat /apps/nginx/run/nginx.pid.oldbin`
#如果旧版worker进程有用户的请求,会一直等待处理完后才会关闭
[root@sz-kx-centos8 ~]# ps auxf | grep nginx
root 13947 0.0 0.0 12108 980 pts/0 S+ 16:10 0:00 \_ grep --color=auto nginx
root 9240 0.0 0.2 41192 3836 ? Ss 15:28 0:00 nginx: master process /apps/nginx/sbin/nginx
root 9330 0.0 0.3 41060 5924 ? S 15:31 0:00 \_ nginx: master process /apps/nginx/sbin/nginx
nginx 9331 0.0 0.2 74144 4436 ? S 15:31 0:00 \_ nginx: worker process
#经过一段时间测试，新版本服务没问题，最后退出老的master（慎重操作）
[root@sz-kx-centos8 ~]# kill -QUIT `cat /apps/nginx/run/nginx.pid.oldbin`
[root@sz-kx-centos8 ~]# ps auxf | grep nginx
root 13972 0.0 0.0 12108 976 pts/0 S+ 16:11 0:00 \_ grep --color=auto nginx
root 9330 0.0 0.3 41060 5924 ? S 15:31 0:00 nginx: master process /apps/nginx/sbin/nginx
nginx 9331 0.0 0.2 74144 4436 ? S 15:31 0:00 \_ nginx: worker process
#查看版本是不是已经是新版了
[root@sz-kx-centos8 ~]# nginx -v
nginx version: nginx/1.20.1
##回滚（如果上面的已经操作 QUIT就没有办法回滚了）
#如果升级的版本发现问题需要回滚,可以重新拉起旧版本的worker
[root@centos8 nginx-1.20.1]# kill -HUP `cat /apps/nginx/run/nginx.pid.oldbin`
#最后关闭新版的master
[root@centos8 nginx-1.20.1]# kill -QUIT `cat /apps/nginx/run/nginx.pid`