安装
无python环境
yum -y install python-setuptools
easy_install supervisor
supervisord -v
有python环境
pip install supervisor
使用yum install -y supervisor的命令安装
会生成默认配置/etc/supervisord.conf和目录/etc/supervisord.d
如果没有则自行创建。
easy_install
是setuptools包里带的一个命令,使用easy_install实际上是在调用setuptools来完成安装模块的工作
,
修改配置文件
mkdir /etc/supervisor
echo_supervisord_conf > /etc/supervisord.conf
vi /etc/supervisord.conf
;修改include配置,去除注释
[include]
files = /etc/supervisor/*.conf
echo_supervisord_conf
程序生成supervisor
的初始化配置文件
添加后台启动服务
[program:storm]
directory=/root # 执行命令进入目录
command=storm supervisor # 执行的命令
autostart=true # 默认重新加载配置文件
autorestart=true
启动
supervisord -c /etc/supervisord.conf
ps -ef | grep supervisord
(查看是否启动)
配置管理进程
1> 创建
/etc/supervisor/config.d
目录,用于存放进程管理的配置文件
2> 修改/etc/supervisor/supervisord.conf
中的include
参数,将/etc/supervisor/conf.d
目录添加到include
中
[include]
files = /etc/supervisor/config.d/*.ini
启动
supervisord -c /etc/supervisor/supervisord.conf
详细配置文件
管理应用的配置
进入到/etc/supervisord.d/conf目录,创建管理应用的配置,可以创建多个应用配置。
例如,创建confd.conf配置。
[program:confd]
directory = /usr/local/bin ; 程序的启动目录
command = /usr/local/bin/confd -config-file /etc/confd/confd.toml ; 启动命令,与命令行启动的命令是一样的
autostart = true ; 在 supervisord 启动的时候也自动启动
startsecs = 5 ; 启动 5 秒后没有异常退出,就当作已经正常启动了
autorestart = true ; 程序异常退出后自动重启
startretries = 3 ; 启动失败自动重试次数,默认是 3
user = root ; 用哪个用户启动
redirect_stderr = true ; 把 stderr 重定向到 stdout,默认 false
stdout_logfile_maxbytes = 20MB ; stdout 日志文件大小,默认 50MB
stdout_logfile_backups = 20 ; stdout 日志文件备份数
; stdout 日志文件,需要注意当指定目录不存在时无法正常启动,所以需要手动创建目录(supervisord 会自动创建日志文件)
stdout_logfile = /etc/supervisord.d/log/confd.log ;日志统一放在log目录下
; 可以通过 environment 来添加需要的环境变量,一种常见的用法是修改 PYTHONPATH
; environment=PYTHONPATH=$PYTHONPATH:/path/to/somewhere
Tips 1: 后台进程
Supervisor 只能管理在前台运行的程序,所以如果应用程序有后台运行的选项,需要关闭。
Tips 2: 子进程
有时候用 Supervisor 托管的程序还会有子进程(如 Tornado),如果只杀死主进程,子进程就可能变成孤儿进程。通过这两项配置来确保所有子进程都能正确停止:
stopasgroup=true
killasgroup=true
交互终端
supervisord
启动成功后,可以通过supervisorctl
客户端控制进程,启动、停止、重启。运行supervisorctl
命令,不加参数,会进入supervisor
客户端的交互终端,并会列出当前所管理的所有进程。
上图中的logstash
就是我们在配置文件中[program:tomcat]
指定的名字。
> status # 查看程序状态
> stop usercenter # 关闭 usercenter 程序
> start usercenter # 启动 usercenter 程序
> restart usercenter # 重启 usercenter 程序
> reread # 读取有更新(增加)的配置文件,不会启动新添加的程序
> update # 重启配置文件修改过的程序
bash管理(supervisorctl)
supervisorctl status
查看程序状态
supervisorctl stop tomcat
supervisorctl start tomcat
supervisorctl restart tomcat
supervisorctl reread
读取有更新(增加)的配置文件,不会启动新添加的程序
supervisorctl update
重启配置文件修改过的程序
Web管理界面
出于安全考虑,默认配置是没有开启web管理界面,需要修改supervisord.conf配置文件打开http访权限,将下面的配置:
vi /etc/supervisord.conf
备注:
-
supervisorctl
还有其他命令,点击这里查看官网文档 -
supervisorctl
命令的默认配置文件是:/etc/supervisord.conf
-
Supervisor
只能管理非daemon的进程,也就是说Supervisor不能管理守护进程。
否则提示Exited too quickly (process log may have details)异常。 - yum安装 默认配置文件:
/etc/supervisord.conf
进程管理配置文件放到:/etc/supervisord.d/目录下即可