一、supervisor簡介

項目中需要將一些自己開發的服務放到系統進程中在後台運行。一開始使用的是screen工具配合寫了一個shell腳本，基本實現了啟動、重啟、停止操作，但是對於進程守護方面不是太穩定，經常遇到進程停止導致服務異常的情況。於是想藉助於一個成熟的進程管理工具，來管理這些服務進程。經過篩選，決定使用supervisor。

supervisor是基於python開發的一套進程管理工具，能將普通的命令行進程放到系統後台運行，並對進程進行監控，出現異常時可以自動重啟進程。使用起來也非常方便，安裝好supervisor後，將要管理的進程的執行文件以及路徑寫進配置文件中即可實現進程守護。

二、supervisor安裝

因為我的系統是ubuntu server 16.04，所以可以直接apt安裝，（Debian/Ubuntu都可通過apt安裝）

apt-get install supervisor

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

yum install supervisor

還有另外兩種安裝方式（沒有驗證過，大家自行測試）：

pip安裝

pip install supervisor

easy_install安裝

easy_install supervisor

三、supervisor配置文件位置

supervisor主要的配置文件在：
/etc/supervisor/supervisord.conf

ubuntu安裝好supervisor後，默認的supervisord.conf配置文件中包含的配置項較少，更多的配置參數說明可以參考「配置文件說明」中的「supervisor.conf配置文件說明」

子進程配置文件路徑：/etc/supervisor/conf.d/

每個需要守護的進程，建一個子進程配置文件。配置說明參考「配置文件說明」中的「子進程配置文件說明」

四、配置文件說明

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                  ;可以打開的文件描述符的最小值，默認 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/*.conf    ;可以指定一個或多個以.conf結束的配置文件

子進程配置文件說明：

每個子進程配置文件對應一個或者多個相關的需要進程守護的程序，在命名時可以定義一個相關的名稱，方便記憶管理，如下面的配置
/etc/supervisor/conf.d/test.conf文件對應的是/opt/bin/test.py:

#項目名
[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 = 20M
#stdout日誌文件備份數
stdout_logfile_backups = 20

子進程配置示例：

#說明同上
[program:test] 
directory=/opt/bin 
command=/opt/bin/test
autostart=true 
autorestart=false 
stderr_logfile=/tmp/test_stderr.log 
stdout_logfile=/tmp/test_stdout.log 
#user = test

五、supervisor命令說明

常用命令
supervisorctl status        //查看所有進程的狀態
supervisorctl stop test       //停止test
supervisorctl start test      //啟動test
supervisorctl restart test       //重啟test
supervisorctl update        //配置文件修改後使用該命令載入新的配置
supervisorctl reload        //重新啟動配置中的所有程序

將上面配置中的test換成all，是對所有的進程進行操作，如：

supervisorctl stop all       //停止所有進程
supervisorctl start all      //啟動所有進程
supervisorctl restart all       //重啟所有進程

以上就是supervisor簡單介紹和使用方法，後面會結合項目系統性地介紹一下supervisor的配合應用。