Supervisor для очередей Laravel: конфиг воркера
Supervisor держит процессы queue:work запущенными и поднимает их после падения. Файл /etc/supervisor/conf.d/laravel-worker.conf задаёт команду, пользователя и число воркеров. В конфиге меняют путь к проекту, пользователя сайта и numprocs.
Конфиг
[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/example.com/artisan queue:work --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=2
redirect_stderr=true
stdout_logfile=/var/www/example.com/storage/logs/worker.log
stopwaitsecs=3600
Что заменить под свой сервер
/var/www/example.com- папка проекта
www-data- пользователь, от которого работает сайт
numprocs=2- сколько воркеров держать
Как применить и проверить
sudo apt install supervisor
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status
Что делает каждая строка конфига
Секция [program:laravel-worker] задаёт имя программы, по нему вы управляете ею через supervisorctl. process_name формирует имена процессов из имени программы и номера, поэтому в статусе видны laravel-worker_00 и laravel-worker_01. В command указан полный путь к artisan и параметры --sleep=3 --tries=3 --max-time=3600: пауза между опросами очереди, число попыток на задачу и перезапуск воркера через час работы. autostart и autorestart включают запуск при старте Supervisor и перезапуск после выхода процесса. stopasgroup и killasgroup останавливают и убивают всю группу процессов, а не только родительский. user=www-data задаёт пользователя, от которого работает воркер, numprocs=2 держит два процесса. redirect_stderr пишет ошибки в тот же файл, что и обычный вывод, а stdout_logfile задаёт путь к логу.
Что заменить под свой сервер
Путь /var/www/example.com в command и в stdout_logfile замените на каталог вашего проекта. Пользователя www-data замените на того, от которого работает сайт: проверьте владельца файлов в storage и bootstrap/cache. Значение numprocs=2 подберите по нагрузке: каждый воркер держит отдельный процесс PHP и занимает память. Каталог для лога должен существовать до запуска: stdout_logfile открывает сам supervisord, и при отсутствии каталога программа не стартует. stopwaitsecs=3600 должен быть больше самой долгой задачи, иначе Supervisor убьёт процесс сигналом SIGKILL.
Установка и применение конфига
Supervisor ставят из репозитория Ubuntu: sudo apt install supervisor. Файл laravel-worker.conf кладут в /etc/supervisor/conf.d/. После правки конфига выполните sudo supervisorctl reread, затем sudo supervisorctl update: первая команда читает изменённые файлы, вторая запускает новые программы и перезапускает изменённые.
Проверка статуса и перезапуск
sudo supervisorctl status показывает состояние каждого процесса: RUNNING, STARTING или FATAL. Если процесс в FATAL, смотрите /var/log/supervisor/supervisord.log и файл из stdout_logfile. Перезапустить все процессы группы сразу: sudo supervisorctl restart laravel-worker:*. Один процесс: sudo supervisorctl restart laravel-worker:laravel-worker_00.
Деплой и перезапуск воркеров
Воркеры держат код в памяти, поэтому после выкладки новой версии их нужно перезапустить. Команда php artisan queue:restart просит воркеры выйти после текущей задачи, и Supervisor поднимает их с новым кодом. Запускайте её от пользователя сайта из каталога проекта.
Где ошибаются, когда правят конфиг
-
В
commandуказан относительный путьphp artisanбез каталога проекта, и воркер не стартует.Пишите полный путь к
artisan, как в конфиге:php /var/www/example.com/artisan queue:work. -
Каталог для
stdout_logfileне существует, и supervisord не может открыть файл.Создайте каталог
storage/logsи проверьте права пользователя изuser. -
После деплоя воркеры продолжают работать со старым кодом.
Выполните
php artisan queue:restart: Supervisor поднимет процессы с новым кодом. -
stopwaitsecsменьше времени самой долгой задачи, и Supervisor убивает воркер сигналом SIGKILL.Увеличьте
stopwaitsecsдо значения больше максимального времени задачи.
Deploykin
Как это делается в Deploykin
В Deploykin cron-задачи и демоны Supervisor создаются из панели: одиннадцать готовых расписаний или своё выражение, пресеты демонов для Horizon, очередей, планировщика и Reverb. Вывод задач пишется в лог и читается в панели.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Зачем нужен Supervisor, если можно запустить queue:work вручную?
Ручной процесс завершится при закрытии сессии или падении. Supervisor запускает его при старте системы и перезапускает после выхода.
Чем отличается reread от update?
reread читает изменённые файлы конфигурации, update применяет изменения: запускает новые программы и перезапускает изменённые.
Как перезапустить только один воркер?
Укажите имя процесса: sudo supervisorctl restart laravel-worker:laravel-worker_00.
Где смотреть ошибки воркера?
В файле из stdout_logfile, например /var/www/example.com/storage/logs/worker.log, и в /var/log/supervisor/supervisord.log.
Ещё по теме
- Конфиг · Cron Crontab: примеры расписаний и как их применить Готовый crontab с примерами расписаний: каждые 5 минут, каждый час, по будням, @reboot. Как применить через crontab -e и проверить по /var/log/syslog.
- Конфиг · Cron Cron для планировщика Laravel: настройка и проверка Готовая строка crontab для Laravel: как добавить задание для пользователя www-data, проверить список задач и убедиться, что schedule:run выполняется каждую минуту.
- Руководство · Cron crontab guru: как читать формат crontab и настроить задание Разбираем формат crontab по полям, показываем команды crontab -e и crontab -l, проверку через syslog и типичные ошибки при настройке cron на Ubuntu 24.04.
- Руководство · Cron Настройка cron для Bitrix на Ubuntu 24.04 Как настроить cron для Bitrix на Ubuntu 24.04: таблица пользователя www-data, запуск агентов и почтовой очереди, полные пути, логи и проверка выполнения.
- Руководство · Cron Как настроить cron каждые 5 минут на Ubuntu 24.04 Как настроить задание cron каждые 5 минут на Ubuntu 24.04: строка crontab, полные пути, логирование вывода и проверка запусков по syslog.
- Руководство · Cron Настройка crontab на Ubuntu 24.04: от расписания до проверки Пошаговая настройка crontab на Ubuntu 24.04: синтаксис расписания, запуск скрипта каждый час, права www-data, проверка через syslog и типичные ошибки.