一、supervisor简介
Supervisor是用Python开发的一套通用的进程管理程序，能将一个普通的命令行进程变为后台daemon，并监控进程状态，异常退出时能自动重启。它是通过fork/exec的方式把这些被管理的进程当作supervisor的子进程来启动，这样只要在supervisor的配置文件中，把要管理的进程的可执行文件的路径写进去即可。也实现当子进程挂掉的时候，父进程可以准确获取子进程挂掉的信息的，可以选择是否自己启动和报警。supervisor还提供了一个功能，可以为supervisord或者每个子进程，设置一个非root的user，这个user就可以管理它对应的进程。
二，安装方法
前面我们提到了Supervisor是Python的一个工具集，因此，安装方式有两种，一种是利用Python的包管理器pip安装，还一种就是yum安装啦。
（1）pip包管理器安装
pip install supervisor
（2）yum安装
yum安装需要配置epel源，epel源的配置通常是使用一个rpm包快速安装即可，例如：epel-release-7-13.noarch.rpm这样的rpm包，直接安装就有epel源了。
yum install supervisor -y
推荐使用yum的安装方式安装，有以下好处：1，有自启脚本 2，有配置文件示例， 总体来说，使用更方便。
三，Supervisor的web界面开启
vim /etc/supervisor.conf ,编辑该文件，其中有一段是被注释的，注释放开，按需修改即可（这个配置文件的注释符号是 ； 类似PHP）：
[inet_http_server] ; inet (TCP) server disabled by default port=*:9111 ; (ip_address:port specifier, *:port for all iface) username=zsk ; (default is no username (open server)) password=123456 ; (default is no password (open server))
这里用户名和密码可自己定义，端口也最好不适用默认端口，修改成一个不常用的端口，然后重启Supervisor服务即可。
systemctl restart supervisord
此时，打开浏览器，输入服务器IP地址:端口，然后在输入账号密码即可进入Supervisor的web管理界面。
很显然，现在的Supervisor才刚安装完毕，并没有任何项目可管理，那么，安装一个tomcat，然后使用Supervisor来进程守护吧。
四，二进制tomcat的安装
本例中使用的是apache-tomcat-7.0.62.tar.gz，将该文件上传服务器，解压后移动到/usr/local/tomcat即可，在此之前需要配置Java环境，Java快速安装脚本如下：
[root@master ~]# vim auto.sh #!/bin/bash tar -zxf `find / -name jdk-8u231-linux-x64.tar.gz` mv jdk1.8.0_231 /usr/local/jdk echo "JAVA_HOME=/usr/local/jdk PATH=.\$PATH:\$JAVA_HOME/bin CLASSPATH=\$JAVA_HOME/jre/lib/ext:\$JAVA_HOME/lib/tools.jar export CLASSPATH PATH JAVA_HOME">>/etc/profile source /etc/profile
编辑/usr/local/tomcat/bin/catalina.sh文件，添加环境变量：
export JAVA_HOME=/usr/local/jdk export CATALINA_HOME=/usr/local/tomcat #export CATALINA_PID=/usr/local/tomcat/catalina.pid export JRE_HOME=/usr/local/jdk/jre export PATH=$PATH:$CATALINA_HOME:$JAVA_HOME:$JRE_HOME export CLASSPATH=/usr/local/jdk/lib:/usr/local/jdk/jre/lib
五，Supervisor的tomcat子模块配置编写：
[root@master bin]# cat /etc/supervisord.d/tomcat.ini [program:tomcat] command=/usr/local/tomcat/bin/catalina.sh run ;启动运行的命令（前台运行） process_name=%(program_name)s ; 程序名称 numprocs=1 ; 复制的进程数 directory=/usr/local/tomcat ; 启动之后进入的目录 priority=1 ; 启动的相对优先级 autostart=true ; supervisord 启动后，也启动（默认跟随启动） startsecs=3 ; 程序持续运行3秒后任即为程序已经运行 startretries=3 ; 启动失败后最大的重启尝试次数，默认3次 autorestart=true ; 异常终止后，自启 exitcodes=0 ;异常退出错误码 stopsignal=QUIT ; 向进程发送kill 信号：默认TERM， stopwaitsecs=10 ; 结束后最大的等待时间 stopasgroup=true ; send stop signal to the UNIX process group (default false) killasgroup=true ; SIGKILL the UNIX process group (def false) redirect_stderr=true ; 重定向错误输出到标准输出 stdout_logfile=/usr/local/tomcat/logs/catalina.out ; 日志输出路径 stdout_logfile_maxbytes=10MB ; 日志文件大小 stdout_logfile_backups=20 ; 备份日志份数
这里有一个特别需要注意的地方，command 这里run 后面必须要有空格，否则会报错：
[root@master ~]# supervisorctl restart tomcat tomcat: ERROR (not running) tomcat: ERROR (spawn error)
具体日志文件报错内容如下：
[root@master bin]# tail -f /var/log/supervisor/supervisord.log 2022-07-26 15:09:16,746 INFO gave up: tomcat entered FATAL state, too many start retries too quickly 2022-07-26 15:09:16,763 INFO spawned: 'tomcat' with pid 13075 2022-07-26 15:09:16,795 INFO exited: tomcat (exit status 1; not expected) 2022-07-26 15:09:17,800 INFO spawned: 'tomcat' with pid 13079 2022-07-26 15:09:17,834 INFO exited: tomcat (exit status 1; not expected) 2022-07-26 15:09:19,845 INFO spawned: 'tomcat' with pid 13083 2022-07-26 15:09:19,879 INFO exited: tomcat (exit status 1; not expected) 2022-07-26 15:09:22,889 INFO spawned: 'tomcat' with pid 13099 2022-07-26 15:09:22,922 INFO exited: tomcat (exit status 1; not expected) 2022-07-26 15:09:23,924 INFO gave up: tomcat entered FATAL state, too many start retries too quick [root@master bin]# tail -f /usr/local/tomcat/logs/catalina.out run -security Start in the current window with security manager start Start Catalina in a separate window start -security Start in a separate window with security manager stop Stop Catalina, waiting up to 5 seconds for the process to end stop n Stop Catalina, waiting up to n seconds for the process to end stop -force Stop Catalina, wait up to 5 seconds and then use kill -KILL if still running stop n -force Stop Catalina, wait up to n seconds and then use kill -KILL if still running configtest Run a basic syntax check on server.xml - check exit code for result version What version of tomcat are you running? Note: Waiting for the process to end and use of the -force option require that $CATALINA_PID is defined
究其原因，是因为supervisord配置里没有空格，识别不出来启动命令的参数run。
六，Supervisor的配置文件每次修改过后，都需要重启服务，重启服务有两种方法：
（1）
1. [root@master bin]# supervisorctl reload 2. Restarted supervisord
（2）
[root@master bin]# systemctl restart supervisord
七，关于supervisor的配置文件说明
Supervisor守护进程的配置文件分为两种，
第一种是主配置文件，yun方式安装的位置是/etc/supervisord.conf ，该文件基本不需要修改，只需只需要关注最后两行：
1. [include] 2. files = supervisord.d/*.ini
这里定义的就是子配置文件的存放路径和子配置文件的后缀名，因此，上面的子配置文件是以ini为后缀的。
第二种是子配置文件，通常，如果有很多的服务需要使用supervisor来守护进程，那么，建议是一个服务写一个子配置文件，关于子配置文件的书写问题，主配置文件里有示例，下面我就翻译一下主配置文件里关于子配置文件书写的规则：
;[program:theprogramname]冒号:后面的名字就是web端显示的名字，比如上面的配置文件是tomcat ;command=/bin/cat ; the program (relative uses PATH, can take args) 要守护的命令，可以带参数，参数后面要有空格 ;process_name=%(program_name)s ; process_name expr (default %(program_name)s)这里不需要更改 ;numprocs=1 ; number of processes copies to start (def 1)启动的时候起多少个线程，是在这里定义，通常也不用改 ;directory=/tmp ; directory to cwd to before exec (def no cwd)#command的路径 ;umask=022 ; umask for process (default None)#该进程使用的umask值，通常也不修改的 ;priority=999 ; the relative start priority (default 999)#启动优先级，通常也不需要改动 ;autostart=true ; start at supervisord start (default: true)#是否自动启动，如果有异常情况的时候，true表示有异常就启动。 ;autorestart=true ; retstart at unexpected quit (default: true)#是否自动重启，如果有异常情况的时候，true表示有异常就启动。 ;startsecs=10 ; number of secs prog must stay running (def. 1)#程序持续运行10秒后任即为程序已经运行，这里根据需要定义 ;startretries=3 ; max # of serial start failures (default 3)#启动的时候如果有错误导致启动不了，尝试启动的次数，这里是三次，通常也是不需要更改的。 ;exitcodes=0,2 ; 'expected' exit codes for process (default 0,2)#错误退出码 ;stopsignal=QUIT ; signal used to kill process (default TERM)#退出信号，不需要更改 ;stopwaitsecs=10 ; max num secs to wait b4 SIGKILL (default 10)#挂起状态，10秒，也不需要配置 ;user=chrism ; setuid to this UNIX account to run the program#运行程序的用户，比如，es就需要指定用户啦，tomcat不需要指定。 ;redirect_stderr=true ; redirect proc stderr to stdout (default false)#是否输出日志 ;stdout_logfile=/a/path ; stdout log path, NONE for none; default AUTO#日志输出位置，这里需要自定义。 ;stdout_logfile_maxbytes=1MB ; max # logfile bytes b4 rotation (default 50MB)#日志文件大小，默认是50M，根据自己需求更改。 ;stdout_logfile_backups=10 ; # of stdout logfile backups (default 10)#日志备份数量，这里是10份 ;stdout_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0) ;stdout_events_enabled=false ; emit events on stdout writes (default false) ;stderr_logfile=/a/path ; stderr log path, NONE for none; default AUTO ;stderr_logfile_maxbytes=1MB ; max # logfile bytes b4 rotation (default 50MB)#日志的配置 ;stderr_logfile_backups=10 ; # of stderr logfile backups (default 10)#错误日志份数 ;stderr_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0)#错误日志最大容量，默认是50M ;stderr_events_enabled=false ; emit events on stderr writes (default false)#是否记录任何错误 ;environment=A=1,B=2 ; process environment additions (def no adds)#环境变量定义，比如tomcat就可以定义环境变量。 ;serverurl=AUTO ; override serverurl computation (childutils)#是否开启web端，auto表示自动检测。 ; The below sample eventlistener section shows all possible ; eventlistener subsection values, create one or more 'real' ; eventlistener: sections to be able to handle event notifications ; sent by supervisor.
八，
通过第四第五两个简单的步骤，我们就做到了tomcat 的自启和启停一条命令就可以搞定了，不需要编写繁琐的 启停脚本啦，类似这样的服务还有redis，es，moogdb等等服务，都可以通过Supervisor守护进程来管理啦，并且，Supervisor还有一个简单的web页面方便我们在任意的同网段内管理服务啦，是不是特别方便？
查看日志也更方便啦：
