一、 安裝
yum install supervisor
二、配置檔案
/etc/supervisord.conf
子程序配置檔案 /etc/supervisord.d/
注:預設子程序配置檔案為ini格式,可在supervisor主配置檔案中修改。
三、配置檔案說明
[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 = relative/directory/*.ini ;可以指定一個或多個以.ini結束的配置檔案
子程序配置檔案
項目名[program:blog]#腳本目錄
directory=/opt/bin
腳本執行指令
command=/usr/bin/python /opt/bin/test.py
supervisor啟動的時候是否随着同時啟動,預設True
autostart=true#當程式exit的時候,這個program不會自動重新開機,預設unexpected,設定子程序挂掉後自動重新開機的情況,有三個選項,false,unexpected和true。如果為false的時候,無論什麼情況下,都不會被重新啟動,如果為unexpected,隻有當程序的退出碼不在下面的exitcodes裡面定義的
autorestart=false#這個選項是子程序啟動多少秒之後,此時狀态如果是running,則我們認為啟動成功了。預設值為1
startsecs=1
腳本運作的使用者身份
user = test
日志輸出
stderr_logfile=/tmp/blog_stderr.log
stdout_logfile=/tmp/blog_stdout.log
把stderr重定向到stdout,預設 false
redirect_stderr = true#stdout日志檔案大小,預設 50MB
stdout_logfile_maxbytes = 20MB
stdout日志檔案備份數
stdout_logfile_backups = 20
四、常用指令
supervisorctl status //檢視所有程序的狀态
supervisorctl stop es //停止es
supervisorctl start es //啟動es
supervisorctl restart //重新開機es
supervisorctl update //配置檔案修改後使用該指令加載新的配置
supervisorctl reload //重新啟動配置中的所有程式
啟動指令
supervisord -c /etc/supervisord.conf
常見問題
*
unix:///var/run/supervisor.sock no such file
問題描述:安裝好supervisor沒有開啟服務直接使用supervisorctl報的錯
解決辦法:supervisord -c /etc/supervisord.conf
*
command中指定的程序已經起來,但supervisor還不斷重新開機
問題描述:command中啟動方式為背景啟動,導緻識别不到pid,然後不斷重新開機,這裡使用的是elasticsearch,command指定的是$path/bin/elasticsearch -d
解決辦法:supervisor無法檢測背景啟動程序的pid,而supervisor本身就是背景啟動守護程序,是以不用擔心這個
*
啟動了多個supervisord服務,導緻無法正常關閉服務
問題描述:在運作supervisord -c /etc/supervisord.conf之前,直接運作過supervisord -c /etc/supervisord.d/xx.conf導緻有些程序被多個superviord管理,無法正常關閉程序。
解決辦法:使用ps -fe | grep supervisord檢視所有啟動過的supervisord服務,kill相關的程序。
建立子程序
編寫測試腳本
vim /tmp/echo_time.sh
/bin/bash while true; do echo date +%Y-%m-%d,%H:%m:%s
sleep 2 done
date +%Y-%m-%d,%H:%m:%s
增加子程序配置檔案
[program:echo_time]
command=sh /tmp/echo_time.sh
autostart=true autorestart=true
startsecs=10
startretries=3
exitcodes=0,2
stopsignal=QUIT
stopwaitsecs=10
user=root
log_stdout=true
log_stderr=true
logfile=/tmp/echo_time.log
logfile_maxbytes=1MB
logfile_backups=10
stdout_logfile_maxbytes=20MB
stdout_logfile_backups=20
stdout_logfile=/tmp/echo_time.stdout.log
啟動程式
$ supervisorctl reread $ supervisorctl update