使用Supervisor管理Redis进程

环境：MAC OS

Supervisor (http://supervisord.org) 是一个用 Python 写的进程管理工具，可以很方便的用来启动、重启、关闭进程（不仅仅是 Python 进程）。除了对单个进程的控制，还可以同时启动、关闭多个进程，比如很不幸的服务器出问题导致所有应用程序都被杀死，此时可以用 supervisor 同时启动所有应用程序而不是一个一个地敲命令启动。

安装过程，

安装pip：

➜ ~ sudo easy_install pip

然后安装supervisor

➜ ~ sudo pip install supervisor

安装完成。

supervisord配置

Supervisor 相当强大，提供了很丰富的功能，不过我们可能只需要用到其中一小部分。安装完成之后，可以编写配置文件，来满足自己的需求。为了方便，我们把配置分成两部分：supervisord（supervisor 是一个 C/S 模型的程序，这是 server 端，对应的有 client 端：supervisorctl）和应用程序（即我们要管理的程序）。

首先来看 supervisord 的配置文件。安装完 supervisor 之后，可以运行echo_supervisord_conf 命令输出默认的配置项，也可以重定向到一个配置文件里：

➜  ~ type echo_supervisord_conf
echo_supervisord_conf is /usr/local/bin/echo_supervisord_conf
➜  ~ echo_supervisord_conf > /Users/xinxingegeya/IDE/supervisor/etc/supervisord.conf

生成的该配置文件为默认配置选项，具体详细介绍请参照：http://supervisord.org/configuration.html

启动supervisord

可以使用-c参数指定配置文件，如果没有指定的话会从以下位置寻找配置文件，

$CWD/supervisord.conf
$CWD/etc/supervisord.conf
/etc/supervisord.conf
../etc/supervisord.conf (Relative to the executable)
../supervisord.conf (Relative to the executable)

注意：CWD是current work directory的缩写。

如下启动supervisord，

➜  supervisor supervisord -c ./etc/supervisord.conf
➜  supervisor ps -ef | grep supervisord
  501  1441     1   0 11:45下午 ??         0:00.01 /usr/bin/python /usr/local/bin/supervisord -c ./etc/supervisord.conf
  501  1455   822   0 11:45下午 ttys000    0:00.00 grep --color=auto --exclude-dir=.bzr --exclude-dir=CVS --exclude-dir=.git --exclude-dir=.hg --exclude-dir=.svn supervisord
➜  supervisor

可以看到启动成功。那么如何来管理进程呢？

进程管理的配置文件

使用supervisor管理进程，首先要有一个进程的配置文件，以redis的进程为例，使用supervisor管理redis的进程。

redis的安装过程略，具体可以参考http://my.oschina.net/xinxingegeya/blog/389155，下面来配置一个redis进程的配置文件。

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

该program的名字表示这是一个在端口7000上启动的redis进程。注意redis进程要以非daemon方式启动。

需要在supervisord.conf配置文件中包含该进程配置文件。打开supervisord.conf配置文件修改include选项为：

[include]
files = ../*.supervisor

表示该配置文件所在目录的父级目录中的以supervisor结尾的配置都要包含进来。

刚才配置的redis_7000进程的配置文件的路径为，

/Users/xinxingegeya/IDE/redis/redis_7000/redis_7000.supervisor

所以要在supervisord.conf的父级目录中创建一个以supervisor结尾的软链接。如下，

➜  supervisor ln ~/IDE/redis/redis_7000/redis_7000.supervisor redis_7000.supervisor
➜  supervisor ll
total 88
drwxr-xr-x  3 xinxingegeya  staff   102B  4 14 00:09 etc
-rw-r--r--@ 2 xinxingegeya  staff    41K  3 23 22:21 redis_7000.supervisor
➜  supervisor

刚才更改了supervisor的配置，重新启动一下supervisord。

使用supervisorctl

Supervisorctl是supervisord的一个命令行客户端工具，启动时需要指定与 supervisord 使用同一份配置文件，否则与 supervisord 一样按照顺序查找配置文件。

启动supervisor后，运行supervisorctl命令，如下，

➜  supervisor supervisorctl
redis_7000                       RUNNING   pid 3479, uptime 0:00:09
supervisor>

可以看到一个被supervisor管理的进程，名字是redis_7000，运行状态为RUNNING。有一些命令可以用来管理进程，比如启动（start），停用（stop），重启（restart），重新启动supervisord（reload），启动新配置或有改动的进程（update），查看被管理的进程的状态（status）等。如下，

➜  supervisor supervisorctl
redis_7000                       RUNNING   pid 3479, uptime 0:00:09
supervisor> status
redis_7000                       RUNNING   pid 3479, uptime 0:06:10
supervisor> stop redis_7000
redis_7000: stopped
supervisor> status
redis_7000                       STOPPED   Apr 14 10:13 AM
supervisor> start redis_7000
redis_7000: started
supervisor> restart redis_7000
redis_7000: stopped
redis_7000: started
supervisor> stop redis_7000
redis_7000: stopped
supervisor> reload
Really restart the remote supervisord process y/N? y
Restarted supervisord
supervisor> status
redis_7000                       RUNNING   pid 3506, uptime 0:00:07
supervisor> update
supervisor> stop redis_7000
redis_7000: stopped
supervisor> update
supervisor> status
redis_7000                       STOPPED   Apr 14 10:15 AM
supervisor> reload
Really restart the remote supervisord process y/N? y
Restarted supervisord
supervisor> status
redis_7000                       STARTING
supervisor> status
redis_7000                       RUNNING   pid 3511, uptime 0:00:08
supervisor>

=========END=========

来源：oschina

链接：https://my.oschina.net/u/1469576/blog/659095

标签

supervisord

Redis

supervisorctl