Supervisor 是基于 Python 的进程管理工具。其可方便我们启动守护进程，并对进程进行管理(启动、重启和停止进程，异常退出时还能能自动重启)，此外还可以管理自定义的开机启动项。
安装
由于其基于 Python 开发，任何环境都可以通过 pip 安装：
pip install supervisor
此外，Ubuntu 系统可用如下方式安装：
apt-get install supervisor
MacOSX 系统可通过如下方式安装：
brew install supervisor
安装完成后会有如下几个命令工具
supervisord，Supervisor 的守护进程启动命令，运行时会启动一个守护进程，其负责管理的子进程，且可在所管理的进程出现崩溃时自动重启
supervisorctl，用户与 Supervisor 交互的工具，方便用户管理子进程，可用来 stop、start、restart
echo_supervisord_conf，输出默认配置
安装完成后可以用 echo_supervisord_conf 命令测试是否安装成功。
配置
如果是使用 apt 或者 brew 等各平台的软件包管理工具安装的 Supervisor，一般会自动创建默认的配置。如 apt 工具安装后，会创建 /etc/supervisor/supervisord.conf 默认配置；brew 工具安装后，会创建 /usr/local/etc/supervisord.ini 默认配置。但是使用 pip 安装后则可能不会自动创建默认配置，但可以手动创建：
echo_supervisord_conf > /etc/supervisor/supervisord.conf
通常情况下使用默认配置即可，此外还需要配置 program，即所要启动的子进程的配置。通过查看默认配置文件可知，supervisor 的配置使用的是 INI 格式，子进程的配置在 [program:x] 段。没了便于管理，通常将每个应用的配置写到一个文件中，并将这些文件统一放到一个目录下，如 /etc/supervisor/conf.d。这需要在 supervisord.conf 配置中做如下配置：
[include]
files = /etc/supervisor/conf.d/*.conf
配置的含义为，包含 /etc/supervisor/conf.d/ 下所有以 .conf 结果的文件。[program:x] 段配置项说明：
; 标 * 的为必须项
; * 指定为 program 段，冒号后为进程命令
[program:cat]
; * 进程运行的命令，其中可执行文件可以是绝对路径或相对路径，为相对路径时会在 $PATH 变量中查找
command=/bin/cat
; 指定进程名称，默认为 program 段冒号后指定的名称
; 当 numprocs 为 1 时, process_name=%(program_name)s
; 当 numprocs >=2 时, process_name=%(program_name)s_%(process_num)02d
process_name=%(program_name)s
; 进程数量，supervisor 可对一个 program 启动多个进程
numprocs=1
; 执行目录，当配置该选项时，运行程序前将先 chdir 到指定目录
directory=/tmp
; 掩码:--- -w- -w-, 转换后rwx r-x w-x
umask=022
; 优先级，值越高的程序将最后被启动最先被关闭，默认值 999
priority=999
; 如果是 true, 当 supervisor 启动时, 程序将会自动启动
autostart=true
; * 当检测到程序退出时是否自动重启，可知可以为，false，true，unexpected
autorestart=true
; 程序启动多长时间后才确定为启动成功, 默认 1 秒
startsecs=10
; 启动尝试次数,默认 3 次
startretries=3
; 列出进程预期的退出码
; 如果 autorestart 设置为 unexpected,
; 进程退出码不在配置中，则认为进程意外退出，会被重启
; 在 4.0 版本以前为默认为 0,2，4.0 及之后默认为 0
exitcodes=0
; 停止进程的信号，默认 TERM
; 中断: INT(类似于Ctrl+C)(kill -INT pid), 退出后会将写文件或日志(推荐)
; 终止: TERM(kill -TERM pid)
; 挂起: HUP(kill -HUP pid),注意与Ctrl+Z/kill -stop pid不同
; 从容停止: QUIT(kill -QUIT pid)
; KILL, USR1, USR2，其他见命令(kill -l)
stopsignal=TERM
; 最长结束等待时间, 否则使用 SIGKILL
stopwaitsecs=10
; * 运行进程的用户
user=root
; 结束时结束整个进程组
; 启动的子程序还可能会有子进程(如 Tornado)
; 如果只杀死主进程，子进程不会被清理掉，且还会变成孤儿进程
; 通过这两项配置(改为 true)，可确保所有子进程都能正确停止, 默认是 false
stopasgroup=false
killasgroup=false
; 重定向错误流到标准输出，等价于 2>&1
redirect_stderr=false
; 日志文件相关配置
stdout_logfile=/a/path ; 标准日志输出文件
stdout_logfile_maxbytes=1MB ; 标准日志文件大小，默认 50MB
stdout_logfile_backups=10 ; 标准日志文件备份保留的数量，默认 10
stdout_capture_maxbytes=1MB ; 当 capture 模式时写入到 FIFO 队列最大字节数，默认为 0
stderr_logfile=/a/path
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
; 环境变量设置
environment=A="1",B="2"
; 服务进程地址
serverurl=AUTO
配置示例：
[program:notebook]
command=jupyter notebook --notebook-dir=/home/konghy/JupyterNotebook --no-mathjax --no-browser
directory=/home/konghy/JupyterNotebook
stopsignal=QUIT
autostart=true
autorestart=true
startsecs=10
startretries=36
stopasgroup=true
killasgroup=true
stdout_logfile=/home/konghy/JupyterNotebook/.logs/ipython_check.log
stdout_logfile_backups=10
stdout_logfile_maxbytes=10MB
stderr_logfile=/home/konghy/JupyterNotebook/.logs/ipython_check_err.log
stderr_logfile_maxbytes=10MB
stderr_logfile_backups=10
使用
supervisor 的管理和使用只有两个命令：
supervisord: supervisor 的服务器端部分，用于 supervisor 启动
supervisorctl: 启动supervisor的命令行窗口，在该命令行中可执行 start、stop、status、reload 等操作
启动 supervisor 的服务器会默认启动所有应用：
supervisord -c /etc/supervisord.conf
supervisorctl
管理工具 supervisorctl 常用的子命令：
status: 查看程序状态
stop: 关闭程序
start: 启动程序
restart: 重启程序
reread: 读取有更新(增加)的配置文件，不会启动新添加的程序
update: 重启配置文件修改过的程序
tail: 查看进程日志
每次修改配置文件后需进入 supervisorctl，执行 reload， 改动部分才能生效，或者可以重启服务：
service supervisor reload
可以不用进入 supervisorctl 命令行，而直接在其后加上相应命令来完成操作，例如启动应用和查看状态：
$ supervisorctl
supervisor> status
supervisor> start app
默认的 supervisor 配置文件是放在 /etc/supervisord.conf 目录下，如果使用 supervisorctl 无法找到配置文件，其则无法获取与 supervisord 的连接方式，此时可能会有如下错误：
http://localhost:9001 refused connection
解决方式是使用 -c 指定配置文件位置：
supervisorctl -c /path/to/supervisord.conf status
或者将配置文件链接到 /etc 目录下：
ln -s /path/to/supervisord.conf /etc/
Web 管理界面
将配置文件中 [inet_http_server] 部分打开并做相应配置，然后重启 supervisor 服务即可用浏览器管理所有应用。
;[inet_http_server]
;port=127.0.0.1:9001 ; (ip_address:port specifier, *:port for ;all iface)
;username=user ; (default is no username (open server))
;password=123 ; (default is no password (open server))
添加开机启动服务
如果用 pip 或者 easy_instal 安装 supervisor，则不会默认将其添加到系统开机启动服务中。但这项工作可以自己来做，如果在 Ubuntu 系统下工作，用 apt 工具来安装则一切工作都会做好。
要添加系统服务首先需要在 /etc/init.d/ 中创建服务脚本，记得为脚本添加可执行权限 chmod a+x /etc/init.d/superviser，然后为将 supervisor 添加到系统服务中：
update-rc.d supervisor defaults
这样就 supervisor 就可以随系统开机启动，并且可以像系统服务那样来管理。
如果在 MacOSX 系统中使用 brew 安装，则可以使用 brew service 来添加开机启动：
brew services start supervisor
参考资料