需求描述

使用laravel队列时,artisan命令queue:work需要保证不挂掉。但是当服务器意外重启后,需要手动启动队列,因此需要用supervisor守护进程。

实现步骤

1. 安装

sudo pip install supervisor

#或者

easy_install supervisor

2. 配置

运行supervisord服务的时候,需要指定supervisor配置文件,如果没有显示指定,默认使用/etc/supervisord.conf
为了避免重装supervisor时丢失配置,建议通过echo_supervisord_conf程序重新生成supervisor的初始化配置文件:

mkdir /etc/supervisor
echo_supervisord_conf > /etc/supervisor/supervisord.conf

打开最后的include注释:

[include]
files=/etc/supervisor/conf.d/*.conf

新增的Supervisor配置文件放在 /etc/supervisor/conf.d/目录下,并且以.conf结尾。
下面增加一个配置文件:

[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /www/artisan queue:work --tries=3
autostart=true
autorestart=true
user=nginx
numprocs=8
redirect_stderr=true
stdout_logfile=/var/log/supervisor/laravel-queue.log

3. 启动Supervisor

可以使用我们新增的配置文件启动:

supervisord -c /etc/supervisor/supervisord.conf

如果是服务启动后新增的配置文件,那么需要重载、更新及重启:

sudo supervisorctl reread

sudo supervisorctl update

sudo supervisorctl start laravel-worker:*

到这里如果没有报错,那么Supervisor就启动成功了。

4. 配置服务文件

/usr/lib/systemd/system/下,新建supervisord.service文件:

# supervisord service for systemd (CentOS 7.0+)
# by ET-CS (https://github.com/ET-CS)
[Unit]
Description=Supervisor daemon

[Service]
Type=forking
ExecStart=/usr/bin/supervisord -c /etc/supervisor/supervisord.conf //指定启动的配置文件
ExecStop=/usr/bin/supervisorctl $OPTIONS shutdown
ExecReload=/usr/bin/supervisorctl $OPTIONS reload
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target

5. 开机自启服务

supervisorctl start all
systemctl enable supervisord

验证开机自启是否配置成功:

systemctl is-enabled supervisord

这里由于之前已经启动了supervisor,这里建议重启一下系统,一遍遇到奇怪的问题。然后查看服务状态,应该一切正常了。

systemctl status supervisord.service

附:配置文件说明

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

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

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

[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ;通过UNIX socket连接supervisord,路径与unix_http_server部分的file一致
;serverurl=http://127.0.0.1:9001 ; 通过HTTP的方式连接supervisord

; [program:xx]是被管理的进程配置参数,xx是进程的名称
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run ; 程序启动命令
autostart=true ; 在supervisord启动的时候也自动启动
startsecs=10 ; 启动10秒后没有异常退出,就表示进程正常启动了,默认为1秒
autorestart=true ; 程序退出后自动重启,可选值:[unexpected,true,false],默认为unexpected,表示进程意外杀死后才重启
startretries=3 ; 启动失败自动重试次数,默认是3
user=tomcat ; 用哪个用户启动进程,默认是root
priority=999 ; 进程启动优先级,默认999,值小的优先启动
redirect_stderr=true ; 把stderr重定向到stdout,默认false
stdout_logfile_maxbytes=20MB ; stdout 日志文件大小,默认50MB
stdout_logfile_backups = 20 ; stdout 日志文件备份数,默认是10
; stdout 日志文件,需要注意当指定目录不存在时无法正常启动,所以需要手动创建目录(supervisord 会自动创建日志文件)
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false ;默认为false,进程被杀死时,是否向这个进程组发送stop信号,包括子进程
killasgroup=false ;默认为false,向进程组发送kill信号,包括子进程

;包含其它配置文件
[include]
files = relative/directory/*.ini ;可以指定一个或多个以.ini结束的配置文件

参考文章

centos 7 使用supervisor 管理laravel 队列
Supervisor踩过的坑
Last modification:June 1st, 2020 at 07:15 pm