Supervisor的安裝和使用教程

這篇文章主要講解了“Supervisor的安裝和使用教程”，文中的講解內(nèi)容簡單清晰，易于學(xué)習(xí)與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學(xué)習(xí)“Supervisor的安裝和使用教程”吧！

一、supervisor簡介

Supervisor是用Python開發(fā)的一套通用的進(jìn)程管理程序，能將一個普通的命令行進(jìn)程變?yōu)楹笈_daemon，并監(jiān)控進(jìn)程狀態(tài)，異常退出時能自動重啟。它是通過fork/exec的方式把這些被管理的進(jìn)程當(dāng)作supervisor的子進(jìn)程來啟動，這樣只要在supervisor的配置文件中，把要管理的進(jìn)程的可執(zhí)行文件的路徑寫進(jìn)去即可。也實(shí)現(xiàn)當(dāng)子進(jìn)程掛掉的時候，父進(jìn)程可以準(zhǔn)確獲取子進(jìn)程掛掉的信息的，可以選擇是否自己啟動和報警。supervisor還提供了一個功能，可以為supervisord或者每個子進(jìn)程，設(shè)置一個非root的user，這個user就可以管理它對應(yīng)的進(jìn)程。

注：本文以centos7為例，supervisor版本3.4.0。

二、supervisor安裝

1. 配置好yum源后，可以直接安裝

   yum install supervisor

   
   

2.Debian/Ubuntu可通過apt安裝

apt-get install supervisor

3.pip安裝

pip install supervisor

4.easy_install安裝

easy_install supervisor

三、supervisor使用

supervisor配置文件：/etc/supervisord.conf

注：supervisor的配置文件默認(rèn)是不全的，不過在大部分默認(rèn)的情況下，上面說的基本功能已經(jīng)滿足。

子進(jìn)程配置文件路徑：/etc/supervisord.d/

注：默認(rèn)子進(jìn)程配置文件為ini格式，可在supervisor主配置文件中修改。

四、配置文件說明

supervisor.conf配置文件說明：

[unix_http_server]
file=/tmp/supervisor.sock   ;UNIX socket 文件，supervisorctl 會使用
;chmod=0700                 ;socket文件的mode，默認(rèn)是0700
;chown=nobody:nogroup       ;socket文件的owner，格式：uid:gid
 
;[inet_http_server]         ;HTTP服務(wù)器，提供web管理界面
;port=127.0.0.1:9001        ;Web管理后臺運(yùn)行的IP和端口，如果開放到公網(wǎng)，需要注意安全性
;username=user              ;登錄管理后臺的用戶名
;password=123               ;登錄管理后臺的密碼
 
[supervisord]
logfile=/tmp/supervisord.log ;日志文件，默認(rèn)是 $CWD/supervisord.log
logfile_maxbytes=50MB        ;日志文件大小，超出會rotate，默認(rèn) 50MB，如果設(shè)成0，表示不限制大小
logfile_backups=10           ;日志文件保留備份數(shù)量默認(rèn)10，設(shè)為0表示不備份
loglevel=info                ;日志級別，默認(rèn)info，其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid 文件
nodaemon=false               ;是否在前臺啟動，默認(rèn)是false，即以 daemon 的方式啟動
minfds=1024                  ;可以打開的文件描述符的最小值，默認(rèn) 1024
minprocs=200                 ;可以打開的進(jìn)程數(shù)的最小值，默認(rèn) 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]是被管理的進(jìn)程配置參數(shù)，xx是進(jìn)程的名稱
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run  ; 程序啟動命令
autostart=true       ; 在supervisord啟動的時候也自動啟動
startsecs=10         ; 啟動10秒后沒有異常退出，就表示進(jìn)程正常啟動了，默認(rèn)為1秒
autorestart=true     ; 程序退出后自動重啟,可選值：[unexpected,true,false]，默認(rèn)為unexpected，表示進(jìn)程意外殺死后才重啟
startretries=3       ; 啟動失敗自動重試次數(shù)，默認(rèn)是3
user=tomcat          ; 用哪個用戶啟動進(jìn)程，默認(rèn)是root
priority=999         ; 進(jìn)程啟動優(yōu)先級，默認(rèn)999，值小的優(yōu)先啟動
redirect_stderr=true ; 把stderr重定向到stdout，默認(rèn)false
stdout_logfile_maxbytes=20MB  ; stdout 日志文件大小，默認(rèn)50MB
stdout_logfile_backups = 20   ; stdout 日志文件備份數(shù)，默認(rèn)是10
; stdout 日志文件，需要注意當(dāng)指定目錄不存在時無法正常啟動，所以需要手動創(chuàng)建目錄（supervisord 會自動創(chuàng)建日志文件）
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false     ;默認(rèn)為false,進(jìn)程被殺死時，是否向這個進(jìn)程組發(fā)送stop信號，包括子進(jìn)程
killasgroup=false     ;默認(rèn)為false，向進(jìn)程組發(fā)送kill信號，包括子進(jìn)程
 
