supervisor 管理进程

supervisor 管理进程

说明

Supervisor是一个用 Python 写的进程管理工具,可以很方便的用来启动、重启、关闭进程.

安装

 pip install supervisor

配置

echo_supervisord_conf > /etc/supervisord.conf
supervisord.conf
[unix_http_server]
file=/tmp/supervisor.sock   ; UNIX socket 文件,supervisorctl 会使用
[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
[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; 通过 UNIX socket 连接 supervisord,路径与 unix_http_server 部分的 file 一致
[include]
files = relative/directory/*.ini    ; 可以是 *.conf 或 *.ini
program 配置
[program:appname]
directory = /myproject ; 程序的启动目录
command = gunicorn -w 8 -b 0.0.0.0:9090 manage:app  ; 启动命令
autostart = true     ; 在 supervisord 启动的时候也自动启动
startsecs = 5        ; 启动 5 秒后没有异常退出,就当作已经正常启动了
autorestart = true   ; 程序异常退出后自动重启
startretries = 3     ; 启动失败自动重试次数,默认是 3
user = www          ; 用哪个用户启动
redirect_stderr = true  ; 把 stderr 重定向到 stdout,默认 false
stdout_logfile_maxbytes = 50MB  ; stdout 日志文件大小,默认 50MB
stdout_logfile_backups = 20     ; stdout 日志文件备份数
stdout_logfile = /var/log/appname.log

其中 [program:appname] 中的 appname 是应用程序的唯一标识,不能重复。对该程序的所有操作(start, restart 等)都通过名字来实现。
几个注意点:
1.执行命令必须是绝对路径的命令
2.执行程序必须是前台运行,如果是后台运行的转为前台
3.如果涉及子进程添加以下参数,确保子进程都能停止

stopasgroup=true
killasgroup=true

启动

手工启动
supervisord -c /etc/supervisord.conf
添加为服务,并添加开机启动(centos 7)

(1).新建supervisord.service文件

#supervisord.service
[Unit]
Description=Supervisor daemon
[Service]
Type=forking
ExecStart=/bin/supervisord -c /etc/supervisord.conf
ExecStop=/bin/supervisorctl shutdown
ExecReload=/bin/supervisorctl reload
KillMode=process
Restart=on-failure
RestartSec=42s
[Install]
WantedBy=multi-user.target

(2).添加为服务并开机启动

cp supervisord.service /usr/lib/systemd/system/
service supervisord start
chkconfig supervisord on

supervisorctl

supervisorctl status
supervisorctl stop appname
supervisorctl start appname
supervisorctl restart appname
supervisorctl reread
supervisorctl update