Supervisor_快速使用

安装
无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的初始化配置文件

image

添加后台启动服务

[program:storm]  
directory=/root   # 执行命令进入目录
command=storm supervisor   # 执行的命令
autostart=true    # 默认重新加载配置文件
autorestart=true    

image

启动

supervisord -c /etc/supervisord.conf
ps -ef | grep supervisord(查看是否启动)

image

配置管理进程

1> 创建/etc/supervisor/config.d目录，用于存放进程管理的配置文件
2> 修改/etc/supervisor/supervisord.conf中的include参数，将/etc/supervisor/conf.d目录添加到include中

[include]
files = /etc/supervisor/config.d/*.ini

image image

启动
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

image

image image

备注：

• supervisorctl还有其他命令，点击这里查看官网文档
• supervisorctl命令的默认配置文件是：/etc/supervisord.conf
• Supervisor只能管理非daemon的进程，也就是说Supervisor不能管理守护进程。否则提示Exited too quickly (process log may have details)异常。
• yum安装 默认配置文件：/etc/supervisord.conf
  进程管理配置文件放到：/etc/supervisord.d/目录下即可