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