supervisor 使用詳解

簡介
supervisor是用Python開發的一個client/server服務,是Linux/Unix系統下的一個進程管理工具。可以很方便的監聽、啓動、停止、重啓一個或多個進程。用supervisor管理的進程,當一個進程意外被殺死,supervisor監聽到進程死後,會自動將它重啓,很方便的做到進程自動恢復的功能,不再需要自己寫shell腳本來控制。

安裝


配置好yum源後,可以直接安裝

yum install supervisor


配置


安裝好後在/etc/會生成一個supervisord.conf文件及一個supervisord.d文件目錄

supervisord.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                  ;可以打開的文件描述符的最小值,默認 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結束的配置文件


注意:[include]默認配置是制定*.ini,因個人習慣命名爲*.conf文件,因此修改配置如下:

[include]
files = relative/directory/*.conf


supervisord.d目錄用來存放用戶自定義的進程配置,參考:

[program:es]
command=/opt/software/elasticsearch/bin/elasticsearch
user=es
stdout_logfile=/opt/supervisor_test/run.log
autostart=true
autorestart=true
startsecs=60
stopasgroup=true
ikillasgroup=true
startretries=1
redirect_stderr=true


注意: supervisor不能監控後臺進程,command 不能爲後臺運行命令

服務段啓動

supervisord -c /etc/supervisord.conf 


常用命令介紹


supervisorctl 是 supervisord的命令行客戶端工具

supervisorctl status:查看所有進程的狀態
supervisorctl stop es:停止es
supervisorctl start es:啓動es
supervisorctl restart es: 重啓es
supervisorctl update :配置文件修改後可以使用該命令加載新的配置
supervisorctl reload: 重新啓動配置中的所有程序


...
把es 換成all 可以管理配置中的所有進程

直接輸入:supervisorctl 進入supervisorctl 的shell交互界面,上面的命令不帶supervisorctl 可直接使用

踩過的坑


1、unix:///var/run/supervisor/supervisor.sock no such file

     問題描述:安裝好supervisor沒有開啓服務直接使用supervisorctl報的錯

     解決辦法:supervisord -c /etc/supervisord.conf 

2、command中指定的進程已經起來,但supervisor還不斷重啓

     問題描述:command中啓動方式爲後臺啓動,導致識別不到pid,然後不斷重啓,本人使用的是elasticsearch,command                        指定的是$path/bin/elasticsearch -d,踩到的坑

     解決辦法:supervisor無法檢測後臺啓動進程的pid,而supervisor本身就是後臺啓動守護進程,因此不用擔心這個

3、啓動了多個supervisord服務,導致無法正常關閉服務

    問題描述:在運行supervisord -c /etc/supervisord.conf 之前,我直接運行過supervisord -c /etc/supervisord.d/xx.conf                         ,導致有些進程被多個superviord管理,無法正常關閉進程。

    解決辦法: 使用 ps -fe | grep supervisord 查看所有啓動過的supervisord服務,kill相關的進程。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章