Supervisor介绍

1. Supervisord简介

Supervisord 是用 Python 实现的一款非常实用的进程管理工具，supervisord 还要求管理的程序是非 daemon 程序，supervisord 会帮你把它转成 daemon 程序，因此如果用 supervisord 来管理 nginx 的话，必须在 nginx 的配置文件里添加一行设置 daemon off 让 nginx 以非 daemon 方式启动。

2. supervisord 安装

2.1. 安装 setuptools

wget http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg

sh setuptools-0.6c11-py2.7.egg

easy_install supervisor

echo_supervisord_conf >/etc/supervisord.conf

mkdir /etc/supervisord.conf.d

2.2. 修改配置

vi /etc/supervisord.conf

[include]

files = /etc/supervisord.conf.d/*.conf

2.3. 新建管理的应用

cd /etc/supervisord.conf.d 

vim beepkg.conf

[program:usercenter]

directory = /opt/app/beepkg ; 程序的启动目录

command = /opt/app/beepkg/beepkg  ; 启动命令，可以看出与手动在命令行启动的命令是一样的

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

2.4. 启动

supervisord -c /etc/supervisord.conf

ps aux | grep supervisord

3. supervisorctl

Supervisord 安装完成后有两个可用的命令行 supervisord 和 supervisorctl，命令使用解释如下：

• supervisord，初始启动 Supervisord，启动、管理配置中设置的进程。
• supervisorctl stop programxxx，停止某一个进程(programxxx)，programxxx 为 [program:beepkg] 里配置的值，这个示例就是 beepkg。
• supervisorctl start programxxx，启动某个进程
• supervisorctl restart programxxx，重启某个进程
• supervisorctl stop groupworker: ，重启所有属于名为 groupworker 这个分组的进程(start,restart 同理)
• supervisorctl stop all，停止全部进程，注：start、restart、stop 都不会载入最新的配置文件。
• supervisorctl reload，载入最新的配置文件，停止原有进程并按新的配置启动、管理所有进程。
• supervisorctl update，根据最新的配置文件，启动新配置或有改动的进程，配置没有改动的进程不会受影响而重启。