supervisor 使用方式和介绍

supervisor 使用方式和介绍

supervisor：用Python写的守护进程软件，在linux上启动之后，可以实时的守护要启动的进程，并且进行重启，启停等相关操作。
此处是配合thinkphp5中的think-queue使用，守护php think queue:work --daemon --queue 等相关进程。
安装如下：

yum install epel-release

yum install -y supervisor

安装完成之后：
默认配置文件：/etc/supervisord.conf
进程管理配置文件放到了：/etc/supervisor/conf.d 下即可
在conf.d下建立conf文件，然后在supervisord.conf 使用以下命令引入即可；
引入配置：
;在此新增配置行
[include]
files = files = supervisor/conf.d/*.conf

相关配置示例：

[program:queue_dealError] ;项目名称
directory = /var/www/html/testdmcard ; 程序的启动目录
command = php think queue:work --daemon --queue dealErrorJobQueue --sleep 3  ; 启动命令
process_name=%(program_name)s_%(process_num)02d
numprocs = 1           ; 开启的进程数量
autostart = true     ; 在 supervisord 启动的时候也自动启动
startsecs = 5        ; 启动 5 秒后没有异常退出，就当作已经正常启动了
autorestart = true   ; 程序异常退出后自动重启
startretries = 10     ; 启动失败自动重试次数，默认是 3
; user = www          ; 用哪个用户启动
; redirect_stderr = true  ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 50MB  ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 20     ; stdout 日志文件备份数
; stdout 日志文件,需要手动创建目录（supervisord 会自动创建日志文件）
stdout_logfile = /var/log/supervisor/queue_dealError.log
loglevel=info

相关命令行：
更新新的配置到supervisord supervisorctl update
重新启动配置中的所有程序 supervisorctl reload
查看正在守候的进程 supervisorctl
执行supervisorctl 后，可以进行以下操作：
启动某个进程(program_name=你配置中写的程序名称) start program_name
停止某一进程 (program_name=你配置中写的程序名称) stop program_name
重启某一进程 (program_name=你配置中写的程序名称) restart program_name
停止全部进程 supervisorctl stop all
查看当前执行的 supervisor ps -ef | grep supervisord
注意应当只有一个进程在运行，多余进程可用kill+pid杀死。
注意在新增配置的时候，必须要执行 supervisorctl update和 supervisorctl reload后，才会成功启动进程， supervisorctl 不会自动读取配置！！
相关链接资料：
https://www.cnblogs.com/restran/p/4854623.html
http://www.thinkphp.cn/topic/46464.html
https://blog.csdn.net/kkevinyang/article/details/80539940
http://www.ttlsa.com/linux/using-supervisor-control-program/
http://ju.outofmemory.cn/entry/80509
https://blog.csdn.net/wangjianwanxiao/article/details/51007354
https://www.jianshu.com/p/f8735b039c67?from=groupmessage

一些错误和解决方案：

下面是三种常见的通用报错：
第一类：
报错信息：

error: <class 'socket.error'>, [Errno 2] No such file or directory: file: <string> line: 1

解决办法：
这个可能有多种原因，可能是已经启动过了也可能是没权限，解决步骤如下：

1. 先要确认是否已经启动过了：’ps -ef | grep supervisord’
2. 如果有的话先kill掉
3. 运行下面命令：
   sudo touch /var/run/supervisor.sock
sudo chmod 777 /var/run/supervisor.sock
4. 再尝试重新启动：supervisord -c /etc/supervisord.conf(如果没有文件找个别人的配置拷贝过来或者运行echo_supervisord_conf > /etc/supervisord.conf)

第二类：
报错信息：

Error: .ini file does not include supervisorctl section

解决办法：
又是一个权限问题的，步骤：

1. 先确保supervisord.conf中有[supervisord]，[supervisorctl]有这两个基本模块，还有[program:XXX]自己程序的配置（可以在supervisord.conf也可以在/etc/supervisor/*.ini中）
2. 最关键的两个命令：
   . chmod +x /usr/bin/supervisord
chmod +x /usr/bin/supervisorctl
chmod +x /etc/supervisord.conf （主要是把把相关文件都授权了）
3. 把supervisord杀掉后再次启动supervisord