简介
supervisor是一个系统进程管理工具,便于我们控制一些脚本的执行,开发人员可以用python为其编写扩展。也提供了 XML-RPC 接口,便于控制
安装
- 可以通过
pip install supervisor
安装,详见文档 - 通过
echo_supervisord_conf > /etc/supervisord.conf
可以看到配置文件的例子 - 如果您没有 root 访问权限,或者您不想将 supervisord.conf文件放在/etc/supervisord.conf 中,您可以将它放在当前目录中(echo_supervisord_conf > supervisord.conf)并使用 -启动supervisord c标志以指定配置文件位置。
例如,supervisord -c supervisord.conf。
基础的配置
因为只是简单的使用,只对默认的配置文件进行更改,这里我是通过导入在各个项目里的配置文件来配置的
在配置文件的最下面加上需要的配置文件
[include]
files = relative/directory/*.ini /root/wuziji/wuziji.ini /root/zhongshangkemao/django/zhongshang.ini
为了便于控制,启用了web控制页面
[inet_http_server] ; inet (TCP) server disabled by default
port=0.0.0.0:3001 ; (ip_address:port specifier, *:port for all iface)
username=你设置的用户名 ; (default is no username (open server))
password=你设置的密码 ; (default is no password (open server))
接着再看一下对应的配置文件是怎么设置的
#项目名
[program:wuziji]
#脚本目录
directory=/root/wuziji/house-collection
#脚本执行命令
command=/root/.pyenv/versions/wuziji2/bin/python /root/wuziji/house-collection/manage.py runserver 0.0.0.0:8000
#supervisor启动的时候是否随着同时启动,默认True
autostart=true
#当程序exit的时候,这个program不会自动重启,默认unexpected,设置子进程挂掉后自动重启的情况,有三个选项,false,unexpected和true。如果为false的时候,无论什么情况下,都不会被重新启动,如果为unexpected,只有当进程的退出码不在下面的exitcodes里面定义的
autorestart=false
#这个选项是子进程启动多少秒之后,此时状态如果是running,则我们认为启动成功了。默认值为1
startsecs=1
#脚本运行的用户身份
user = root
#日志输出
stderr_logfile=/tmp/blog_stderr.log
stdout_logfile=/tmp/blog_stdout.log
#把stderr重定向到stdout,默认 false
redirect_stderr = true
#stdout日志文件大小,默认 50MB
stdout_logfile_maxbytes = 20MB
#stdout日志文件备份数
stdout_logfile_backups = 20
常用命令
supervisorctl status //查看所有进程的状态
supervisorctl stop es //停止es
supervisorctl start es //启动es
supervisorctl restart //重启es
supervisorctl update //配置文件修改后使用该命令加载新的配置
supervisorctl reload //重新启动配置中的所有程序
注:把es换成all可以管理配置中的所有进程。直接输入supervisorctl进入supervisorctl的shell交互界面,此时上面的命令不带supervisorctl可直接使用。
注意事项
使用supervisor进程管理命令之前先启动supervisord,否则程序报错。
使用命令supervisord -c /etc/supervisord.conf
启动。
若是centos7:
systemctl start supervisord.service //启动supervisor并加载默认配置文件
systemctl enable supervisord.service //将supervisor加入开机启动项
常见问题
unix:///var/run/supervisor.sock no such file
问题描述:安装好supervisor没有开启服务直接使用supervisorctl报的错
解决办法:supervisord -c /etc/supervisord.conf
command中指定的进程已经起来,但supervisor还不断重启
问题描述:command中启动方式为后台启动,导致识别不到pid,然后不断重启,这里使用的是elasticsearch,command指定的是$path/bin/elasticsearch -d
解决办法:supervisor无法检测后台启动进程的pid,而supervisor本身就是后台启动守护进程,因此不用担心这个
启动了多个supervisord服务,导致无法正常关闭服务
问题描述:在运行supervisord -c /etc/supervisord.conf之前,直接运行过supervisord -c /etc/supervisord.d/xx.conf导致有些进程被多个superviord管理,无法正常关闭进程。
解决办法:使用ps -fe | grep supervisord查看所有启动过的supervisord服务,kill相关的进程。
参考自https://www.jianshu.com/p/0b9054b33db3