Supervisor快速入门 | 使用Supervisor守护Nginx进程

憧憬。 -

守护进程

在我们生产环境的时候，有些任务是不能停止的，否则业务就会受到影响，那么如何保证这些任务的高可用呢？那就需要用到我们的守护进程了，比方说我们的进程运行挂掉之后自动恢复等等，这些都可以利用工具来实现，针对不同的项目可以使用不同的工具。

例如PM2、Forever、 Python底层写的supervisor 等等...

Supervisor介绍

Supervisor 是一个客户端/服务器系统，允许其用户监视和控制类似UNIX的操作系统上的多个进程。

Supervisor 是用 Python 开发的一套通用的进程管理程序，能将一个普通的命令行进程变为后台daemon，并监控进程状态，异常退出时能自动重启。

它是通过fork/exec的方式把这些被管理的进程当作supervisor的子进程来启动，这样只要在supervisor的配置文件中，把要管理的进程的可执行文件的路径写进去即可。也实现当子进程挂掉的时候，父进程可以准确获取子进程挂掉的信息的，可以选择是否自己启动和报警。supervisor还提供了一个功能，可以为supervisord或者每个子进程，设置一个非root的user，这个user就可以管理它对应的进程。

但是需要注意 Supervisor 完全不会在任何Windows版本下运行，它依赖于 Python ， 它适用于Python 3 3.4版或更高版本以及Python 2版本2.7。

更多可以查看Supervisor官网

Supervisor安装

  • Debian/Ubuntu可通过apt安装
sudo apt-get install supervisor
  • yum安装
yum install supervisor
  • pip安装
pip install supervisor
  • easy_install 安装
easy_install supervisor

Supervisor配置

Supervisor 基础配置可以在 /etc/supervisor/supervisord.conf 进行配置

任务配置通常存放在 /etc/supervisor/conf.d 目录，在该目录下，可以创建多个配置文件指示 Supervisor 如何监视进程

supervisor.conf 说明

[unix_http_server]
file=/tmp/supervisor.sock   ;UNIX socket 文件，supervisorctl 会使用
;chmod=0700                 ;socket文件的mode，默认是0700
;chown=nobody:nogroup       ;socket文件的owner，格式：uid:gid
 
;[inet_http_server]         ;HTTP服务器，提供web管理界面
;port=127.0.0.1:9001        ;Web管理后台运行的IP和端口，如果开放到公网，需要注意安全性
;username=user              ;登录管理后台的用户名
;password=123               ;登录管理后台的密码
 
[supervisord]
logfile=/tmp/supervisord.log ;日志文件，默认是 $CWD/supervisord.log
logfile_maxbytes=50MB        ;日志文件大小，超出会rotate，默认 50MB，如果设成0，表示不限制大小
logfile_backups=10           ;日志文件保留备份数量默认10，设为0表示不备份
loglevel=info                ;日志级别，默认info，其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid 文件
nodaemon=false               ;是否在前台启动，默认是false，即以 daemon 的方式启动
minfds=1024                  ;可以打开的文件描述符的最小值，默认 1024
minprocs=200                 ;可以打开的进程数的最小值，默认 200
 
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ;通过UNIX socket连接supervisord，路径与unix_http_server部分的file一致
;serverurl=http://127.0.0.1:9001 ; 通过HTTP的方式连接supervisord
 
;包含其它配置文件 
[include]
files = /etc/supervisor/conf.d/*.conf    ;这里也就是包含了我们的任务配置

配置nginx守护进程

这里有个坑

语法: daemon on | off
缺省值: on
Do not use the “daemon” and “master_process” directives in a production mode, these options are mainly used for development only. You can use daemon off

大意：在生产环境中 daemon 和 master_process 配置均不可使用，仅用于开发测试。

为了方便开发测试 Nginx 的 daemon 参数默认值为 on。

如果大家使用 Docker 看过 Nginx 镜像的 Dockerfile 你就明白这个

启动容器时直接配置了 daemon off

所以咱们在配置 supervisor 的时候需要注意啦

  • 配置解释
[program:nginx] #  设置进程的名称，使用 supervisorctl 来管理进程时需要使用该进程名 我这里就叫做nginx了!
command=/usr/sbin/nginx -g 'daemon off;' # 需要执行的命令
directory=/etc/nginx # 命令执行的目录或者说执行 command 之前，先切换到工作目录 可以理解为在执行命令前会切换到这个目录 在我这基本没啥用
autostart=true #是否自动启动
autorestart=true #程序意外退出是否自动重启
redirect_stderr=true # 如果为true，则stderr的日志会被写入stdout日志文件中  理解为重定向输出的日志
priority=10 # 启动优先级
stdout_logfile=/data/logs/supervisord/nginx.log # 子进程的stdout的日志路径 输出日志文件
stderr_logfile=/data/logs/supervisord/nginx.err.log # 错误日志文件 当redirect_stderr=true。这个就不用
  • 最终配置 /etc/supervisor/conf.d/nginx.conf
[program:nginx]
command=/usr/sbin/nginx -g 'daemon off;'
directory=/etc/nginx
autostart=true
autorestart=true
redirect_stderr=true
priority=10
stdout_logfile=/data/logs/supervisord/nginx.log

修改后更新 Supervisor

supervisorctl reread # 重新读取配置
supervisorctl update # 更新配置
supervisorctl restart nginx  # 重启 nginx
killall nginx  # 杀掉所有的 nginx 进程. 已经杀不死了 说明守护进程配置成功
  • 查看一下任务 ok
supervisorctl status

本文为作者原创，手码不易，允许转载，转载后请以链接形式说明文章出处。