supervisor是一個進程管理工具,用來啓動、停止、重啓和監測進程。我用這個東西主要用來監測爬蟲和Flask運行狀況,當程序掛掉後,supervisor能夠幫我重新拉起進程。
安裝
安裝就比較簡單了,直接用Python的包管理器pip:
sudo pip install supervisor
配置
先通過echo_supervisord_conf 命令生成配置文件,路徑隨你指定。
echo_supervisord_conf > /etc/supervisord.conf
查看配置文件,常用配置說明:
;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
logfile_backups=10 ; 日誌文件保留備份數量默認 10
loglevel=info ; 日誌級別,默認 info,其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ; pid 文件
nodaemon=false ; 是否在前臺啓動,默認是 false,即以 daemon 的方式啓動
minfds=1024 ; 可以打開的文件描述符的最小值,默認 1024
minprocs=200 ; 可以打開的進程數的最小值,默認 200
; the below section must remain in the config file for RPC
; (supervisorctl/web interface) to work, additional interfaces may be
; added by defining them in separate rpcinterface: sections
[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; 通過 UNIX socket 連接 supervisord,路徑與 unix_http_server 部分的 file 一致
;serverurl=http://127.0.0.1:9001 ; 通過 HTTP 的方式連接 supervisord
; 包含其他的配置文件
[include]
files = relative/directory/*.ini ; 可以是 *.conf 或 *.ini
通過 supervisord -c 來讀取配置
supervisord -c /etc/supervisord.conf
程序配置
我使用一個Flask程序來做一個簡單的案例。
首先,修改配置文件,主要是修改program配置的位置,按照套路來說一般都放到/etc目錄。
[include]
files = /etc/supervisor/*.conf
通過vi創建文件
vi /etc/supervisor/amazon_server.conf
接下來是program的配置:
;amazon_server.conf
[program:amazon_server] ;程序名
directory = /root/amazon_server ; 程序的啓動目錄
command = python app.py ; 啓動命令,可以看出與手動在命令行啓動的命令是一樣的
autostart = true ; 在 supervisord 啓動的時候也自動啓動
startsecs = 5 ; 啓動 5 秒後沒有異常退出,就當作已經正常啓動了
autorestart = true ; 程序異常退出後自動重啓
startretries = 3 ; 啓動失敗自動重試次數,默認是 3
user = root ; 用哪個用戶啓動
redirect_stderr = true ; 把 stderr 重定向到 stdout,默認 false
stdout_logfile_maxbytes = 100MB ; stdout 日誌文件大小,默認 50MB
stdout_logfile_backups = 10 ; stdout 日誌文件備份數
; stdout 日誌文件,需要注意當指定目錄不存在時無法正常啓動,所以需要手動創建目錄(supervisord 會自動創建日誌文件)
stdout_logfile = /root/amazon_server/app.log
這個Flask程序我直接用Python命令來啓動的,當然你也可以用Gunicorn。
supervisorctl
supervisorctl是supervisord的命令行客戶端管理工具,用來管理進程。
讀取配置,進入交互shell環境。
supervisord -c /etc/supervisord.conf
supervisorctl
#讀取配置文件
reread
#啓動程序
start amazon_server
命令說明
> status # 查看程序狀態
> stop usercenter # 關閉 usercenter 程序
> start usercenter # 啓動 usercenter 程序
> restart usercenter # 重啓 usercenter 程序
> reread # 讀取有更新(增加)的配置文件,不會啓動新添加的程序
> update # 重啓配置文件修改過的程序
也可以不進入交互環境:
$ supervisorctl status
$ supervisorctl stop usercenter
$ supervisorctl start usercenter
$ supervisorctl restart usercenter
$ supervisorctl reread
$ supervisorctl update
開機自啓
ubuntu
ubuntu開機自啓有多種方式,你隨意。編輯/etc/rc.local文件,
vi /etc/rc.local
在exit 0 之前加入以下命令
/usr/local/bin/supervisord
保存並退出。
最後修改rc.local權限
chmod +x /etc/rc.local
centos
新建文件supervisord.service
#supervisord.service
[Unit]
Description=Supervisor daemon
[Service]
Type=forking
ExecStart=/usr/bin/supervisord -c /etc/supervisord.conf
ExecStop=/usr/bin/supervisorctl shutdown
ExecReload=/usr/bin/supervisorctl reload
KillMode=process
Restart=on-failure
RestartSec=42s
[Install]
WantedBy=multi-user.target
將文件拷貝到/usr/lib/systemd/system/
cp supervisord.service /usr/lib/systemd/system/
啓動服務
systemctl enable supervisord
驗證一下是否爲開機啓動
systemctl is-enabled supervisord