使用Supervisor守护Nginx进程

supervisor是个好工具。superviosr是一个Linux/Unix系统上的进程监控工具,Supervisor是用Python开发的一套通用的进程管理程序,能将一个普通的命令行进程变为后台daemon,并监控进程状态,异常退出时能自动重启。只要在supervisor的配置文件中,把要管理的进程的可执行文件的路径写进去即可。当子进程挂掉的时候,父进程可以准确获取子进程挂掉的信息的,可以选择是否自己启动和报警。supervisor还提供了一个功能,可以为supervisord或者每个子进程,设置一个非root的user,这个user就可以管理它对应的进程。

由于supervisor不能监控后台程序,而nginx默认是后台运行的,解决方法

第一种是直接在 nginx.conf 配置文件中增加 daemon off; 参数。

第二种则是在启动 Nginx 时追加命令,命令为:

/usr/sbin/nginx -g 'daemon off;'

command = /usr/local/bin/nginx 这个命令默认是后台启动,
加上-g ‘daemon off;’这个参数可解决这问题,这个参数的意思是在前台运行。

一、安装配置supervisor

apt install supervisor

新建Supervisor的Nginx配置文件 /etc/supervisor/conf.d/nginx.conf,文件如下:

; supervisor nginx config file

[program:nginx]
command = /usr/sbin/nginx -g 'daemon off;'
startsecs=0
autostart=true
autorestart=true
stdout_logfile=/var/log/nginx/nginx_sup.log
redirect_stderr=true
priority=10
stopasgroup=true
killasgroup=true
stopsignal=INT
startsecs=10
startretries=10

相关参数意义

[program: nginx]
;管理的子进程。后面的是名字,最好写的具有代表性,避免日后”认错“
command=/usr/local/nginx/sbin/nginx -g 'daemon off;'
;我们的要启动进程的命令路径,可以带参数。
directory=/root ;
;进程运行前,会先切换到这个目录
autorestart=true;
;设置子进程挂掉后自动重启的情况,有三个选项,false,unexpected和true。false表示无论什么情况下,都不会被重新启动;unexpected表示只有当进程的退出码不在下面的exitcodes里面定义的退出码的时候,才会被自动重启。当为true的时候,只要子进程挂掉,将会被无条件的重启
autostart=true ;
;如果是true的话,子进程将在supervisord启动后被自动启动,默认就是true
stderr_logfile=/home/work/super/nginx_error.log ;
;日志,没什么好说的
stdout_logfile=/home/work/super/nginx_stdout.log ;
;日志
environment=ASPNETCORE_ENVIRONMENT=Production ;
;这个是子进程的环境变量,默认为空
user=nginx ;
;可以用来管理该program的用户
stopsignal=INT
;进程停止信号,可以为TERM, HUP, INT, QUIT, KILL, USR1等,默认为TERM
startsecs=10 ;
;子进程启动多少秒之后,此时状态如果是running,我们认为启动成功了,默认值1
startretries=10 ; 当进程启动失败后,最大尝试的次数。当超过10次后,进程的状态变为FAIL,默认值3
stopasgroup=true
;这个东西主要用于,supervisord管理的子进程,这个子进程本身还有子进程。那么我们如果仅仅干掉supervisord的子进程的话,子进程的子进程有可能会变成孤儿进程。所以可以设置这个选项,把整个该子进程的整个进程组干掉。默认false

到这里基本就算是完成了,我们可以直接干掉nginx,然后再启动supervisor就可以了,它会自动把nginx启动起来

取消nginx默认的开机自动启动服务,以启用supervisor来托管nginx服务
关闭开机自动启动systemctl disable nginx
开机自动启动systemctl enable nginx

修改后记得更新 Supervisor 以及重启 Nginx 进程,命令:

$ supervisorctl reread # 重新读取配置
$ supervisorctl update # 更新配置
$ supervisorctl restart nginx # 重启 nginx
$ killall nginx # 杀掉所有的 nginx 进程

二、supervisorctrl操作命令

1、更新新的配置到supervisord
supervisorctl update

2、重新启动配置中的所有程序
supervisorctl reload

3、启动某个进程(program_name=你配置中写的程序名称)
supervisorctl start program_name

4、查看正在守候的进程
supervisorctl

5、停止某一进程 (program_name=你配置中写的程序名称)
supervisorctl stop program_name

6、重启某一进程 (program_name=你配置中写的程序名称)
supervisorctl restart program_name

7、停止全部进程
supervisorctl stop all

三、附录:supervisord配置文件详解

