Controlling nginx
控制nginx
- 更改配置
- 旋转型日志文件
- 即时升级可执行文件
nginx可以用信号来控制。 主进程的进程ID默认写入文件/usr/local/nginx/logs/nginx.pid。 这个名称可以在配置时更改，或者在nginx.conf中使用pid指令更改。 主进程支持以下信号：
| TERM，INT | 快速关机 |
|---|---|
| QUIT | 缓慢关机 |
| HUP | 更改配置，保持更改的时区（仅适用于FreeBSD和Linux），使用新配置启动新的工作进程，正常关闭旧的工作进程 |
| USR1 | 重新打开日志文件 |
| USR2 | 升级可执行文件 |
| WINCH | 正常关闭工作进程 |
个别工作进程也可以通过信号进行控制，尽管这不是必需的。支持的信号是：
| TERM，INT | 快速关机 |
|---|---|
| QUIT | 缓慢关机 |
| USR1 | 重新打开日志文件 |
| WINCH | 调试异常终止（需要启用debug_points） |
更改配置
为了让nginx重新读取配置文件，应该将一个HUP信号发送到主进程。主进程首先检查语法有效性，然后尝试应用新配置，即打开日志文件和新的侦听套接字。如果失败，它会回滚更改并继续使用旧配置。如果成功，它会启动新的工作进程，并向老工作进程发送消息，请求他们正常关闭。老工人进程关闭监听套接字并继续为老客户服务。在所有客户端都被服务之后，旧工作进程被关闭。
我们来举例说明这一点。想象一下，nginx在FreeBSD 4.x和命令上运行
ps axw -o pid,ppid,user,%cpu,vsz,wchan,command | egrep '(nginx|PID)'
产生以下输出：
PID PPID USER %CPU VSZ WCHAN COMMAND
33126 1 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
33127 33126 nobody 0.0 1380 kqread nginx: worker process (nginx)
33128 33126 nobody 0.0 1364 kqread nginx: worker process (nginx)
33129 33126 nobody 0.0 1364 kqread nginx: worker process (nginx)
如果HUP发送到主进程，则输出变为：
PID PPID USER %CPU VSZ WCHAN COMMAND
33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
33129 33126 nobody 0.0 1380 kqread nginx: worker process is shutting down (nginx)
33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
33135 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
PID 33129的旧流程之一仍然继续工作。一段时间后退出：
PID PPID USER %CPU VSZ WCHAN COMMAND
33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
33135 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
切换日志文件
为了切换日志文件，他们需要首先重命名。之后，发送USR1信号到主进程。然后，主进程将重新打开所有当前打开的日志文件，并将其作为所有者为其分配正在运行工作进程的非特权用户。成功重新打开后，主进程关闭所有打开的文件，并将消息发送给工作进程以要求他们重新打开文件。工作进程也会立即打开新文件并关闭旧文件。因此，旧文件几乎立即可用于后期处理，如压缩。
即时升级可执行文件
为了升级服务器可执行文件，应该先将新的可执行文件替换为旧文件。之后，USR2信号应发送到主进程。主进程首先使用进程标识将其文件重命名为带有.oldbin后缀的新文件，例如/usr/local/nginx/logs/nginx.pid.oldbin，然后启动一个新的可执行文件，然后启动新的工作进程：
PID PPID USER %CPU VSZ WCHAN COMMAND
33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
33135 33126 nobody 0.0 1380 kqread nginx: worker process (nginx)
33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
之后，所有工作进程（旧的和新的）继续接受请求。如果WINCH信号发送到第一个主进程，它将向其工作进程发送消息，请求它们正常关闭，并且它们将开始退出：
PID PPID USER %CPU VSZ WCHAN COMMAND
33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
33135 33126 nobody 0.0 1380 kqread nginx: worker process is shutting down (nginx)
36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
一段时间后，只有新的工作进程会处理请求：
PID PPID USER %CPU VSZ WCHAN COMMAND
33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
应该注意的是，旧的主进程没有关闭其侦听套接字，并且可以管理它，以便在需要时再次启动它的工作进程。如果由于某种原因新的可执行文件无法接受，可以采取以下措施之一：
- 将HUP信号发送到旧的主进程。旧的主进程将启动新的工作进程而不重新读取配置。之后，通过发送QUIT信号到新的主进程，所有新进程都可以正常关闭。
- 发送TERM信号到新的主进程。然后它会向其工作进程发送一条消息，要求他们立即退出，并且他们几乎立即退出。（如果新进程由于某种原因未退出，则应将KILL信号发送给它们以强制它们退出。）当新主进程退出时，旧主进程将自动启动新工作进程。
如果新的主进程退出，则旧的主进程将丢弃.oldbin具有进程ID的文件名后缀。
如果升级成功，则旧的主进程应该发送QUIT信号，并且只有新的进程将停留：
PID PPID USER %CPU VSZ WCHAN COMMAND
36264 1 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
