一、supervisor简介

Supervisor是用Python开发的一套通用的过程管理程序，能将一个一般的命令行过程变为后盾daemon，并监控过程状态，异样退出时能主动重启。它是通过fork/exec的形式把这些被治理的过程当作supervisor的子过程来启动，这样只有在supervisor的配置文件中，把要治理的过程的可执行文件的门路写进去即可。也实现当子过程挂掉的时候，父过程能够精确获取子过程挂掉的信息的，能够抉择是否本人启动和报警。supervisor还提供了一个性能，能够为supervisord或者每个子过程，设置一个非root的user，这个user就能够治理它对应的过程。

注：本文以centos7为例，supervisor版本3.4.0。

二、supervisor装置

  • 配置好yum源后，能够间接装置

    yum install supervisor

  • Debian/Ubuntu可通过apt装置

    apt-get install supervisor

  • pip装置

    pip install supervisor

  • easy_install装置

    easy_install supervisor

三、supervisor应用

supervisor配置文件：/etc/supervisord.conf

注：supervisor的配置文件默认是不全的，不过在大部分默认的状况下，下面说的基本功能曾经满足。

子过程配置文件门路：/etc/supervisord.d/

注：默认子过程配置文件为ini格局，可在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.loglogfile_maxbytes=50MB        ;日志文件大小，超出会rotate，默认 50MB，如果设成0，示意不限度大小logfile_backups=10           ;日志文件保留备份数量默认10，设为0示意不备份loglevel=info                ;日志级别，默认info，其它: debug,warn,tracepidfile=/tmp/supervisord.pid ;pid 文件nodaemon=false               ;是否在前台启动，默认是false，即以 daemon 的形式启动minfds=1024                  ;能够关上的文件描述符的最小值，默认 1024minprocs=200                 ;能够关上的过程数的最小值，默认 200 [supervisorctl]serverurl=unix:///tmp/supervisor.sock ;通过UNIX socket连贯supervisord，门路与unix_http_server局部的file统一;serverurl=http://127.0.0.1:9001 ; 通过HTTP的形式连贯supervisord ; [program:xx]是被治理的过程配置参数，xx是过程的名称[program:xx]command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run  ; 程序启动命令autostart=true       ; 在supervisord启动的时候也主动启动startsecs=10         ; 启动10秒后没有异样退出，就示意过程失常启动了，默认为1秒autorestart=true     ; 程序退出后主动重启,可选值：[unexpected,true,false]，默认为unexpected，示意过程意外杀死后才重启startretries=3       ; 启动失败主动重试次数，默认是3user=tomcat          ; 用哪个用户启动过程，默认是rootpriority=999         ; 过程启动优先级，默认999，值小的优先启动redirect_stderr=true ; 把stderr重定向到stdout，默认falsestdout_logfile_maxbytes=20MB  ; stdout 日志文件大小，默认50MBstdout_logfile_backups = 20   ; stdout 日志文件备份数，默认是10; stdout 日志文件，须要留神当指定目录不存在时无奈失常启动，所以须要手动创立目录（supervisord 会主动创立日志文件）stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.outstopasgroup=false     ;默认为false,过程被杀死时，是否向这个过程组发送stop信号，包含子过程killasgroup=false     ;默认为false，向过程组发送kill信号，包含子过程 ;蕴含其它配置文件[include]files = relative/directory/*.ini    ;能够指定一个或多个以.ini完结的配置文件

子过程配置文件阐明：

给须要治理的子过程(程序)编写一个配置文件，放在/etc/supervisor.d/目录下，以.ini作为扩展名（每个过程的配置文件都能够独自分拆也能够把相干的脚本放一起）。如任意定义一个和脚本相干的项目名称的选项组（/etc/supervisord.d/test.conf）：

#我的项目名[program:blog]#脚本目录directory=/opt/bin#脚本执行命令command=/usr/bin/python /opt/bin/test.py#supervisor启动的时候是否随着同时启动，默认Trueautostart=true#当程序exit的时候，这个program不会主动重启,默认unexpected，设置子过程挂掉后主动重启的状况，有三个选项，false,unexpected和true。如果为false的时候，无论什么状况下，都不会被重新启动，如果为unexpected，只有当过程的退出码不在上面的exitcodes外面定义的autorestart=false#这个选项是子过程启动多少秒之后，此时状态如果是running，则咱们认为启动胜利了。默认值为1startsecs=1#脚本运行的用户身份 user = test#日志输入 stderr_logfile=/tmp/blog_stderr.log stdout_logfile=/tmp/blog_stdout.log #把stderr重定向到stdout，默认 falseredirect_stderr = true#stdout日志文件大小，默认 50MBstdout_logfile_maxbytes = 20M#stdout日志文件备份数stdout_logfile_backups = 20
子过程配置示例：
#阐明同上[program:test] directory=/opt/bin command=/opt/bin/testautostart=true autorestart=false stderr_logfile=/tmp/test_stderr.log stdout_logfile=/tmp/test_stdout.log #user = test

五、supervisor命令阐明

常用命令
supervisorctl status        //查看所有过程的状态supervisorctl stop es       //进行essupervisorctl start es      //启动essupervisorctl restart       //重启essupervisorctl update        //配置文件批改后应用该命令加载新的配置supervisorctl reload        //重新启动配置中的所有程序

注：把es换成all能够治理配置中的所有过程。间接输出supervisorctl进入supervisorctl的shell交互界面，此时下面的命令不带supervisorctl可间接应用。

注意事项

应用supervisor过程治理命令之前先启动supervisord，否则程序报错。
应用命令supervisord -c /etc/supervisord.conf启动。
若是centos7：

systemctl start supervisord.service     //启动supervisor并加载默认配置文件systemctl enable supervisord.service    //将supervisor退出开机启动项

##### 常见问题

  1. unix:///var/run/supervisor.sock no such file
    问题形容：装置好supervisor没有开启服务间接应用supervisorctl报的错
    解决办法：supervisord -c /etc/supervisord.conf
  2. command中指定的过程曾经起来，但supervisor还一直重启
    问题形容：command中启动形式为后盾启动，导致辨认不到pid，而后一直重启，这里应用的是elasticsearch，command指定的是$path/bin/elasticsearch -d
    解决办法：supervisor无奈检测后盾启动过程的pid，而supervisor自身就是后盾启动守护过程，因而不必放心这个
  3. 启动了多个supervisord服务，导致无奈失常敞开服务
    问题形容：在运行supervisord -c /etc/supervisord.conf之前，间接运行过supervisord -c /etc/supervisord.d/xx.conf导致有些过程被多个superviord治理，无奈失常敞开过程。
    解决办法：应用ps -fe | grep supervisord查看所有启动过的supervisord服务，kill相干的过程。
更多信息请移步Supervisor官网：http://supervisord.org