Linux下使用Supervisor来管理维护程序-详解

一、场景

　　常常需要后台支行一个进程，或者开机自动运行等等。

　　首先，后台运行可以考虑使用nohup和&来实现，想实现开机运行，可以把命令写到/etc/rc.d/rc.local中。

　　但是，上面这种方法，常常是有问题的，而且程序中断怎么办？另外，今天在使用nohup后台运行goaccess的实时日志分析时，就死活出错，提示读不到日志，可是日志路径是完全正确的。

　　这时候，可以使用supervisor来搞定。

二、安装

　　我的系统环境：Centos7

　　yum install epel-release

　　yum install supervisor

　　说明：如果直接执行yum install supervisor找不到库，就先执行下yum install epel-release。我当前安装的最新版本是3.1.3

三、配置：

　　安装完成后，配置文件在这：

　　/etc/supervisord.conf　

　　修改配置文件，开启WEB管理：

　　

　　保存配置。

三、定义托管程序：

　　进入目录：/etc/supervisord.d 新建一个ini文件，假设新管理的程序起的别名叫goacc，那就可以建一个名为goacc.ini文件在/etc/supervisord.d目录下。

　　内容如下：

[program:goacc]
command=/usr/bin/goaccess -f /var/log/httpd/access_log -p /usr/local/etc/goaccess.conf -o /var/www/html/report.html --real-time-html
directory=/opt
user=root

四、启动服务：

　　systemctl start supervisord

　　说明：服务启动后，你的程序goacc也就启动了【默认是，也要以改成不启动】。

五、进入命令行管理模式：

　　如果需要进入命令行管理模式，可以执行supervisorctl，进入之后，输入help列出辅助命令，并在顶部显示当前运行的程序。

　　

六、WEB页面上查看：

　　在外网输入http://<访问ip>:9001即可进行Web端的程序管理。

 　　

 

七、当前GoAccess启动后的效果：

　　实时日志分析：

　　

八、SuperVisor的参数说明：

　　官网：http://www.supervisord.org/api.html#process-control

　　程序的配置说明：

[program:usercenter]
directory = /home/leon/projects/usercenter ; 程序的启动目录
command = gunicorn -c gunicorn.py wsgi:app ; 启动命令，可以看出与手动在命令行启动的命令是一样的
autostart = true ; 在 supervisord 启动的时候也自动启动
startsecs = 5 ; 启动 5 秒后没有异常退出，就当作已经正常启动了
autorestart = true ; 程序异常退出后自动重启
startretries = 3 ; 启动失败自动重试次数，默认是 3
user = leon ; 用哪个用户启动
redirect_stderr = true ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 20MB ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 20 ; stdout 日志文件备份数
; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）
stdout_logfile = /data/logs/usercenter_stdout.log

; 可以通过 environment 来添加需要的环境变量，一种常见的用法是修改 PYTHONPATH
; environment=PYTHONPATH=$PYTHONPATH:/path/to/somewhere

　　服务的配置说明：

[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