配置好yum源後,可以直接安裝
Debian/Ubuntu可通過apt安裝
pip安裝(不推薦)
easy_install安裝(不推薦)
三、Supervisor的使用
Supervisor 是一個 C/S 模型的程式,supervisord 是 server 端,supervisorctl 是 client 端。
supervisor配置檔案:/etc/supervisord.conf
注:supervisor的配置檔案預設是不全的,不過在大部分預設的情況下,上面說的基本功能已經滿足。
子程序配置檔案路徑:/etc/supervisord.d/
注:預設子程序配置檔案為ini格式,可在supervisor主配置檔案中修改。
四、Supervisor的配置檔案說明
supervisor.conf配置檔案說明:
[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 ;可以打開的檔案描述符的最小值,預設 1024minprocs=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是程序的名稱,在 supervisorctl 中通過這個值來對程式進行一系列的操作
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.shrun ; 程式啟動指令
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/supervisor/conf.d/*.ini;可以指定一個或多個以.ini結束的配置檔案,當然也可以是其他類型的檔案
子程序配置檔案說明:
給需要管理的子程序(程式)編寫一個配置檔案,放在/etc/supervisor.d/目錄下,以.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,預設falseredirect_stderr= true#stdout日志檔案大小,預設 50MB
stdout_logfile_maxbytes=20M
#stdout日志檔案備份數
stdout_logfile_backups= 20
子程序配置示例:
#說明同上
[program:openfire]
environment = JAVA_HOME="/usr/local/xoa/jdk1.8"
command=/usr/local/xoa/openfire/bin/openfire run
startsecs=30
五、supervisorctl指令說明
supervisorctl 是 supervisord 的指令行用戶端工具,使用的配置和 supervisord 一樣,這裡就不再說了。下面,主要介紹 supervisorctl 操作的常用指令:
輸入指令 supervisorctl 進入 supervisorctl 的 shell 互動界面,就可以在下面輸入指令了。:
help # 檢視幫助
status # 檢視程式狀态
stop program_name # 關閉 指定的程式
start program_name # 啟動 指定的程式
restart program_name # 重新開機 指定的程式
tail -f program_name # 檢視 該程式的日志
update # 重新開機配置檔案修改過的程式(修改了配置,通過這個指令加載新的配置)
也可以直接通過 shell 指令操作:
1 supervisorctl status //檢視所有程序的狀态
2 supervisorctl stop program_name //停止指定程式
3 supervisorctl start program_name //啟動指定程式
4 supervisorctl restart program_name //重新開機指定程式5supervisorctl update//配置檔案修改後使用該指令加載新的配置6 supervisorctl reload //重新啟動配置中的所有程式
注:把program_name換成all可以管理配置中的所有程序。
注意事項
使用supervisor程序管理指令之前先啟動supervisord,否則程式報錯。
使用指令supervisord -c /etc/supervisord.conf啟動。
若是centos6:
service supervisord start
chkconfig supervisord on
若是centos7:
systemctl start supervisord.service //啟動supervisor并加載預設配置檔案
systemctl enable supervisord.service //将supervisor加入開機啟動項
六、常見錯誤
1、supervisor ERROR (spawn error)
參考:https://blog.csdn.net/qq_33468857/article/details/86711841
2、gave up: redis entered FATAL state, too many start retries too quickly
一般是因為程序啟動太慢造成,在superisor的conf中的[program:xxxx]加入啟動時間“startsecs=50”,如果還不行再加大。預設是1秒,重試3次。
一般守護程序的做法就是fork一個子程序,父程序馬上退出,以緻于supervisor無法得到子程序的ID。
3、supervisor 沒有保活程式的原因:
1、command中執行的程式是 背景程序、或者是立刻結束的shell腳本,或者是cron表達式,這些command馬上就結束的,supervisor會認為程式已結束,并且重試3次(預設),發現始終起不來,就不再守護程序。supervisorctl指令能看出程序的監控狀态,RUNNING是正常的。
2、看配置檔案裡面有木有設定autostart=true
注意:
1、supervisor主要适用于監控前台服務。書寫指令時最好以前台指令運作
2、supervisor子程序如需要依賴環境變量才可啟動,寫上environment 參數
更多好文:
https://www.cnblogs.com/549294286/p/9229868.html