К содержимому

Supervisor для очередей Laravel: конфиг воркера

Supervisor держит процессы queue:work запущенными и поднимает их после падения. Файл /etc/supervisor/conf.d/laravel-worker.conf задаёт команду, пользователя и число воркеров. В конфиге меняют путь к проекту, пользователя сайта и numprocs.

Конфиг Cron 3 мин чтения

Конфиг

/etc/supervisor/conf.d/laravel-worker.conf
[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
сколько воркеров держать

Как применить и проверить

bash
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.

Ещё по теме

crontab: планировщик задач на сервере: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.