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

Supervisor не запускается: ошибки, причины и исправление

Если Supervisor не запускается, чаще всего виноват синтаксис в ini-файле или неверный путь к программе. Сначала проверьте sudo supervisorctl status и лог /var/log/supervisor/supervisord.log, затем конфиг через sudo supervisord -c /etc/supervisor/supervisord.conf -n.

Ошибка Cron 2 мин чтения

01Синтаксическая ошибка в конфиге Supervisor

Supervisor читает все файлы из /etc/supervisor/conf.d/*.conf. Одна опечатка в секции [program:...] останавливает запуск всего демона. Проверьте конфиг в foreground-режиме: sudo supervisord -c /etc/supervisor/supervisord.conf -n. В выводе будет номер строки и описание ошибки.

bash
sudo supervisord -c /etc/supervisor/supervisord.conf -n

02Неверный путь к исполняемому файлу или рабочей директории

В секции command должен быть абсолютный путь к бинарнику. Если указать php без пути, Supervisor не найдёт программу. Проверьте путь через which php и пропишите его в конфиг. Директория из directory тоже должна существовать.

ini
[program:example]
command=/usr/bin/php /var/www/example.com/artisan queue:work --sleep=3
 directory=/var/www/example.com
user=www-data
autostart=true
autorestart=true
stderr_logfile=/var/log/supervisor/example.err.log
stdout_logfile=/var/log/supervisor/example.out.log

03Нет прав у пользователя из user

Если в секции указан user=www-data, процесс запускается от этого пользователя. У него должен быть доступ к файлам и директориям программы. Проверьте права на /var/www/example.com и лог-файлы. Ошибка permission denied в логе укажет на проблему.

bash
sudo -u www-data /usr/bin/php /var/www/example.com/artisan queue:work --once

04Supervisor не перечитал конфигурацию

После правки ini-файла нужно выполнить sudo supervisorctl reread, затем sudo supervisorctl update. Без этого новые программы не появятся в статусе. Если supervisorctl отвечает unix:///var/run/supervisor.sock no such file, демон не запущен или сокет в другом месте.

bash
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status

05Проверка, что ошибка устранена

Выполните sudo supervisorctl status: все программы должны быть в состоянии RUNNING. Перезапустите демон и проверьте, что он поднялся. Затем посмотрите лог программы на предмет ошибок приложения.

bash
sudo systemctl restart supervisor
sudo supervisorctl status
sudo tail -n 50 /var/log/supervisor/example.err.log

Что не помогает

  • Перезапускать только supervisorctl restart all без reread и update.

    Сначала выполните sudo supervisorctl reread и sudo supervisorctl update, затем перезапускайте программы.

  • Править /etc/supervisor/supervisord.conf вместо файлов в conf.d.

    Держите настройки программ в /etc/supervisor/conf.d/*.conf, а основной файл не трогайте без необходимости.

  • Запускать Supervisor от root с user=www-data в секции program.

    Убедитесь, что пользователь www-data имеет доступ к файлам, или запускайте программу от того пользователя, которому принадлежат файлы.

Deploykin

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

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

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

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

Почему supervisorctl пишет no such file?

Демон supervisord не запущен или сокет находится по другому пути. Проверьте sudo systemctl status supervisor и путь unix:///var/run/supervisor.sock в конфиге.

Как проверить конфиг Supervisor без запуска?

Запустите sudo supervisord -c /etc/supervisor/supervisord.conf -n. Он выведет ошибки конфигурации и не будет работать в фоне.

Где смотреть логи Supervisor?

Основной лог: /var/log/supervisor/supervisord.log. Логи программ задаются в секции stdout_logfile и stderr_logfile.

Нужно ли перезагружать Supervisor после изменения конфига?

Да, выполните sudo supervisorctl reread и sudo supervisorctl update. Полный перезапуск демона нужен только при изменении основного файла supervisord.conf.

Ещё по теме

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

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