一、概述
superviosr是一個Linux/Unix系統上的程序監控工具,他/她upervisor是一個Python開發的通用的程序管理程式,可以管理和監控Linux上面的程序,能将一個普通的指令行程序變為背景daemon,并監控程序狀态,異常退出時能自動重新開機。不過同daemontools一樣,它不能監控daemon程序(也就是背景程序)
二、安裝
apt-get install -y supervisor
複制
安裝成功後,會在
/etc/supervisor
目錄下,生成
supervisord.conf
配置檔案。
你也可以使用
echo_supervisord_conf > supervisord.conf
指令,生成預設的配置檔案(不建議,内容比較多)。
supervisord.conf示例配置:
; supervisor config file
[unix_http_server]
file=/var/run/supervisor.sock ; (the path to the socket file)
chmod=0700 ; sockef file mode (default 0700)
[supervisord]
logfile=/var/log/supervisor/supervisord.log ; (main log file;default $CWD/supervisord.log)
pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
childlogdir=/var/log/supervisor ; ('AUTO' child log dir, default $TEMP)
; 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:///var/run/supervisor.sock ; use a unix:// URL for a unix socket
; The [include] section can just contain the "files" setting. This
; setting can list multiple files (separated by whitespace or
; newlines). It can also contain wildcards. The filenames are
; interpreted as relative to this file. Included files *cannot*
; include files themselves.
[include]
files = /etc/supervisor/conf.d/*.conf
複制
程序配置會讀取
/etc/supervisor/conf.d
目錄下的
*.conf
配置檔案
安裝完成之後,預設就啟動了supervisor
三、管理uwsgi
在上一篇文章中,連結如下:
https://www.cnblogs.com/xiao987334176/p/11329906.html
已經配置好了uwsgi和nginx。這是2個比較關鍵的程序,任意一個程序死掉,都會導緻網頁無法通路。
修改uwsgi配置
關閉背景運作,為什麼呢?因為supervisord無法管理背景程序
cd /www/mysite1/uwsgi
vim uwsgi.ini
複制
注釋掉daemonize
[uwsgi]
# Django-related settings
# the base directory (full path)
chdir = /www/mysite1
# Django's wsgi file
module = mysite1.wsgi
# the virtualenv (full path)
home = /virtualenvs/venv
# process-related settings
# master
master = true
# maximum number of worker processes
processes = 1
# pid file
pidfile = /www/mysite1/uwsgi/uwsgi.pid
# socket file path (full path)
socket = /www/mysite1/uwsgi/mysite1.sock
# clear environment on exit
vacuum = true
#The process runs in the background and types the log to the specified log file
#daemonize = /www/mysite1/uwsgi/uwsgi.log
複制
關閉uwsgi
/virtualenvs/venv/bin/uwsgi --stop uwsgi.pid
複制
新增uwsgi 程序配置檔案
cd /etc/supervisor/conf.d
vim uwsgi.conf
複制
内容如下:
[program:uwsgi]
directory = /www/mysite1 ;程式的啟動目錄
command= /virtualenvs/venv/bin/uwsgi --ini uwsgi/uwsgi.ini ;啟動指令
autostart = true ; 在 supervisord 啟動的時候也自動啟動
startsecs = 5 ; 啟動 5 秒後沒有異常退出,就當作已經正常啟動了
autorestart = true ; 程式異常退出後自動重新開機
startretries = 3 ; 啟動失敗自動重試次數,預設是 3
user = root ; 用哪個使用者啟動
redirect_stderr = true ; 把 stderr 重定向到 stdout,預設 false
stdout_logfile_maxbytes = 20MB ; stdout 日志檔案大小,預設 50MB
stdout_logfile_backups = 20 ; stdout 日志檔案備份數
;stdout 日志檔案,需要注意當指定目錄不存在時無法正常啟動,是以需要手動建立目錄(supervisord 會自動建立日志檔案)
stdout_logfile = /www/mysite1/logs/stdout.log
;輸出的錯誤檔案
stderr_logfile = /www/mysite1/logs/stderr.log
;添加運作需要的環境變量, 這裡用了虛拟環境
;environment=PYTHONPATH=$PYTHONPATH:/virtualenvs/venv/bin/
;然後確定殺死主程序後,子程序也可以停止
stopasgroup=true
killasgroup=true
複制
建立日志目錄
mkdir /www/mysite1/logs/
複制
注意:supervisord不會自動幫你建立目錄,是以需要手動建立。
加載配置
supervisorctl reload
複制
如果出現:
error: <class 'socket.error'>, [Errno 2] No such file or directory: file: /usr/lib/python2.7/socket.py line: 228
複制
先要确認程序是否存在:ps -ef | grep supervisord 然後使用指令 supervisord -c /etc/supervisor/supervisord.conf 啟動。
檢視狀态
第一個檢視,狀态為STARTING,第二次檢視時,狀态為RUNNING
root@ubuntu:/etc/supervisor/conf.d# supervisorctl status
uwsgi STARTING
root@ubuntu:/etc/supervisor/conf.d# supervisorctl status
uwsgi RUNNING pid 20367, uptime 0:00:12
複制
kill程序
root@ubuntu:/etc/supervisor/conf.d# ps -aux|grep uwsgi
root 20367 0.3 0.8 102680 34832 ? S 13:50 0:00 /virtualenvs/venv/bin/uwsgi --ini uwsgi/uwsgi.ini
root 20369 0.0 0.7 102680 28768 ? S 13:50 0:00 /virtualenvs/venv/bin/uwsgi --ini uwsgi/uwsgi.ini
root 20377 0.0 0.0 15984 976 pts/1 S+ 13:52 0:00 grep --color=auto uwsgi
root@ubuntu:/etc/supervisor/conf.d# killall -9 uwsgi
root@ubuntu:/etc/supervisor/conf.d# ps -aux|grep uwsgi
root 20379 0.0 0.8 102676 34844 ? S 13:52 0:00 /virtualenvs/venv/bin/uwsgi --ini uwsgi/uwsgi.ini
root 20381 0.0 0.7 102676 28488 ? S 13:52 0:00 /virtualenvs/venv/bin/uwsgi --ini uwsgi/uwsgi.ini
root 20383 0.0 0.0 15984 968 pts/1 S+ 13:52 0:00 grep --color=auto uwsgi
複制
以上資訊,可以發現。強制kill掉程序之後,supervisor會将uwsgi啟動。
四、管理Nginx
由于supervisor不能監控背景程式,
command = /usr/local/bin/nginx 這個指令預設是背景啟動,
加上-g ‘daemon off;’這個參數可解決這問題,這個參數的意思是在前台運作。
command = /usr/local/bin/nginx -g ‘daemon off;’
新增nginx 程序配置檔案
cd /etc/supervisor/conf.d
vim nginx.conf
複制
内容如下:
[program:nginx]
command = /usr/sbin/nginx -g 'daemon off;'
startsecs=0
autostart=true
autorestart=true
stdout_logfile=/var/log/nginx/stdout.log
stopasgroup=true
killasgroup=true
複制
加載配置
supervisorctl reload
複制
檢視狀态
root@ubuntu:/etc/supervisor/conf.d# supervisorctl status
nginx RUNNING pid 20409, uptime 0:00:00uwsgi RUNNING pid 20404, uptime 0:00:07
複制
kill掉nginx程序
root@ubuntu:/etc/supervisor/conf.d# ps -aux|grep nginx
root 20441 0.2 0.2 125116 9832 ? S 13:58 0:00 nginx: master process /usr/sbin/nginx -g daemon off;
www-data 20442 0.0 0.0 125440 3228 ? S 13:58 0:00 nginx: worker process
root 20446 0.0 0.0 15984 1084 pts/1 S+ 13:58 0:00 grep --color=auto nginx
root@ubuntu:/etc/supervisor/conf.d# killall -9 nginx
root@ubuntu:/etc/supervisor/conf.d# ps -aux|grep nginx
root 20448 0.0 0.2 125116 9792 ? S 13:58 0:00 nginx: master process /usr/sbin/nginx -g daemon off;
www-data 20449 0.0 0.0 125440 3132 ? S 13:58 0:00 nginx: worker process
root 20451 0.0 0.0 15984 936 pts/1 S+ 13:58 0:00 grep --color=auto nginx
複制
本文參考:
https://www.cnblogs.com/xishuai/p/ubuntu-install-supervisor.html
https://blog.csdn.net/qq_32402917/article/details/80169366
https://blog.csdn.net/genglei1022/article/details/81239900