supervisor 守护多个进程_使用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

你可能感兴趣的:(supervisor,守护多个进程)