Supervisor

1, 简介

Supervisor是用Python开发的一个client/server服务，是Linux/Unix系统下的一个进程管理工具，不支持Windows系统。它可以很方便的监听、启动、停止、重启一个或多个进程。用Supervisor管理的进程，当一个进程意外被杀死，supervisor监听到进程死后，会自动将它重新拉起，很方便的做到进程自动恢复的功能，不再需要自己写shell脚本来控制。

不使用守护进程会出现的以下问题：

1.1某些程序被杀死后不再运行，导致服务不可用，应用直接挂掉。

1.2 某些进程意外终止后，比如误杀，服务器宕机或需要重启，如果再次启动，需要人为操作，时效性不好。

为了解决这些问题，我们需要有一个程序来监听应用程序的状况。并在应用程序停止运行的时候立即重新启动。

Supervisor包含有两个程序:

Supervisor的Server部分称为supervisord，主要负责管理子进程，响应客户端的命令，log子进程的输出，创建和处理不同的事件。
Supervisor的命令行客户端部分称为supervisorctl，它可以与不同的supervisord进程进行通信，获取子进程信息，管理子进程。

2，安装和使用

2.1 安装Python包管理工具(easy_install)

sudo apt-get install python-setuptools

或者

yum install python-setuptools

按不同的Linux系统来决定，下面以ubuntu为例。

2.2 安装Supervisor

sudo easy_install supervisor

2.3 配置Supervisor应用守护

2.3.1 通过运行echo_supervisord_conf程序生成supervisor的初始化配置文件，如下所示：

mkdir /etc/supervisor
echo_supervisord_conf > /etc/supervisor/supervisord.conf

然后查看路径下的supervisord.conf。在文件尾部添加如下配置:

...

;[include]
;files = relative/directory/*.ini

;supervisord.d 为配置表目录的文件夹，需要手动创建
[include]
files = conf.d/*.conf
或者
files = supervisord.d/*.ini

这里的配置文件目录可以自己定义，我这里用的是后面这一种

-rw-r--r--   1 root root     7953 7月  29 2017 supervisord.conf
drwxr-xr-x   2 root root     4096 12月  9 21:01 supervisord.d

2.3.2 按照上述配置，为你的程序创建一个.conf或者.ini文件，放在目录"/etc/supervisor/supervisord.d/"下。

下面是我的一个名字为abc.ini的配置文件的内容:

;程序名称，终端控制时需要的标识
[program:abc]
process_name=%(program_name)s_%(process_num)02d
;运行程序的命令
command=php /www/web/abc-server/artisan queue:work  --sleep=3 --tries=3
; 程序是否随服务器自动启动
autostart=true
; 程序意外退出是否自动重启
autorestart=true
; 进程执行的用户身份
user=www
; 进程数
numprocs=2
; stderr的日志会被写入stdout日志文件中
redirect_stderr=true
; 子进程的stdout的日志路径，可以指定路径，AUTO，none等三个选项
stdout_logfile=/var/log/abc.log

这里我用它来监听某个php的消息队列。

2.3.3 运行supervisord，查看是否生效

supervisord -c /etc/supervisor/supervisord.conf
ps -ef | grep abc-server

成功后的效果:

www       4247 26091  0 12月07 ?      00:00:49 php /www/web/abc-server/artisan queue:work --sleep=3 --tries=3
www       4912 26091  0 12月07 ?      00:00:48 php /www/web/abc-server/artisan queue:work --sleep=3 --tries=3
root     12013  9198  0 21:19 pts/1    00:00:00 grep --color abc-server

PS: 如果服务已启动，修改配置文件可用“supervisorctl reload”命令来使其生效。更多可访问官方文档地址: http://supervisord.org

2.4、配置Supervisor开机启动

2.4.1 新建一个“supervisord.service”文件，内容如下:

[Unit]
Description=Process Monitoring and Control Daemon
After=rc-local.service nss-user-lookup.target

[Service]
Type=forking
ExecStart=/usr/bin/supervisord -c /etc/supervisord/supervisord.conf #之前创建的conf文件地址
ExecStop=/usr/bin/supervisorctl shutdown
ExecReload=/usr/bin/supervisorctl reload
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target

2.4.2 将文件拷贝至 "/usr/lib/systemd/system/supervisord.service"

2.4.3 启动supervisord

systemctl enable supervisord

2.4.4 验证是否为开机启动

systemctl is-enabled supervisord

结果

enabled

至此，配置就完成了。

3，网页管理

在配置文件/etc/supervisor/supervisord.conf中加入如下两行

[inet_http_server]
port = :9001

supervisorctl reload 重新加载配置。打开浏览器输入 http://localhost:9001, 应该就会看到这个页面了，网页上的功能也很全。

4，常用的相关管理命令

supervisorctl restart <application name> ;重启指定应用
supervisorctl stop <application name> ;停止指定应用
supervisorctl start <application name> ;启动指定应用
supervisorctl restart all ;重启所有应用
supervisorctl stop all ;停止所有应用
supervisorctl start all ;启动所有应用

官方文档：http://supervisord.org/

来源：oschina

链接：https://my.oschina.net/u/3412738/blog/3139402

标签