发送信号控制 nginx

举报
lxw1844912514 发表于 2022/03/27 03:07:31 2022/03/27
【摘要】 目录 修改配置滚动日志文件在运行中升级可执行文件 可通过发送信号给 nginx 进行控制。nginx 主进程的 PID 默认被写入 /usr/local/nginx/logs/nginx.pid。 pid 文件的路径被可在配置时修改,使用 pid 指令指定其他路径。nginx 主进程支持如下信号:   TERM, INT...

目录

  • 修改配置
  • 滚动日志文件
  • 在运行中升级可执行文件

可通过发送信号给 nginx 进行控制。nginx 主进程的 PID 默认被写入 /usr/local/nginx/logs/nginx.pid
pid 文件的路径被可在配置时修改,使用 pid 指令指定其他路径。nginx 主进程支持如下信号:

 


  
  1. TERM, INT 快速关闭 nginx
  2. QUIT 优雅地关闭 nginx
  3. HUP 修改配置,keeping up with a changed time zone (only for FreeBSD and Linux),
  4. 以新配置启动新的 worker 进程,优雅地关闭老的 worker 进程。
  5. USR1 重新打开日志文件
  6. USR2 升级可执行文件
  7. WINCH 优雅地关闭 worker 进程

也可发送信号给某个 worker 进程,支持的信号有:

 


  
  1. TERM, INT 快速关闭 nginx
  2. QUIT 优雅地关闭 nginx
  3. USR1 重新打开日志文件
  4. WINCH 为调试bug,非正常地关闭 worker 进程(需在配置中使用 debug_points 指令)

修改配置


要让 nginx 重新加载配置文件,需要给 nginx 主进程发送一个 HUP 信号。nginx 主进程收到信号之后,首先检查配置的语法,然后尝试应用新配置,比如:打开日志文件,或者建立新的监听套接字。如果应用新配置失败,nginx 对改动进行回滚,并继续以旧的配置进行工作。如果成功,nginx 启动新的 worker 进程,并发送关闭消息给旧的 worker 进程要求它们优雅地关闭。旧的 worker 进程关闭监听套接字,并继续完成当前的用户请求,等用户的请求完成后,就会关闭。

我们以一个例子来演示这个过程,在 Linux 中执行:
ps axw -o pid,ppid,user,%cpu,vsz,wchan,command | egrep '(nginx|PID)'

该命令生成如下输出:

 


  
  1. PID PPID USER %CPU VSZ WCHAN COMMAND
  2. 5638 1 root 0.0 45116 rt_sig nginx: master process nginx
  3. 5960 5638 nginx 0.0 45356 ep_pol nginx: worker process

当发送一个 HUP 信号给 nginx 主进程
kill -s HUP 6538

执行 ps 命令,可看到 worker 进程的 PID 改变了,输出改变为:

 


  
  1. PID PPID USER %CPU VSZ WCHAN COMMAND
  2. 5638 1 root 0.0 45116 rt_sig nginx: master process nginx
  3. 6302 5638 nginx 0.0 45564 ep_pol nginx: worker process

执行 kill -s HUP 6538 的效果与重新加载 nginx 配置的命令相同:
nginx -s reload

滚动日志


滚动日志之前,日志需要被重命名,然后发送 USR1 信号给 nginx 主进程。主进程 re-open 当前所有已经打开的日志文件,并以 worker 进程当前的用户身份,给重新打开的日志文件定义 owner 身份(chown)。成功 re-open 之后,主进程关闭所有打开的日志文件,并发送消息给 worker 进程要求它 re-open 日志文件。worker 进程也会打开新的日志文件,并立即关闭旧的日志文件。之后,对旧的日志文件就可以进行推送处理,
比如进行压缩处理。

示例:

cd 到日志目录:

 


  
  1. [root@lamp1 nginx]# cd /var/log/nginx
  2. [root@lamp1 nginx]# ls
  3. access.log error.log

