Supervisor

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

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

Supervisord(服务端)
Supervisor的server部分称为supervisord。主要负责管理子进程,响应客户端的命令,log子进程的输出,建立和处理不一样的事件nginx

Supervisorctl(命令行)
Supervisor的命令行客户端。它能够与不一样的supervisord进程进行通讯,获取子进程信息,管理子进程web

Web Server(服务界面)
Supervisor的web server,用户能够经过web对子进程进行监控,管理等等,做用与supervisorctl一致。redis

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

安装服务器

Python安装

sudo pip install supervisor
easy_install supervisorapp

Liunx发行版安装

apt-get install supervisor
yum install supervisorsocket

使用
生成配置
echo_supervisord_conf > /path/to/supervisord.confui

若是出现没有权限的问题,可使用这条命令

sudo su - root -c "echo_supervisord_conf > /etc/supervisord.conf"
配置
配置文件supervisord.conf是一个ini文件,能够对http_server、supervisord、supervisorctl和program进行配置。

[unix_http_server]
;file=/tmp/supervisor.sock ; UNIX socket 文件,supervisorctl 会使用
file=/var/run/supervisor.sock ; (the path to the socket file)
;chmod=0700 ; socket 文件的 mode,默认是 0700
;chown=nobody:nogroup ; socket 文件的 owner,格式: uid:gid

;[inet_http_server] ; HTTP 服务器,提供 web 管理界面
;port=127.0.0.1:9699 ; Web 管理后台运行的 IP 和端口,若是开放到公网,须要注意安全性
;username=user ; 登陆管理后台的用户名
;password=123 ; 登陆管理后台的密码

[supervisord]
logfile=/tmp/supervisord.log ; 日志文件,默认是 $CWD/supervisord.log
logfile_maxbytes=50MB ; 日志文件大小,超出会 rotate,默认 50MB
logfile_backups=10 ; 日志文件保留备份数量默认 10
loglevel=info ; 日志级别,默认 info,其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ; pid 文件
nodaemon=false ; 是否在前台启动,默认是 false,即以 daemon 的方式启动
minfds=1024 ; 能够打开的文件描述符的最小值,默认 1024
minprocs=200 ; 能够打开的进程数的最小值,默认 200

[supervisorctl]
serverurl=unix:///var/run/supervisor.sock ; 经过 UNIX socket 链接 supervisord
;serverurl=http://127.0.0.1:9001 ; 经过 HTTP 的方式链接 supervisord

; 包含其余的配置文件
[include]
files = relative/directory/.ini ; 能够是 .conf 或 *.ini

[program:redis]
command = redis-server //须要执行的命令
autostart=true //supervisor启动的时候是否随着同时启动
autorestart=true //当程序跑出exit的时候,这个program会自动重启
startsecs=3 //程序重启时候停留在runing状态的秒数

; 管理的单个进程的配置,能够添加多个program
[program:chatdemon]
command=python /home/felinx/demos/chat/chatdemo.py
autostart = true
startsecs = 5
user = felinx
redirect_stderr = true
;这对这个program的log的配置,上面的logfile_maxbytes是supervisord自己的log配置
stdout_logfile_maxbytes = 20MB
stdoiut_logfile_backups = 20
stdout_logfile = /var/log/supervisord/chatdemo.log

; 配置一组进程,对于相似的program能够经过这种方式添加,避免手工一个个添加
[program:groupworker]
command=python /home/felinx/demos/groupworker/worker.py
numprocs=24
process_name=%(program_name)s_%(process_num)02d
autostart = true
startsecs = 5
user = felinx
redirect_stderr = true
stdout_logfile = /var/log/supervisord/groupworker.log

[program:usercenter]
directory = /home/leon/projects/usercenter ; 程序的启动目录
command = gunicorn -c gunicorn.py wsgi:app ; 启动命令,能够看出与手动在命令行启动的命令是同样的
autostart = true ; 在 supervisord 启动的时候也自动启动
startsecs = 5 ; 启动 5 秒后没有异常退出,就看成已经正常启动了
autorestart = true ; 程序异常退出后自动重启
startretries = 3 ; 启动失败自动重试次数,默认是 3
user = leon ; 用哪一个用户启动
redirect_stderr = true ; 把 stderr 重定向到 stdout,默认 false
stdout_logfile_maxbytes = 20MB ; stdout 日志文件大小,默认 50MB
stdout_logfile_backups = 20 ; stdout 日志文件备份数
; stdout 日志文件,须要注意当指定目录不存在时没法正常启动,因此须要手动建立目录(supervisord 会自动建立日志文件)
stdout_logfile = /data/logs/usercenter_stdout.log

; 能够经过 environment 来添加须要的环境变量,一种常见的用法是修改 PYTHONPATH
; environment=PYTHONPATH=$PYTHONPATH:/path/to/somewhere
(更多配置说明请参考:http://supervisord.org/configuration.html

Supervisord管理
Supervisord安装完成后有两个可用的命令行supervisor和supervisorctl,命令使用解释以下:

命令 解释 supervisord [ -c /etc/supervisord.conf ] 初始启动Supervisord,启动、管理配置中设置的进程。 supervisorctl stop programxxx 中止某一个进程(programxxx),programxxx为[program:chatdemon]里配置的值,这个示例就是chatdemon。 supervisorctl start programxxx 启动某个进程 supervisorctl restart programxxx 重启某个进程 supervisorctl stop groupworker: 重启全部属于名为groupworker这个分组的进程(start,restart同理) supervisorctl stop all 中止所有进程,注:start、restart、stop都不会载入最新的配置文件。 supervisorctl reload 载入最新的配置文件,中止原有进程并按新的配置启动、管理全部进程。 supervisorctl update 根据最新的配置文件,启动新配置或有改动的进程,配置没有改动的进程不会受影响而重启。 ctl中: help 查看命令 ctl中: status 查看状态 supervisorctl -c conf/app.conf status 自定义配置路径须要这么进?没尝试 使用注意 用supervisor启动Redis,nginx等进程时,须要在注释掉相关进程的启动方式不要用守护模式启动(daemonize为no) supervisor进程文件默认放在 /tmp 目录下,修改成 /var/run 目录,避免被系统删除 supervisor日志文件默认在 /tmp/supervisord.log

相关文章
相关标签/搜索