Настройка Supervisor
Пошаговая инструкция для автоматической настройки и стабильного управления фоновыми задачами с помощью Supervisord.
Last updated
Was this helpful?
Пошаговая инструкция для автоматической настройки и стабильного управления фоновыми задачами с помощью Supervisord.
Last updated
Was this helpful?
Was this helpful?
Supervisord — это программа, которая следит за тем, чтобы нужные вам процессы на сервере всегда работали. Если какая-то программа остановится, Supervisord автоматически её перезапустит.
Все команды, указанные в этой инструкции, требуют выполнения от имени пользователя с максимальными правами (пользователя root). Это необходимо, так как многие команды вносят изменения в конфигурацию системы и требуют административных привилегий.
Для перехода в пользователя root выполните команду:
sudo -l root
Сначала обновите все необходимые пакеты на сервере. Выполните команды одну за другой:
sudo apt update
sudo apt upgrade -yУстановите Supervisord командой:
sudo apt install supervisor -yВключите Supervisord, чтобы он автоматически запускался при включении сервера, и сразу запустите его:
sudo systemctl enable supervisor
sudo systemctl start supervisorПроверьте, запущен ли Supervisord:
sudo systemctl status supervisorОткройте главный файл конфигурации Supervisord:
nano /etc/supervisor/supervisord.confДобавьте следующую строку сразу после [supervisord]:
[supervisord]
minfds=10000
На Mac и Linux (редактор nano):
Нажмите комбинацию клавиш Control + O для сохранения файла.
Затем подтвердите сохранение, нажав Enter.
Для выхода из редактора нажмите Control + X.
На Windows (редактор nano в WSL, Git Bash и аналогичных):
Нажмите комбинацию клавиш Ctrl + O для сохранения файла.
Затем нажмите Enter для подтверждения.
Закройте редактор, нажав Ctrl + X.
Перезапустите Supervisord для применения настроек:
sudo systemctl restart supervisorСоздайте скрипт, который настроит автоматический запуск нужных программ:
nano setup_supervisor_processes.shСкопируйте и вставьте текст ниже, предварительно заменив указанные значения на свои:
Как найти путь к проекту и имя пользователя в FastPanel?PROJECT_PATH: Путь к проекту
PHP_PATH: Путь к PHP (по умолчанию /usr/bin/php8.2)
USER: Пользователь сервера
DOMAIN: Ваш домен (app.ваш_домен)
#!/bin/bash
# Настройка проекта Laravel для Supervisor
# ======== Укажите свои данные здесь ========
PROJECT_PATH="/var/www/имя_пользователя/data/www/app.ваш_домен" # Путь до вашего проекта
PHP_PATH="/usr/bin/php8.2" # Путь до исполняемого файла PHP
USER="имя_пользователя" # Имя вашего пользователя
DOMAIN="app.ваш_домен" # Ваш домен
# ===========================================
# Путь для конфигурационного файла Supervisor
SUPERVISOR_CONF_PATH="/etc/supervisor/conf.d/iex.conf"
# Создание конфигурационного файла Supervisor
cat <<EOF > "$SUPERVISOR_CONF_PATH"
[program:horizon]
command=$PHP_PATH $PROJECT_PATH/artisan horizon
autostart=true
autorestart=true
user=$USER
redirect_stderr=true
stdout_logfile=$PROJECT_PATH/storage/logs/iex-horizon.log
[program:laravel-worker]
command=$PHP_PATH $PROJECT_PATH/artisan queue:work --delay=1 --sleep=1 --timeout=1800 --tries=3 --queue=high,low
directory=$PROJECT_PATH
autostart=true
autorestart=true
user=$USER
redirect_stderr=true
stdout_logfile=$PROJECT_PATH/storage/logs/iex-worker.log
[program:laravel-pulsework]
command=$PHP_PATH $PROJECT_PATH/artisan pulse:work
autostart=true
autorestart=true
user=$USER
redirect_stderr=true
stdout_logfile=$PROJECT_PATH/storage/logs/iex-pulse-work.log
[program:laravel-pulsecheck]
command=$PHP_PATH $PROJECT_PATH/artisan pulse:check
autostart=true
autorestart=true
user=$USER
redirect_stderr=true
stdout_logfile=$PROJECT_PATH/storage/logs/iex-pulse-check.log
stopwaitsecs=3600
[program:laravel-reverb]
command=$PHP_PATH $PROJECT_PATH/artisan reverb:start --debug --hostname="$DOMAIN"
autostart=true
autorestart=true
user=$USER
redirect_stderr=true
stdout_logfile=$PROJECT_PATH/storage/logs/iex-reverb.log
EOF
# Перезагрузка Supervisor для применения новых настроек
echo "Обновляем настройки Supervisor..."
supervisorctl reread
supervisorctl update
# Вывод сообщения о завершении
echo "Конфигурация Supervisor успешно обновлена и применена!"На Mac и Linux (редактор nano):
Нажмите комбинацию клавиш Control + O для сохранения файла.
Затем подтвердите сохранение, нажав Enter.
Для выхода из редактора нажмите Control + X.
На Windows (редактор nano в WSL, Git Bash и аналогичных):
Нажмите комбинацию клавиш Ctrl + O для сохранения файла.
Затем нажмите Enter для подтверждения.
Закройте редактор, нажав Ctrl + X.
Сделайте скрипт исполняемым и запустите его:
chmod +x setup_supervisor_processes.sh
sudo ./setup_supervisor_processes.shВыполните следующие команды, чтобы Supervisord применил изменения:
sudo supervisorctl reread
sudo supervisorctl updateНа этапе первоначальной установки продукта нет необходимости проверять статусы программ или просматривать журналы (логи). Данные команды приводятся для справки и будут полезны только в том случае, если позже, в процессе эксплуатации системы, возникнут какие-либо проблемы с её работой.
Проверьте, что все программы запущены и работают:
sudo supervisorctl statusВсе указанные программы должны быть в состоянии RUNNING.
Перезапустить все программы:
sudo supervisorctl restart allПерезапустить конкретную программу:
sudo supervisorctl restart название_программыОстановить программу:
sudo supervisorctl stop название_программыЗапустить программу:
sudo supervisorctl start название_программыОсновной журнал работы Supervisord:
cat /var/log/supervisor/supervisord.logЖурналы отдельных программ (пример):
cat /var/www/myproject/iex-worker.logТеперь Supervisord полностью настроен и работает на вашем сервере. Если возникнут вопросы, вы всегда можете обратиться за помощью к специалисту.