一、介紹
Supervisor是用Python開發的一套通用的進程管理程序,能將一個普通的命令行進程變為后臺daemon,并監控進程狀態,異常退出時能自動重啟。目前Supervisor可以運行在大多數Unix系統上,但不支持在Windows系統上運行。Supervisor需要Python2.4及以上版本,但任何Python 3版本都不支持。
二、自帶Web管理程序

Supervisor有四個組件:
1. supervisord
運行Supervisor的后臺服務,它用來啟動和管理那些你需要Supervisor管理的子進程,響應客戶端發來的請求,重啟意外退出的子進程,將子進程的stdout和stderr寫入日志,響應事件等。它是Supervisor最核心的部分。
2. supervisorctl
相當于supervisord的客戶端,它是一個命令行工具,用戶可以通過它向supervisord服務發指令,比如查看子進程狀態,啟動或關閉子進程。它可以連接不同的supervisord服務,包括遠程機上的服務。
3. Web服務器
這是supervisord的Web客戶端,用戶可以在Web頁面上完成類似于supervisorctl的功能。
4. XML-RPC接口
這是留給第三方集成的接口,你的服務可以在遠程調用這些XML-RPC接口來控制supervisord管理的子進程。上面的Web服務器其實也是通過這個XML-RPC接口實現的。
三、安裝
下面介紹了三種方式,任選一種即可
1、安裝
echo "supervisor-3.3.4安裝(是, 請輸入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安裝
四、配置文件
如果安裝后,沒有/etc/supervisord.conf這個配置文件,則用命令生成:
echo_supervisord_conf > /etc/supervisord.conf
五、啟動
supervisord -c /etc/supervisord/supervisord.conf
echo "supervisor-3.3.4 啟動成功"
六、設置開機啟動
systemctl enable supervisord.service
七、查看 supervisord 是否在運行
ps aux | grep supervisord
八、supervisorctl管理命令
supervisorctl status # 狀態
supervisorctl stop nginx #關閉 nginx
supervisorctl start nginx #啟動 nginx
supervisorctl restart nginx #重啟 nginx
supervisorctl reload #重啟全部
supervisorctl update #更新配置
此命令可以分著用,也可以合并使用
九、配置文件說明
[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.log
logfile_maxbytes=50MB ;日志文件大小,超出會rotate,默認 50MB,如果設成0,表示不限制大小
logfile_backups=10 ;日志文件保留備份數量默認10,設為0表示不備份
loglevel=info ;日志級別,默認info,其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid 文件
nodaemon=false ;是否在前臺啟動,默認是false,即以 daemon 的方式啟動
minfds=1024 ;可以打開的文件描述符的最小值,默認 1024
minprocs=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 ; 啟動失敗自動重試次數,默認是3
user=tomcat ; 用哪個用戶啟動進程,默認是root
priority=999 ; 進程啟動優先級,默認999,值小的優先啟動
redirect_stderr=true ; 把stderr重定向到stdout,默認false
stdout_logfile_maxbytes=20MB ; stdout 日志文件大小,默認50MB
stdout_logfile_backups = 20 ; stdout 日志文件備份數,默認是10
; stdout 日志文件,需要注意當指定目錄不存在時無法正常啟動,所以需要手動創建目錄(supervisord 會自動創建日志文件)
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false ;默認為false,進程被殺死時,是否向這個進程組發送stop信號,包括子進程
killasgroup=false ;默認為false,向進程組發送kill信號,包括子進程
;包含其它配置文件
[include]
files =/etc/supervisord.d/*.ini ;可以指定一個或多個以.ini結束的配置文件
十、ini配置文件 舉例說明
[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)
十一、開啟web頁面管理程序
在conf配置文件中把注釋的這幾行代碼全部解除注釋,然后更改端口,用戶名和密碼
[inet_http_server] ;HTTP服務器,提供web管理界面
port=127.0.0.1:9001 ;Web管理后臺運行的IP和端口,如果開放到公網,需要注意安全性
username=user ;登錄管理后臺的用戶名
password=123 ;登錄管理后臺的密碼
十二、解決“unix:///tmp/supervisor.sock no such file”問題
有時我們會遇到這個問題:

解決方案很簡單:
①、停止已有supervisorctl進程

②、修改配置文件“/etc/supervisord.conf”,把tmp改成etc。/tmp目錄下的文件會被操作系統定時回收,所以要修改

③、以剛剛修改的配置文件開啟supervisord,這樣就恢復正常啦~
