Supervisor 的安装与配置教程

简介

Supervisor是一个进程控制系统. 它是一个C/S系统(注意: 其提供WEB接口给用户查询和控制), 它允许用户去监控和控制在类UNIX系统的进程. 它的目标与launchd, daemontools和runit有些相似, 但是与它们不一样的是, 它不是作为init(进程号pid是1)运行. 它是被用来控制进程, 并且它在启动的时候和一般程序并无二致.

通俗点，它的作用是什么？你的 Nginx，Tomcat，memcache，Redis...会崩么，不会？好吧，那你自己写的服务器监测脚本呢？好吧，不要再纠结了，交给 Supervisor 吧，它会帮你维护这些，即使它们不小心崩了，Supervisor 会帮你看住它们，维护它们。

依赖

supervisor 需要有 Python 环境。如果你是通过 pip 或者 easy_install 来安装的话，还需要 Python-seutptools 或者 python-pip，这些库的安装方法，在此处就不再一一介绍，自己查阅文档搞定。

安装

我这里是通过源码来安装的。

wget 下载安装包

wget https://pypi.python.org/packages/31/7e/788fc6566211e77c395ea272058eb71299c65cc5e55b6214d479c6c2ec9a/supervisor-3.3.3.tar.gz

解压到本地后，通过运行 setup.py install 安装

tar -xzvf supervisor-3.3.3.tar.gz
cd supervisor-3.3.3
python setup.py install

至此，安装完成了。接下来，我们需要设置 supervisor 的配置文件。

配置 Supervisor

首先，需要生成全局配置文件

echo_supervisord_conf > /etc/supervisord.conf
supervisord -c /etc/supervisord.conf

接着，我们需要修改下生成的 /etc/supervisord.conf 文件。我们在末尾添加 supervisor 的配置文件目录：

[include]

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

这里是指定了 supervisor 的配置文件目录以及文件名。今后如果有新的应用是需要supervisor来管理的，我们只需要到 /etc/supervisord/ 目录下，新建一个 xxx.ini 文件后，update 下就可以被 supervisor 加载到了。这里的目录不是必须是设置成当前目录。

配置完成后，我们需要让配置生效。

supervisord -c /etc/supervisord.conf

查看下是否run起来了

ps aux | grep supervisord

至此，supervisor 的配置就完成了。接下来，我们需要配置 Sentry 的 ini 文件，让 supervisor 来管理 Sentry 的进程。

配置 Sentry

根据上面的配置，我们在 /etc/supervisord.d/ 目录下新建 sentry.ini 文件。

touch sentry.ini

接下来，需要配置下 sentry.ini 文件。这里，我的配置信息如下：

[program:sentry_web]

command=/home/django_sentry/sentry/bin/sentry --config=/home/django_sentry/.sentry  run web

user=django_sentry

autostart=true

autorestart=true

startsecs=5

startretries=3

stdout_logfile=/tmp/sentry_web_access.log

stderr_logfile=/tmp/sentry_web_error.log

[program:sentry_worker]

command=/home/django_sentry/sentry/bin/sentry --config=/home/django_sentry/.sentry run worker

user=django_sentry

autostart=true

autorestart=true

startsecs=5

startretries=3

stdout_logfile=/tmp/sentry_worker_access.log

stderr_logfile=/tmp/sentry_worker_error.log

[program:sentry_cron]

command=/home/django_sentry/sentry/bin/sentry  --config=/home/django_sentry/.sentry run cron

user=django_sentry

autostart=true

autorestart=true

startsecs=5

startretries=3

stdout_logfile=/tmp/sentry_cron_access.log

stderr_logfile=/tmp/sentry_cron_error.log

这里，指定了三个 program，分别是 sentry_web, senry_worker, sentry_cron, 对应的指令分别就是 sentry run web， sentry run worker, sentry run cron。每个参数的说明在此不再赘述，详见： supervisor configuration。

配置完后，我们运行 supervisorctl reload 指令来重新加载下配置，这时候，通过 supervisorctl 来查看每个进程的启动执行情况如下：

如果运行不正常，可以使用 restart xxx 来重启某个进程，也可以 stop xxx 来停止某个进程。如果在重启中，可以通过 status 来查看启动的进度。只有当显示是 RUNNING 状态的时候，才表示运行正常。这里的截图显示，三个进程都已经运行起来了。 exit 退出。

今后，当我们在配置的目录中新增或更新了文件后，可以通过 supervisorctl update 来记载最新的配置。

至此， Supervisor 的安装和配置就结束了。

参考