Supervisor 详细用法

之前说 Ghost 博客的时候提到过这个东西,用 Supervisor 守护 node 的进程,当时的配置文件是长这个样子的

[program:homepage]
command = node /var/www/homepage/index.js  
directory = /var/www/homepage  
user = root  
autostart = true  
autorestart = true  
stdout_logfile = /var/log/supervisor/homepage.log  
stderr_logfile = /var/log/supervisor/homepage_err.log  
environment = NODE_ENV="production"

 

安装

pip install supervisor

创建配置文件

cd /etc/supervisor/conf.d  
nano test.conf

 

配置文件一般是这个格式,

[program:homepage]
command = python /var/www/test/homepage.py  
user = root  
autostart = true  
autorestart = true  
stdout_logfile = /var/log/supervisor/homepage.log  
stderr_logfile = /var/log/supervisor/homepage_err.log

 

应该都能看懂吧。

生效

简单粗暴一点可以直接 service supervisor restart,当然这不是最优雅的方法,优雅一点,可以

supervisorctl start test supervisorctl stop test,查看当前状态可以输入supervisorctl status,全部关闭可以 supervisorctl shutdown

Web控制台

supervisord.conf 中开启 HTTP 即可

[inet_http_server]
port=xxx.xx.xxx.xxx:8794  
username=username  
password=pwd

 

浏览器打开这个地址就可以看到相关内容

可以进行管理,查看日志等操作。

via:pupboss.com

进程的守护神 – Supervisor

Supervisor是一个Python开发的client/server系统,可以管理和监控*nix上面的进程。不过同daemontools一样,它也不能监控daemon进程

部件

Supervisor有不同的部件组成,部件分别负责不同的功能,对进程进行监控和管理。

  • supervisord
    Supervisor的server部分称为supervisord。主要负责管理子进程,响应客户端的命令,log子进程的输出,创建和处理不同的事件

  • supervisorctl
    Supervisor的命令行客户端。它可以与不同的supervisord进程进行通信,获取子进程信息,管理子进程

  • Web Server
    Supervisor的web server,用户可以通过web对子进程进行监控,管理等等,作用与supervisorctl一致。

  • XML-RPC interface
    XML-RPC接口,提供XML-RPC服务来对子进程进行管理,监控

安装

安装supervisor很简单,通过pip就可以安装

sudo pip install supervisor

安装完成之后,就可以用"echo_supervisord_conf"命令来生成配置文件,例如

echo_supervisord_conf > /etc/supervisord.conf
echo_supervisord_conf > /path/to/supervisord.conf

配置

配置文件supervisord.conf是一个ini文件,可以对http_server、supervisord、supervisorctl和program进行配置。不过默认生成的文件已经对大部分进行配置,如果简单使用,只需要配置program的部分就可以了。

配置文件必须要有一个program配置项,这样supervisord才知道哪个program需要被管理和监控。例如下面tornado和nodejs应用的配置
“`
[program:tornado_app]
command=python /home/vagrant/tornado/app.py
startsecs=0
stopwaitsecs=0
autostart=true
autorestart=true
stdout_logfile=/home/vagrant/tornado/log/app.log
stderr_logfile=/home/vagrant/tornado/log/app.err

[program:node_app]
command=node /home/vagrant/node/app.js
startsecs=0
stopwaitsecs=0
autostart=true
autorestart=true
stdout_logfile=/home/vagrant/node/log/app.log
stderr_logfile=/home/vagrant/node/log/app.err
“`

启动

配置文件生成之后,就可以启动supervisord了

supervisord #默认使用/etc/supervisord.conf的配置文件
supervisord -c /path/to/supervisord.conf

当配置文件变化后,可以通过下面的命令reload conf,然后重启supervisord进程

kill -HUP cat /tmp/supervisord.pid #不过试了一下没有成功

通过supervisordctl管理进程

然后通过supervisorctl就可以监控管理program了
“`
$ supervisorctl -c conf/app.conf status
node_app RUNNING pid 6916, uptime 0:00:00
tornado_app RUNNING pid 6917, uptime 0:00:00

$ supervisorctl -c conf/app.conf stop node_app
node_app: stopped

$ supervisorctl -c conf/app.conf stop tornado_app
tornado_app: stopped

$ supervisorctl -c conf/app.conf status
node_app STOPPED Apr 04 02:34 AM
tornado_app STOPPED Apr 04 02:35 AM

$ supervisorctl -c conf/app.conf start all
node_app: started
tornado_app: started

$ supervisorctl -c conf/app.conf status
node_app RUNNING pid 8080, uptime 0:00:00
tornado_app RUNNING pid 8079, uptime 0:00:00
“`

通过web管理进程

如果配置文件开启http server,那么就可以通过web界面来管理program了。

$ grep -A 3 "inet_http_server" conf/app.conf
[inet_http_server] ; inet (TCP) server disabled by default
port=0.0.0.0:8383 ; (ip_address:port specifier, *:port for all iface)
#username=user ; (default is no username (open server))
#password=123 ; (default is no password (open server))

然后打开 http://domain.com:8383 就可以访问了

问题

通过supervisord可以很方便的管理program,可以同时管理多个program,也可以管理一个program的多个进程。而且提供了命令行、web、xml-rpc的接口来管理和监控进程,通过配置文件,可以指定进程挂掉后如何处理(可以重启或者其它方式处理挂掉的进程)

但是,supervisord本身也是一个program,如果它自己挂掉了怎么办?

via http://linbo.github.io/2013/04/04/supervisor/