;包含其它配置文件
[include]
files = relative/directory/*.ini    ;可以指定一個或多個以.ini結(jié)束的配置文件

子進(jìn)程配置文件說明：

給需要管理的子進(jìn)程(程序)編寫一個配置文件，放在/etc/supervisor.d/目錄下，以.ini作為擴(kuò)展名（每個進(jìn)程的配置文件都可以單獨(dú)分拆也可以把相關(guān)的腳本放一起）。如任意定義一個和腳本相關(guān)的項目名稱的選項組（/etc/supervisord.d/test.conf）：

#項目名
[program:blog]
#腳本目錄
directory=/opt/bin
#腳本執(zhí)行命令
command=/usr/bin/python /opt/bin/test.py

#supervisor啟動的時候是否隨著同時啟動，默認(rèn)True
autostart=true
#當(dāng)程序exit的時候，這個program不會自動重啟,默認(rèn)unexpected，設(shè)置子進(jìn)程掛掉后自動重啟的情況，有三個選項，false,unexpected和true。如果為false的時候，無論什么情況下，都不會被重新啟動，如果為unexpected，只有當(dāng)進(jìn)程的退出碼不在下面的exitcodes里面定義的
autorestart=false
#這個選項是子進(jìn)程啟動多少秒之后，此時狀態(tài)如果是running，則我們認(rèn)為啟動成功了。默認(rèn)值為1
startsecs=1

#腳本運(yùn)行的用戶身份 
user = test

#日志輸出 
stderr_logfile=/tmp/blog_stderr.log 
stdout_logfile=/tmp/blog_stdout.log 
#把stderr重定向到stdout，默認(rèn) false
redirect_stderr = true
#stdout日志文件大小，默認(rèn) 50MB
stdout_logfile_maxbytes = 20MB
#stdout日志文件備份數(shù)
stdout_logfile_backups = 20

子進(jìn)程配置示例：

[program:laravels]  
command=docker exec -i php sh -c 'php /home/www/bin/laravels start -i'  
autorestart=true  
startsecs=3  
startretries=3  
stdout_logfile=/home/lmrs/www/storage/logs/swool.log  
stderr_logfile=/home/lmrs/www/storage/logs/swool.log  
stdout\_logfile\_maxbytes=2MB  
stderr\_logfile\_maxbytes=2MB  
user=root  
priority=999  
numprocs=1  
process\_name=%(program\_name)s_%(process_num)02d

五、supervisor命令說明

常用命令

supervisorctl status        //查看所有進(jìn)程的狀態(tài)supervisorctl stop laravels       //停止laravelssupervisorctl start laravels      //啟動laravelssupervisorctl restart       //重啟laravelssupervisorctl update        //配置文件修改后使用該命令加載新的配置supervisorctl reload        //重新啟動配置中的所有程序

注：把laravels換成all可以管理配置中的所有進(jìn)程。直接輸入supervisorctl進(jìn)入supervisorctl的shell交互界面，此時上面的命令不帶supervisorctl可直接使用。

注意事項

使用supervisor進(jìn)程管理命令之前先啟動supervisord，否則程序報錯。
使用命令supervisord -c /etc/supervisord.conf啟動。
若是centos7：

systemctl start supervisord.service     //啟動supervisor并加載默認(rèn)配置文件systemctl enable supervisord.service    //將supervisor加入開機(jī)啟動項

常見問題:

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

問題描述：安裝好supervisor沒有開啟服務(wù)直接使用supervisorctl報的錯
解決辦法： supervisord -c /etc/supervisord.conf  

2. command中指定的進(jìn)程已經(jīng)起來，但supervisor還不斷重啟

問題描述：command中啟動方式為后臺啟動，導(dǎo)致識別不到pid，然后不斷重啟，這里使用的是elasticsearch，command指定的是      $path/bin/elasticsearch -d      
解決辦法：supervisor無法檢測后臺啟動進(jìn)程的pid，而supervisor本身就是后臺啟動守護(hù)進(jìn)程，因此不用擔(dān)心這個

3. 啟動了多個supervisord服務(wù)，導(dǎo)致無法正常關(guān)閉服務(wù)

問題描述：在運(yùn)行       supervisord -c /etc/supervisord.conf之前，直接運(yùn)行過       supervisord -c /etc/supervisord.d/xx.conf導(dǎo)致有些進(jìn)程被多個superviord管理，無法正常關(guān)閉進(jìn)程。      
解決辦法：使用       ps -fe | grep supervisord查看所有啟動過的supervisord服務(wù)，kill相關(guān)的進(jìn)程。

感謝各位的閱讀，以上就是“Supervisor的安裝和使用教程”的內(nèi)容了，經(jīng)過本文的學(xué)習(xí)后，相信大家對Supervisor的安裝和使用教程這一問題有了更深刻的體會，具體使用情況還需要大家實(shí)踐驗證。這里是億速云，小編將為大家推送更多相關(guān)知識點(diǎn)的文章，歡迎關(guān)注！