重命名 access.log 文件为 access.log.1,执行 nginx -s reopen 命令,查看滚动日志情况:

 


  
  1. [root@lamp1 nginx]# mv access.log access.log.1
  2. [root@lamp1 nginx]# nginx -s reopen
  3. [root@lamp1 nginx]# ls
  4. access.log access.log.1 error.log

重命名 error.log 文件为 error.log.1,执行 nginx -s reopen 命令,查看滚动日志情况:

 


  
  1. [root@lamp1 nginx]# mv error.log error.log.1
  2. [root@lamp1 nginx]# nginx -s reopen
  3. [root@lamp1 nginx]# ls
  4. access.log access.log.1 error.log error.log.1

注:kill -s HUPnginx -s reopen 效果相同。

查看日志文件的属主,为 nginx,nginx 是 worker 进程的执行身份,看看前面“修改配置”小节的 ps 命令输出:

 


  
  1. [root@lamp1 nginx]# ll
  2. total 12
  3. -rw-r--r-- 1 nginx root 0 Jun 29 07:58 access.log
  4. -rw-r--r-- 1 nginx root 4055 Jun 28 17:29 access.log.1
  5. -rw-r--r-- 1 nginx root 63 Jun 29 07:59 error.log
  6. -rw-r--r-- 1 nginx root 1260 Jun 29 07:58 error.log.1

在运行中升级可执行文件


为升级 nginx 可执行程序,首先将旧的 nginx 可执行文件替换为新的可执行文件,然后发送 USR2 信号给 nginx 主进程。nginx 主进程第一步会重命名 pid 文件,给原来的 pid 文件添加 .oldbin 后缀,比如 /usr/local/nginx/logs/nginx.pid.oldbin,然后启动新 nginx 可执行文件并依次启动新的 worker 进程。

 


  
  1. PID PPID USER %CPU VSZ WCHAN COMMAND
  2. 33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
  3. 33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
  4. 33135 33126 nobody 0.0 1380 kqread nginx: worker process (nginx)
  5. 33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
  6. 36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
  7. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  8. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  9. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

这时新旧 worker 进程都继续接受请求。如果将 WIHCH 信号发送给第一个主进程,它会发送消息给它的 worker 进程,要求他们优雅地关闭,之后第一个主进程的 worker 进程开始退出:

 


  
  1. PID PPID USER %CPU VSZ WCHAN COMMAND
  2. 33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
  3. 33135 33126 nobody 0.0 1380 kqread nginx: worker process is shutting down (nginx)
  4. 36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
  5. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  6. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  7. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

过一会儿之后,只有新的 worker 进程继续处理请求:

 


  
  1. PID PPID USER %CPU VSZ WCHAN COMMAND
  2. 33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
  3. 36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
  4. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  5. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  6. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

应注意的是,旧的主进程不会关闭它的监听套接字,并可在需要时重新启动它的 worker 进程。如果因为某些原因新的可执行文件不能正确工作,可采用下列的其中一种方法:

  • 发送 HUP 信号给旧的主进程。旧的主进程会启动新的 worker 进程,但不会重读配置文件。之后,可发送 QUIT 信号给新主进程,让所有新主进程的 worker 进程优雅地关闭。

  • 发送 TERM 信号给新主进程。新主进程收到 TERM 信号之后,会发送消息给它的 worker 进程,要求他们立即退出,之后这些 worker 进程将立即退出。(如果 worker 进程因为某些原因不能立即退出,应发送 KILL 信号令其强制性地退出)当新主进程退出后,旧主进程会自动启动新的 worker 进程。

如果新主进程退出,旧主进程会将 pid 文件的 .oldbin 后缀删除。

如果升级成功完成,应发送 QUIT 信号关闭旧主进程,只留下新主进程:

 


  
  1. PID PPID USER %CPU VSZ WCHAN COMMAND
  2. 36264 1 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
  3. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  4. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
  5. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

 

文章来源: blog.csdn.net,作者:lxw1844912514,版权归原作者所有,如需转载,请联系作者。

原文链接:blog.csdn.net/lxw1844912514/article/details/104599632

【版权声明】本文为华为云社区用户转载文章,如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。