一、介紹
Supervisor是用Python開(kāi)發(fā)的一套通用的進(jìn)程管理程序，能將一個(gè)普通的命令行進(jìn)程變?yōu)楹笈_(tái)daemon，并監(jiān)控進(jìn)程狀態(tài)，異常退出時(shí)能自動(dòng)重啟。目前Supervisor可以運(yùn)行在大多數(shù)Unix系統(tǒng)上，但不支持在Windows系統(tǒng)上運(yùn)行。Supervisor需要Python2.4及以上版本，但任何Python 3版本都不支持。
二、自帶Web管理程序
Supervisor有四個(gè)組件：
1. supervisord
運(yùn)行Supervisor的后臺(tái)服務(wù)，它用來(lái)啟動(dòng)和管理那些你需要Supervisor管理的子進(jìn)程，響應(yīng)客戶端發(fā)來(lái)的請(qǐng)求，重啟意外退出的子進(jìn)程，將子進(jìn)程的stdout和stderr寫(xiě)入日志，響應(yīng)事件等。它是Supervisor最核心的部分。
2. supervisorctl
相當(dāng)于supervisord的客戶端，它是一個(gè)命令行工具，用戶可以通過(guò)它向supervisord服務(wù)發(fā)指令，比如查看子進(jìn)程狀態(tài)，啟動(dòng)或關(guān)閉子進(jìn)程。它可以連接不同的supervisord服務(wù)，包括遠(yuǎn)程機(jī)上的服務(wù)。
3. Web服務(wù)器
這是supervisord的Web客戶端，用戶可以在Web頁(yè)面上完成類(lèi)似于supervisorctl的功能。
4. XML-RPC接口
這是留給第三方集成的接口，你的服務(wù)可以在遠(yuǎn)程調(diào)用這些XML-RPC接口來(lái)控制supervisord管理的子進(jìn)程。上面的Web服務(wù)器其實(shí)也是通過(guò)這個(gè)XML-RPC接口實(shí)現(xiàn)的。
三、安裝
下面介紹了三種方式，任選一種即可
1、安裝
echo "supervisor-3.3.4安裝(是, 請(qǐng)輸入1 ; 否, 輸入其他):"
read SV
if [ "$SV" = "1" ];then
cd $basepath
unzip $basepath/supervisor-3.3.4.zip
cd supervisor-3.3.4
python setup.py install
echo "supervisor-3.3.4 安裝完成"
else
echo "您選擇了不安裝supervisor-3.3.4"
fi
2、源碼安裝
wget https://pypi.python.org/packages/7b/17/88adf8cb25f80e2bc0d18e094fcd7ab300632ea00b601cbbbb84c2419eae/supervisor-3.3.4.tar.gz
tar -zxvf supervisor-3.3.4.tar.gz
cd supervisor-3.3.4
python setup.py install #本地python版本為python2.7
3、yum安裝
四、配置文件
如果安裝后，沒(méi)有/etc/supervisord.conf這個(gè)配置文件，則用命令生成：
echo_supervisord_conf > /etc/supervisord.conf
五、啟動(dòng)
supervisord -c /etc/supervisord/supervisord.conf
echo "supervisor-3.3.4 啟動(dòng)成功"
六、設(shè)置開(kāi)機(jī)啟動(dòng)
systemctl enable supervisord.service
七、查看 supervisord 是否在運(yùn)行
ps aux | grep supervisord
八、supervisorctl管理命令
supervisorctl status # 狀態(tài)
supervisorctl stop nginx #關(guān)閉 nginx
supervisorctl start nginx #啟動(dòng) nginx
supervisorctl restart nginx #重啟 nginx
supervisorctl reload #重啟全部
supervisorctl update #更新配置
此命令可以分著用，也可以合并使用
九、配置文件說(shuō)明
[unix_http_server]
file=/tmp/supervisor.sock ;UNIX socket 文件，supervisorctl 會(huì)使用
;chmod=0700 ;socket文件的mode，默認(rèn)是0700
;chown=nobody:nogroup ;socket文件的owner，格式：uid:gid
;[inet_http_server] ;HTTP服務(wù)器，提供web管理界面
;port=127.0.0.1:9001 ;Web管理后臺(tái)運(yùn)行的IP和端口，如果開(kāi)放到公網(wǎng)，需要注意安全性
;username=user ;登錄管理后臺(tái)的用戶名
;password=123 ;登錄管理后臺(tái)的密碼
[supervisord]
logfile=/tmp/supervisord.log ;日志文件，默認(rèn)是 $CWD/supervisord.log
logfile_maxbytes=50MB ;日志文件大小，超出會(huì)rotate，默認(rèn) 50MB，如果設(shè)成0，表示不限制大小
logfile_backups=10 ;日志文件保留備份數(shù)量默認(rèn)10，設(shè)為0表示不備份
loglevel=info ;日志級(jí)別，默認(rèn)info，其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid 文件
nodaemon=false ;是否在前臺(tái)啟動(dòng)，默認(rèn)是false，即以 daemon 的方式啟動(dòng)
minfds=1024 ;可以打開(kāi)的文件描述符的最小值，默認(rèn) 1024
minprocs=200 ;可以打開(kāi)的進(jìn)程數(shù)的最小值，默認(rèn) 200
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ;通過(guò)UNIX socket連接supervisord，路徑與unix_http_server部分的file一致
;serverurl=http://127.0.0.1:9001 ; 通過(guò)HTTP的方式連接supervisord
; [program:xx]是被管理的進(jìn)程配置參數(shù)，xx是進(jìn)程的名稱
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run ; 程序啟動(dòng)命令
autostart=true ; 在supervisord啟動(dòng)的時(shí)候也自動(dòng)啟動(dòng)
startsecs=10 ; 啟動(dòng)10秒后沒(méi)有異常退出，就表示進(jìn)程正常啟動(dòng)了，默認(rèn)為1秒
autorestart=true ; 程序退出后自動(dòng)重啟,可選值：[unexpected,true,false]，默認(rèn)為unexpected，表示進(jìn)程意外殺死后才重啟
startretries=3 ; 啟動(dòng)失敗自動(dòng)重試次數(shù)，默認(rèn)是3
user=tomcat ; 用哪個(gè)用戶啟動(dòng)進(jìn)程，默認(rèn)是root
priority=999 ; 進(jìn)程啟動(dòng)優(yōu)先級(jí)，默認(rèn)999，值小的優(yōu)先啟動(dòng)
redirect_stderr=true ; 把stderr重定向到stdout，默認(rèn)false
stdout_logfile_maxbytes=20MB ; stdout 日志文件大小，默認(rèn)50MB
stdout_logfile_backups = 20 ; stdout 日志文件備份數(shù)，默認(rèn)是10
; stdout 日志文件，需要注意當(dāng)指定目錄不存在時(shí)無(wú)法正常啟動(dòng)，所以需要手動(dòng)創(chuàng)建目錄（supervisord 會(huì)自動(dòng)創(chuàng)建日志文件）
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false ;默認(rèn)為false,進(jìn)程被殺死時(shí)，是否向這個(gè)進(jìn)程組發(fā)送stop信號(hào)，包括子進(jìn)程
killasgroup=false ;默認(rèn)為false，向進(jìn)程組發(fā)送kill信號(hào)，包括子進(jìn)程
;包含其它配置文件
[include]
files =/etc/supervisord.d/*.ini ;可以指定一個(gè)或多個(gè)以.ini結(jié)束的配置文件
十、ini配置文件 舉例說(shuō)明
[program:MysqlToRedis]
directory = /data/py/SmartServerModel/SmartServerModel/ModelManagerServer/
command= python3 -u mysql2redis_robot_config.py cs
autostart = true
autorestart=true
startsecs = 5
user =root
redirect_stderr = true
stdout_logfile = /data/logs/supervisord/mysqltoredis.log
[program:SmartBinLog]
command= /data/go/src/SmartBinLog/SmartBinLog
autostart = true
autorestart=true
startsecs = 5
user =root
redirect_stderr = true
stdout_logfile = /data/logs/supervisord/smartbinlog.log
[group:nlp]
programs=MysqlToRedis,SmartBinLog ;server,progname2 each refers to 'x' in [program:x] definitions
priority=999 ; the relative start priority (default 999)
十一、開(kāi)啟web頁(yè)面管理程序
在conf配置文件中把注釋的這幾行代碼全部解除注釋，然后更改端口，用戶名和密碼
[inet_http_server] ;HTTP服務(wù)器，提供web管理界面
port=127.0.0.1:9001 ;Web管理后臺(tái)運(yùn)行的IP和端口，如果開(kāi)放到公網(wǎng)，需要注意安全性
username=user ;登錄管理后臺(tái)的用戶名
password=123 ;登錄管理后臺(tái)的密碼
十二、解決“unix:///tmp/supervisor.sock no such file”問(wèn)題
有時(shí)我們會(huì)遇到這個(gè)問(wèn)題：
解決方案很簡(jiǎn)單：
①、停止已有supervisorctl進(jìn)程
②、修改配置文件“/etc/supervisord.conf”,把tmp改成etc。/tmp目錄下的文件會(huì)被操作系統(tǒng)定時(shí)回收，所以要修改
③、以剛剛修改的配置文件開(kāi)啟supervisord，這樣就恢復(fù)正常啦~
