For the complete documentation index, see llms.txt. This page is also available as Markdown.

Планировщик задач

Настройка заданий cron на сервере

Планировщик задач запускает внутренние процессы iEXExchanger по установленному расписанию. Для этого системная служба CRON каждую минуту вызывает Laravel Scheduler, а система определяет, какие задачи должны быть выполнены в этот момент.

В штатной установке на чистом сервере используются три компонента:

Компонент
Назначение
Нормальное состояние

cron.service

Проверяет расписание каждую минуту

enabled и active

/etc/cron.d/iexexchanger-scheduler

Содержит единственную команду запуска

Одна активная строка

iex-scheduler.service

Выполняет безопасный проверочный запуск

inactive и Result=success

Планировщик запускается от отдельного пользователя приложения. Запуск от root запрещён: он может изменить владельцев файлов и нарушить работу сайта, обновлений и фоновых процессов.

iex-scheduler.service имеет тип oneshot: он запускает команду, дожидается её завершения и останавливается. Поэтому состояние inactive (dead) после успешного запуска является правильным. Постоянно активной должна оставаться служба cron.service.


Какой способ восстановления выбрать

Сначала определите, завершилась ли первоначальная установка продукта.

Если Installer остановился на настройке или проверке планировщика, не создавайте системные файлы вручную. Продолжите тот же запуск с теми же файлами и конфигурацией.

Проверьте состояние установки:

Проверка состояния Installer
cd /home/installer
sudo ./iex-installer status

Если последний запуск не завершён или имеет статус ошибки, выполните:

Продолжение установки
cd /home/installer
sudo ./iex-installer \
  --config /home/installer/install.yaml \
  --non-interactive \
  --yes \
  resume

После завершения запустите проверку:

Проверка установленной системы
sudo /home/installer/iex-installer \
  --config /home/installer/install.yaml \
  verify

Используйте ту же сборку Installer и тот же файл install.yaml, с которыми была начата установка. Не распаковывайте поверх каталога /home/installer другую версию Installer.

Если установка имеет успешный статус, сайт и административная панель работают, но планировщик отсутствует или выдаёт ошибку, сначала выполните диагностику:

Диагностика планировщика
sudo /home/installer/iex-installer \
  --config /home/installer/install.yaml \
  verify

systemctl is-enabled cron.service
systemctl is-active cron.service

cat /etc/cron.d/iexexchanger-scheduler

systemctl show iex-scheduler.service \
  --property=LoadState,ActiveState,Result,ExecMainStatus,User,Group,SupplementaryGroups

Если полная проверка показывает другие неисправности сервера, сначала устраните их. Ручная настройка планировщика не исправляет повреждённый релиз, базу данных, PHP-FPM, Redis или PostgreSQL.

Готовый промпт для ИИ-агента

Для восстановления планировщика агенту не нужны домены, архивы продукта или ключ лицензии. Достаточно SSH-доступа к серверу. Все остальные значения должны быть получены из защищённого состояния установленной системы.

microchipПромпт для технического агента

Подготовка к ручной настройке

Ручная настройка допускается, если первоначальная установка уже завершена, активный релиз существует, а неисправность относится только к планировщику.

Для выполнения инструкции необходим SSH-доступ с правами root.

Не продолжайте настройку во время установки, обновления или отката. Во время таких операций планировщик приостанавливается специально, чтобы не запускать новые задачи одновременно с изменением приложения.

Не удаляйте вручную файлы maintenance. Сначала проверьте состояние Installer или Updater и завершите соответствующую операцию.

Ручная настройка через терминал

Выполняйте все команды последовательно в одной SSH-сессии. Переменные, определённые на первых этапах, используются в последующих командах.

Подключение к серверу по SSH
1

Подключитесь к серверу

Подключитесь по SSH:

Проверьте текущего пользователя:

2

Проверьте состояние установленной системы

Убедитесь, что существует защищённое состояние установки и работает основной фоновый процесс приложения:

В результате iex-horizon.service должен иметь состояние active. В выводе Updater параметр Maintenance должен быть выключен, а последний запуск обновления или отката не должен находиться в процессе выполнения.

Если отображается активный maintenance или незавершённая операция, остановитесь и завершите её штатной командой.

3

Установите системную службу CRON

На минимальной установке операционной системы пакет cron может отсутствовать. Следующая команда проверяет его наличие и устанавливает только при необходимости:

