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

Установка Supervisor на Ubuntu 24.04 и запуск первой программы

Supervisor ставится из репозитория Ubuntu одной командой apt install supervisor и сразу запускает службу. Дальше вы кладёте файл программы в /etc/supervisor/conf.d/, применяете его через supervisorctl reread и update и проверяете статус процессов.

Руководство Cron 2 мин чтения

01Проверьте, установлен ли Supervisor

Начните с проверки пакета и службы. Если supervisorctl уже отвечает, установка не нужна, переходите к конфигу программы. Команда systemctl status supervisor показывает, запущена ли служба и с какого момента.

bash
dpkg -l supervisor
sudo systemctl status supervisor

02Установите Supervisor

Пакет ставится из стандартного репозитория Ubuntu 24.04, версия 4.2. При установке deb-пакет сам запускает службу и включает её в автозапуск, отдельные systemctl start и systemctl enable не нужны. После установки проверьте, что служба активна.

bash
sudo apt update
sudo apt install supervisor
sudo systemctl status supervisor

03Создайте конфиг программы

Файлы программ лежат в /etc/supervisor/conf.d/, каждый файл с расширением .conf описывает одну программу или группу. В command указывайте полный путь к бинарю, в directory рабочий каталог, в user пользователя, от которого пойдёт процесс. Каталог для stdout_logfile должен существовать: файл открывает сам supervisord, и при отсутствии каталога программа не стартует.

ini
[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=/usr/bin/php /var/www/example.com/artisan queue:work --sleep=3 --tries=3
 directory=/var/www/example.com
user=www-data
numprocs=2
redirect_stderr=true
stdout_logfile=/var/log/supervisor/laravel-worker.log
stopwaitsecs=3600

04Примените конфиг через supervisorctl

reread читает изменённые файлы, update запускает новые программы и перезапускает изменённые. Без этих двух команд Supervisor не знает о новом файле, и supervisorctl status покажет ERROR (no such group). Проверьте статус после применения.

bash
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status

05Проверьте, что программа работает

В статусе у каждого процесса должно быть RUNNING с растущим pid. Если видите FATAL Exited too quickly, смотрите stdout_logfile программы: команда падает сразу после старта. Лог самого Supervisor лежит в /var/log/supervisor/supervisord.log.

bash
sudo supervisorctl status
sudo tail -n 50 /var/log/supervisor/supervisord.log

Частые ошибки

  • supervisorctl возвращает unix:///var/run/supervisor.sock no such file.

    Служба Supervisor не запущена. Проверьте sudo systemctl status supervisor и причину в /var/log/supervisor/supervisord.log, затем запустите службу.

  • laravel-worker:laravel-worker_00: ERROR (spawn error) после update.

    Supervisor не смог запустить команду: проверьте путь в command, наличие пользователя из user= и существование каталога для stdout_logfile.

  • ERROR (no such group) при обращении к программе.

    Файл создан, но не применён. Выполните sudo supervisorctl reread и sudo supervisorctl update.

  • Процесс получает SIGKILL во время долгой задачи.

    Истёк stopwaitsecs. Поставьте значение больше самой долгой задачи, например stopwaitsecs=3600.

Deploykin

Как это делается в Deploykin

В Deploykin cron-задачи и демоны Supervisor создаются из панели: одиннадцать готовых расписаний или своё выражение, пресеты демонов для Horizon, очередей, планировщика и Reverb. Вывод задач пишется в лог и читается в панели.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Запускается ли служба supervisor автоматически после установки?

Да. Пакет supervisor в Ubuntu 24.04 при установке запускает службу и включает её в автозапуск, отдельные команды не нужны.

Где лежат конфиги программ Supervisor?

В /etc/supervisor/conf.d/, файлы с расширением .conf. Основной конфиг /etc/supervisor/supervisord.conf подключает этот каталог.

Чем отличаются reread и update?

reread только читает изменённые файлы, update запускает новые программы и перезапускает изменённые. Для применения нового файла нужны обе команды.

Как перезапустить всех воркеров Laravel после деплоя?

sudo supervisorctl restart laravel-worker:* перезапускает всю группу. В приложении также вызывают php artisan queue:restart, чтобы воркеры вышли после текущей задачи.

Ещё по теме

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

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