supervisord配置块详解:
– logfile:log文件路径
– logfile_maxbytes:log文件达到多少后自动进行轮转,单位是KB、MB、GB。如果设置为0则表示不限制日志文件大小
– logfile_backups:轮转日志备份的数量,默认是10,如果设置为0,则不备份
– loglevel:error、warn、info、debug、trace、blather、critical
– pidfile:pid文件路径
– umask:umask值,默认022
– nodaemon:如果设置为true,则supervisord在前台启动,而不是以守护进程启动
– minfds:supervisord在成功启动前可用的最小文件描述符数量,默认1024
– minprocs:supervisord在成功启动前可用的最小进程描述符数量,默认200
– nocleanup:防止supervisord在启动的时候清除已经存在的子进程日志文件
– childlogdir:自动启动的子进程的日志目录
– user:supervisord的运行用户
– directory:supervisord以守护进程运行的时候切换到这个目录
– strip_ansi:消除子进程日志文件中的转义序列
– environment:一个k/v对的list列表

supervisord program配置详解:
– command:启动程序使用的命令,可以是绝对路径或者相对路径
– process_name:一个python字符串表达式,用来表示supervisor进程启动的这个的名称,默认值是%(program_name)s
– numprocs:Supervisor启动这个程序的多个实例,如果numprocs>1,则process_name的表达式必须包含%(process_num)s,默认是1
– numprocs_start:一个int偏移值,当启动实例的时候用来计算numprocs的值
– priority:权重,可以控制程序启动和关闭时的顺序,权重越低:越早启动,越晚关闭。默认值是999
– autostart:如果设置为true,当supervisord启动的时候,进程会自动重启。
– autorestart:值可以是false、true、unexpected。false:进程不会自动重启,unexpected:当程序退出时的退出码不是exitcodes中定义的时,进程会重启,true:进程会无条件重启当退出的时候。
– startsecs:程序启动后等待多长时间后才认为程序启动成功
– startretries:supervisord尝试启动一个程序时尝试的次数。默认是3
– exitcodes:一个预期的退出返回码,默认是0,2。
– stopsignal:当收到stop请求的时候,发送信号给程序,默认是TERM信号,也可以是 HUP, INT, QUIT, KILL, USR1, or USR2。
– stopwaitsecs:在操作系统给supervisord发送SIGCHILD信号时等待的时间
– stopasgroup:如果设置为true,则会使supervisor发送停止信号到整个进程组
– killasgroup:如果设置为true,则在给程序发送SIGKILL信号的时候,会发送到整个进程组,它的子进程也会受到影响。
– user:如果supervisord以root运行,则会使用这个设置用户启动子程序
– redirect_stderr:如果设置为true,进程则会把标准错误输出到supervisord后台的标准输出文件描述符。
– stdout_logfile:把进程的标准输出写入文件中,如果stdout_logfile没有设置或者设置为AUTO,则supervisor会自动选择一个文件位置。
– stdout_logfile_maxbytes:标准输出log文件达到多少后自动进行轮转,单位是KB、MB、GB。如果设置为0则表示不限制日志文件大小
– stdout_logfile_backups:标准输出日志轮转备份的数量,默认是10,如果设置为0,则不备份
– stdout_capture_maxbytes:当进程处于stderr capture mode模式的时候,写入FIFO队列的最大bytes值,单位可以是KB、MB、GB
– stdout_events_enabled:如果设置为true,当进程在写它的stderr到文件描述符的时候,PROCESS_LOG_STDERR事件会被触发
– stderr_logfile:把进程的错误日志输出一个文件中,除非redirect_stderr参数被设置为true
– stderr_logfile_maxbytes:错误log文件达到多少后自动进行轮转,单位是KB、MB、GB。如果设置为0则表示不限制日志文件大小
– stderr_logfile_backups:错误日志轮转备份的数量,默认是10,如果设置为0,则不备份
– stderr_capture_maxbytes:当进程处于stderr capture mode模式的时候,写入FIFO队列的最大bytes值,单位可以是KB、MB、GB
– stderr_events_enabled:如果设置为true,当进程在写它的stderr到文件描述符的时候,PROCESS_LOG_STDERR事件会被触发
– environment:一个k/v对的list列表
– directory:supervisord在生成子进程的时候会切换到该目录
– umask:设置进程的umask
– serverurl:是否允许子进程和内部的HTTP服务通讯,如果设置为AUTO,supervisor会自动的构造一个url

发表评论

电子邮件地址不会被公开。 必填项已用*标注