Установка Supervisor на Ubuntu 24.04 и запуск первой программы
Supervisor ставится из репозитория Ubuntu одной командой apt install supervisor и сразу запускает службу. Дальше вы кладёте файл программы в /etc/supervisor/conf.d/, применяете его через supervisorctl reread и update и проверяете статус процессов.
01Проверьте, установлен ли Supervisor
Начните с проверки пакета и службы. Если supervisorctl уже отвечает, установка не нужна, переходите к конфигу программы. Команда systemctl status supervisor показывает, запущена ли служба и с какого момента.
dpkg -l supervisor
sudo systemctl status supervisor
02Установите Supervisor
Пакет ставится из стандартного репозитория Ubuntu 24.04, версия 4.2. При установке deb-пакет сам запускает службу и включает её в автозапуск, отдельные systemctl start и systemctl enable не нужны. После установки проверьте, что служба активна.
sudo apt update
sudo apt install supervisor
sudo systemctl status supervisor
03Создайте конфиг программы
Файлы программ лежат в /etc/supervisor/conf.d/, каждый файл с расширением .conf описывает одну программу или группу. В command указывайте полный путь к бинарю, в directory рабочий каталог, в user пользователя, от которого пойдёт процесс. Каталог для stdout_logfile должен существовать: файл открывает сам supervisord, и при отсутствии каталога программа не стартует.
[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). Проверьте статус после применения.
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status
05Проверьте, что программа работает
В статусе у каждого процесса должно быть RUNNING с растущим pid. Если видите FATAL Exited too quickly, смотрите stdout_logfile программы: команда падает сразу после старта. Лог самого Supervisor лежит в /var/log/supervisor/supervisord.log.
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, чтобы воркеры вышли после текущей задачи.
Ещё по теме
- Руководство · 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 и типичные ошибки.
- Руководство · Cron Как настроить ежедневное задание cron на Ubuntu 24.04 Пошаговая настройка ежедневного задания cron на Ubuntu 24.04: строка crontab, полные пути, логирование, проверка запуска через syslog и journalctl.
- Руководство · Cron Логи crontab на Ubuntu 24.04: где искать и как читать Где лежат логи crontab на Ubuntu 24.04: grep CRON /var/log/syslog, journalctl, вывод задач. Настройка логирования, причины молчания и решение.