Проверьте службу:

Команды должны вывести enabled и active.

4

Получите параметры текущей установки

Не указывайте пользователя, PHP и каталоги вручную. Следующие команды получают значения из защищённого состояния установки и действующей службы Horizon:

Проверьте полученные значения перед созданием системных файлов:

5

Восстановите управляемые каталоги

Планировщику разрешена запись только в определённые runtime-каталоги. Восстановите их режимы и владельцев из штатной конфигурации:

Не используйте chmod 777 и не меняйте владельца каталога releases. Код активного релиза должен оставаться защищённым от записи приложением.

6

Создайте резервную копию текущей настройки

Перед заменой файлов сохраните существующую конфигурацию и crontab:

Сохраните выведенный путь до завершения всех проверок.

7

Исключите двойной запуск

Найдите дополнительные записи schedule:run:

Если обнаружена старая запись в crontab пользователя или root, удалите только строку iEXExchanger с schedule:run. Не удаляйте другие задания сервера.

Отключите устаревший systemd timer:

8

Создайте проверочный systemd-сервис

Создайте iex-scheduler.service с пользователем и путями текущей установки:

Этот сервис предназначен для проверки одного запуска. В нём специально отсутствуют Restart и секция [Install].

9

Создайте расписание CRON

Создайте единственный управляемый файл планировщика:

Команда сначала проверяет наличие активного Backend и отсутствие maintenance. Во время обновления новые задачи не запускаются, а после снятия maintenance расписание продолжает работать автоматически.

10

Примените настройку

Проверьте systemd-файл, перечитайте конфигурацию и выполните первый запуск:

Не выполняйте systemctl enable iex-scheduler.service. Постоянное расписание обеспечивает cron.service, а iex-scheduler.service запускается только для синхронной проверки.


Проверка планировщика

Проверьте файлы и расписание

Сформируйте ожидаемую строку и сравните её с созданным файлом:

Проверьте, что других периодических запусков нет:

В результате должна отображаться только строка из /etc/cron.d/iexexchanger-scheduler.

Проверьте системные службы

Правильный результат:

В свойствах User и Group должен отображаться пользователь приложения, а в SupplementaryGroups — его группа с окончанием -web.

Проверьте зарегистрированные задачи

Получите список задач, которые зарегистрированы в текущем Backend:

Команда должна завершиться без PHP-ошибок и показать зарегистрированные задачи с их расписанием.

Запустите полную проверку Installer

Если исходный каталог Installer сохранён, завершите настройку полной проверкой:

После успешной полной проверки сохраните резервную копию из $BACKUP_DIR до ближайшей подтверждённой проверки работы сайта и административной панели. Затем её можно удалить вручную.


Решение проблем

iex-horizon.service не найден

Основные системные службы приложения не были установлены. Не создавайте только планировщик поверх незавершённой установки.

Проверьте Installer и продолжите исходную операцию:

Отображается Maintenance: ВКЛЮЧЁН

Планировщик приостановлен из-за установки, обновления, отката или восстановления. Не удаляйте /run/iexexchanger/maintenance и storage/framework/down вручную.

Проверьте состояние операций:

Сначала завершите или восстановите соответствующую операцию.

Scheduler завершается с Result=exit-code

Посмотрите журнал последнего запуска:

Повторите команду от пользователя приложения, а не от root:

Исправляйте конкретную ошибку, показанную командой. Не скрывайте её перенаправлением в /dev/null.

Не найден файл artisan

Проверьте активный релиз:

Если current отсутствует, повреждён или не указывает на релиз, не создавайте другой путь вручную. Используйте resume Installer либо штатное восстановление незавершённого обновления.

Отображается Permission denied

Восстановите управляемые каталоги:

Не применяйте chmod 777 и не выполняйте рекурсивный chown для /var/www/iexexchanger. Такие команды нарушают разграничение между защищённым кодом релиза и изменяемыми данными.

cron.service не запускается

Переустановите только пакет CRON и повторите запуск:

Последние сообщения службы:

Планировщик исправен, но отдельная функция не выполняется

Успешный запуск Scheduler подтверждает только выполнение зарегистрированного расписания. Он не включает автоматически настройки обменного пункта, источники курсов, мерчанты, автовыплаты или внешние интеграции.

Сначала выполните:

Если Scheduler завершён успешно, проверяйте настройки и журналы конкретной функции отдельно.

Последнее обновление