当使用 restart=on-failure 时，Laravel systemd 队列作业停止

我们有一个用于队列的 Laravel SystemD 作业，例如发送通知电子邮件。

现在我们注意到，当电子邮件发送失败时，SystemD 作业会停止。

这就是我们的服务定义的样子：

/etc/systemd/system # cat example.com-queue.service

[Unit]
Description=Laravel queue worker

[Service]
User=www-data
Group=www-data
Restart=on-failure
ExecStart=/usr/bin/php /var/www/html/example.com/web/artisan queue:work --daemon

[Install]
WantedBy=multi-user.target

网站https://www.freedesktop.org/software/systemd/man/systemd.service.html#Restart= https://www.freedesktop.org/software/systemd/man/systemd.service.html#Restart=指出，失败时不会“成功时”重新启动。

如果我们仔细观察服务状态，我们会发现 Laravel 队列实际上正在以“0”退出代码退出：

# systemctl status example.com-queue.service
● example.com-queue.service - Laravel queue worker
     Loaded: loaded (/etc/systemd/system/example.com-queue.service; enabled; vendor preset: enabled)
     Active: inactive (dead) since Sat 2021-08-14 15:11:18 CEST; 2 days ago
    Process: 2417820 ExecStart=/usr/bin/php /var/www/html/example.com/web/artisan queue:work --daemon (code=exited, status=0/SUCCESS)
Aug 14 15:11:08 example php[2417820]: [2021-08-14 15:11:08][16768] Processing: App\Notifications\UploadSuccess
Aug 14 15:11:18 example php[2417820]: [2021-08-14 15:11:18][16768] Failed:     App\Notifications\UploadSuccess
Aug 14 15:11:18 example systemd[1]: example.com-queue.service: Succeeded.

有一个简单的解决方法：我们可以切换到“Restart=always”，但我想阐明事实并找出为什么 Laravel - 在发生错误时 - 返回零退出代码。我们还担心“Restart=always”可能会导致不必要的副作用。

通常，我使用supervisor处理queues。不过它很先进，而且有很多article/support发布了其配置，您可以轻松找到它们。

我正在跟进Laravel 文章中的这个主管配置 https://rohit-shirke.medium.com/configuring-supervisor-for-laravel-queues-81e555e550c6

这对我来说非常有效，我已经配置了很多 Laravel 项目queues通过它。它还具有许多内置选项来处理queue-failure, restarting等等。此外，我们可以运行多个workers在最短的时间内轻松使用它。它是process handling方法非常优化并且有据可查。

基本安装流程：

管理 Laravel 队列或任何需要在服务器上运行的托管进程

sudo apt-get install supervisor

加载目录cd /etc/supervisor/conf.d并创建一个配置文件my-project-worker.conf并添加以下配置

[program:<custom-worker-name>]  
command=<project-directory-path>/artisan queue:work --tries=3  --sleep=3
directory=<project-directory-path i.e /var/www/html/example-project>
stdout_logfile=<custom-path-to-store-log i.e /var/www/html/example-project/storage/logs/supervisord.log>
redirect_stderr=true
autostart=true
autorestart=true
numprocs=1
stopwaitsecs=3600

## For Multiple Workers ##

[program:%(<custom-worker-name>)s_%(process_num)02d]  
command=<project-directory-path>/artisan queue:work --tries=3  --sleep=3
directory=<project-directory-path i.e /var/www/html/example-project>
stdout_logfile=<custom-path-to-store-log i.e /var/www/html/example-project/storage/logs/supervisord.log>
redirect_stderr=true
autostart=true
autorestart=true
numprocs=3
stopwaitsecs=3600

Note:确保设置<custom-worker-name>, <project-directory-path> and <custom-path-to-store-log>根据你的项目。

Remember当您部署包含对现有作业代码的修改的新代码时，您需要重新启动主管进程或该特定作业。

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start <custom-worker-name>:*

要检查正在运行的主管进程：

sudo supervisorctl

要检查进程的状态：

sudo systemctl status supervisor

要停止该进程：

sudo systemctl stop supervisor