Supervisor(http://supervisord.org/)是用Python開發(fā)的一個client/server服務(wù),是Linux/Unix系統(tǒng)下的一個進程管理工具,不支持Windows系統(tǒng)。它可以很方便的監(jiān)聽、啟動、停止、重啟一個或多個進程。用Supervisor管理的進程,當一個進程意外被殺死,supervisort監(jiān)聽到進程死后,會自動將它重新拉起,很方便的做到進程自動恢復(fù)的功能,不再需要自己寫shell腳本來控制。
1. 安裝
# yum install epel-release
# yum install -y supervisor
supervisor沒有發(fā)布在標準的CentOS源上,需要安裝epel源。
supervisor安裝完成后在/usr/bin下生成三個執(zhí)行程序:supervisortd、supervisorctl、echo_supervisord_conf,分別是supervisor的守護進程服務(wù)(用于接收進程管理命令)、客戶端(用于和守護進程通信,發(fā)送管理進程的指令)、生成初始配置文件程序。
默認配置文件:/etc/supervisord.conf
進程管理配置文件目錄:/etc/supervisord.d
2. 配置文件參數(shù)說明
supervisor的配置參數(shù)較多,下面介紹一下常用的參數(shù)配置,詳細的配置及說明,請參考官方文檔介紹。
注:分號(;)開頭的配置表示注釋
[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服務(wù)器,提供web管理界面
;port=127.0.0.1:9001? ? ? ? ;Web管理后臺運行的IP和端口,如果開放到公網(wǎng),需要注意安全性
;username=user? ? ? ? ? ? ? ;登錄管理后臺的用戶名
;password=123? ? ? ? ? ? ? ;登錄管理后臺的密碼
[supervisord]
logfile=/tmp/supervisord.log ;日志文件,默認是 $CWD/supervisord.log
logfile_maxbytes=50MB? ? ? ? ;日志文件大小,超出會rotate,默認 50MB,如果設(shè)成0,表示不限制大小
logfile_backups=10? ? ? ? ? ;日志文件保留備份數(shù)量默認10,設(shè)為0表示不備份
loglevel=info? ? ? ? ? ? ? ? ;日志級別,默認info,其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid 文件
nodaemon=false? ? ? ? ? ? ? ;是否在前臺啟動,默認是false,即以 daemon 的方式啟動
minfds=1024? ? ? ? ? ? ? ? ? ;可以打開的文件描述符的最小值,默認 1024
minprocs=200? ? ? ? ? ? ? ? ;可以打開的進程數(shù)的最小值,默認 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]是被管理的進程配置參數(shù),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? ? ? ; 啟動失敗自動重試次數(shù),默認是3
user=tomcat? ? ? ? ? ; 用哪個用戶啟動進程,默認是root
priority=999? ? ? ? ; 進程啟動優(yōu)先級,默認999,值小的優(yōu)先啟動
redirect_stderr=true ; 把stderr重定向到stdout,默認false
stdout_logfile_maxbytes=20MB? ; stdout 日志文件大小,默認50MB
stdout_logfile_backups = 20? ; stdout 日志文件備份數(shù),默認是10
; stdout 日志文件,需要注意當指定目錄不存在時無法正常啟動,所以需要手動創(chuàng)建目錄(supervisord 會自動創(chuàng)建日志文件)
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false? ? ;默認為false,進程被殺死時,是否向這個進程組發(fā)送stop信號,包括子進程
killasgroup=false? ? ;默認為false,向進程組發(fā)送kill信號,包括子進程
;包含其它配置文件
[include]
files = supervisord.d/*.ini? ? ;可以指定一個或多個以.ini結(jié)束的配置文件
3. 配置管理進程
進程管理配置參數(shù),不建議全都寫在supervisord.conf文件中,應(yīng)該每個進程寫一個配置文件放在include指定的目錄下。
例如:在/etc/supervisord.d下創(chuàng)建testenc.ini
[program:testenc]
command=/opt/java/bin/java -jar /home/apps/test1-encrypt-master-SNAPSHOT-exec.jar > /home/apps/testenc.log &
stdout_logfile=/home/apps/testenc2.log
autostart=true
autorestart=true
startsecs=5
priority=1
stopasgroup=true
killasgroup=true
然后systemctl restart supervisord重啟,然后就可以使用supervisorctl start testenc,有守護進程功能,異常退出后會自動喚起??芍苯邮褂胹top,restart等
4. 開啟inet_http_server配置后,可以通過web console進行啟動/停止/重啟操作