Задача cron выполняет команду по расписанию, в фоновом режиме, независимо от того, заходит ли кто-то на ваш сайт в этот момент. В этом руководстве описано, как добавить такую задачу в KPanel, как правильно написать расписание и команду для этой платформы, как заменить ненадёжный встроенный планировщик WordPress, и как найти вывод, если задача делает не то, что вы ожидали.
Где находится Cron в KPanel
Cron принадлежит конкретному сайту, поэтому вы попадаете туда через сайт, а не через главное меню:
- Войдите в KPanel и нажмите Веб-сайты в левой боковой панели.
- Нажмите на нужный сайт.
- В меню сайта откройте Параметры, затем Cron.
Прямой адрес: /websites/<site-id>/cron. Вы увидите таблицу существующих задач или пустое состояние, если на сайте их ещё нет.
Добавление задачи
Нажмите Добавить задачу Cron в правом верхнем углу. Форма содержит три поля.
Расписание
Шесть готовых кнопок заполняют выражение за вас:
| Кнопка | Выражение |
|---|---|
| Каждую минуту | * * * * * |
| Каждые 5 мин | */5 * * * * |
| Каждый час | 0 * * * * |
| Ежедневно 2:00 | 0 2 * * * |
| Еженедельно воскресенье | 0 2 * * 0 |
| Ежемесячно 1-е число | 0 2 1 * * |
Либо впишите своё собственное в поле Выражение Cron. Пять полей, по порядку: минута, час, день месяца, месяц, день недели:
minute hour day-of-month month day-of-week
0 3 * * *запускается в 3:00 каждый день.*/15 * * * *запускается каждые пятнадцать минут.0 9 * * 1запускается в 9:00 каждый понедельник.30 1 1 * *запускается в 1:30 первого числа каждого месяца.0 */6 * * *запускается каждые шесть часов, ровно в начале часа.
Метка
Название, которое вы узнаете позже, например WordPress cron или Nightly stock sync. Именно его показывает таблица задач, поэтому делайте его описательным: job 3 никому не поможет в 2 часа ночи.
Команда
Команда оболочки, которая будет выполняться. Нажмите Save, чтобы создать задачу.
Используйте полные пути. Cron выполняется в минимальном окружении, без вашего профиля оболочки, поэтому голая php или относительный путь, который работает, когда вы залогинены по SSH, здесь будет молча давать сбой. Прописывайте полный путь каждый раз.
Написание команды
Задачи выполняются от имени системного пользователя вашего сайта, поэтому ваш домашний каталог служит правильным ориентиром, и ~ разрешается корректно. Файлы вашего сайта находятся по пути:
~/htdocs/yourdomain.co.nz
Вы можете уточнить точный путь на вкладке Параметры, затем SFTP сайта: он выводится под Файлы сайта.
Типичные команды:
cd ~/htdocs/yourdomain.co.nz && /usr/bin/wp cron event run --due-now
cd ~/htdocs/yourdomain.co.nz && /usr/bin/php bin/send-queued-emails.php
/usr/bin/curl -fsS https://yourdomain.co.nz/api/nightly-report
Проверьте команду, прежде чем ставить её в расписание. Вставьте её в раздел WordPress, затем Console сайта, если это команда wp, либо выполните её по SSH. Задачу, которая никогда не заработает, гораздо легче заметить в командной строке, чем в логе в 3 часа ночи.
Замена встроенного планировщика WordPress
WordPress поставляется с собственным псевдо-планировщиком, WP-Cron, который срабатывает только тогда, когда кто-то загружает страницу. На тихом сайте запланированные записи публикуются с опозданием, а письма копятся неотправленными. На загруженном сайте каждый посетитель оплачивает своим временем проверку расписания.
Настоящая задача cron решает обе проблемы. KPanel делает всю замену за вас:
- Откройте сайт, затем вкладку WordPress.
- Откройте раздел WP-Cron.
- Нажмите Включить системный cron.
Это добавляет расписание, которое запускает WP-Cron каждые пять минут, и устанавливает DISABLE_WP_CRON, чтобы загрузки страниц больше не вызывали его. Удалить системный cron на том же экране отменяет обе половины.
Если вы предпочитаете сделать это вручную, это два шага:
Отключите версию, запускаемую посетителями. Добавьте это в wp-config.php, над строкой /* That's all, stop editing! */, используя Параметры, затем Менеджер файлов:
define( 'DISABLE_WP_CRON', true );
Добавьте настоящую задачу. В Параметры, затем Cron:
- Расписание:
*/5 * * * * - Метка:
WordPress cron - Команда:
cd ~/htdocs/yourdomain.co.nz && /usr/bin/wp cron event run --due-now
Не пропускайте половину с DISABLE_WP_CRON. Если работают обе, каждая запланированная задача может сработать дважды: дублирующиеся письма, дублирующаяся обработка заказов, дублирующиеся списания в плагине подписок. Используйте однократное действие в разделе WP-Cron, и с вами такого не случится.
WooCommerce и фоновые очереди
WooCommerce использует фоновую очередь для изменений статуса заказов, продления подписок, писем и обновлений остатков. Она полагается на WP-Cron, и это как раз та нагрузка, которая страдает на тихом магазине.
Как только настоящее расписание настроено, очередь обрабатывается каждые пять минут. Следите за ней в wp-admin: WooCommerce, затем Status, затем Scheduled Actions.
Магазин с большим объёмом трафика может перейти на */2 * * * *. Снижать это значение дальше обычно бесполезно: вы тратите больше времени на запуск процессов, чем на саму работу. См. Настройка WooCommerce.
Управление существующими задачами
Таблица задач показывает Label, Schedule, Command, Последний запуск и Status, с двумя действиями в каждой строке:
- Disable приостанавливает задачу, не удаляя её, и превращается в Enable, чтобы вернуть её обратно. Используйте это, когда проверяете, не вызывает ли задача проблему.
- Delete удаляет её навсегда. У вас запросят подтверждение, и запланированные запуски прекращаются немедленно.
Удаление задачи cron нельзя отменить. Расписание удаляется с сервера сразу же. Если вы хотите только временно остановить задачу, используйте Disable.
Поиск вывода
Для каждой задачи, созданной KapsuleHost, вывод автоматически сохраняется. Стандартный вывод и ошибки дописываются в файл лога в каталоге cron-logs в домашнем каталоге пользователя вашего сайта, по одному файлу на задачу.
Этот лог отвечает почти на любой вопрос "выполнилась ли моя задача?", потому что в нём записано, что вывела команда, и любая возникшая ошибка.
Чтобы прочитать его, подключитесь по SSH и посмотрите в ~/cron-logs/. SSH использует аутентификацию по ключу, поэтому сначала добавьте свой открытый ключ на вкладке Параметры, затем SSH-ключи сайта: см. Добавление SSH-ключей.
Учётные записи Менеджера файлов и SFTP ограничены каталогом вашего сайта, ~/htdocs/yourdomain.co.nz, а cron-logs находится на один уровень выше. Это сделано намеренно: это не даёт подрядчику с доступом по SFTP добраться до чего-либо, кроме самого сайта. Используйте нативный SSH для доступа к логам или перенаправляйте вывод в каталог вашего сайта, как показано ниже.
Если вы хотите, чтобы вывод оказывался там, где его сможет открыть Менеджер файлов, перенаправьте его самостоятельно:
cd ~/htdocs/yourdomain.co.nz && /usr/bin/wp cron event run --due-now >> ~/htdocs/yourdomain.co.nz/wp-content/cron.log 2>&1
2>&1 отправляет ошибки в тот же файл, что и обычный вывод. Без этого ошибки уходят в никуда.
Всё, что находится внутри каталога вашего сайта, потенциально может быть запрошено через веб. Размещайте перенаправленный лог под wp-content, а не в корне сайта, давайте ему имя, которое никто не угадает, и удаляйте его, как только закончите отладку.
Рекомендации
- Распределяйте расписания по времени. Шесть задач, установленных на
0 2 * * *, запустятся все разом. Разнесите их:0 2,10 2,20 2. - Не используйте запуск каждую минуту без реальной необходимости.
*/5достаточно почти для всего, включая WordPress и WooCommerce. - Делайте задачи короткими. Задача, которая выполняется дольше своего интервала, будет пересекаться со следующим запуском.
- Перенаправляйте вывод для всего, что шумит, чтобы одна болтливая задача не заполнила весь диск.
- Периодически просматривайте список. Задачи, оставшиеся от удалённого плагина, продолжают выполняться.
Устранение неполадок
Задача, кажется, никогда не выполняется. Сначала проверьте путь. Откройте файл лога. Затем убедитесь, что статус Active, а не Disabled. Затем выполните ту же команду по SSH и посмотрите, что она выдаст.
В логе "command not found". Отсутствует полный путь. Используйте /usr/bin/php, /usr/bin/wp, /usr/bin/curl вместо голого имени.
Permission denied. Задача выполняется от имени системного пользователя вашего сайта. Этому пользователю нужно владеть, или хотя бы иметь возможность читать, всё, к чему обращается команда. Проверьте права доступа в статье Использование Менеджера файлов.
Задачи WordPress по-прежнему выполняются с опозданием. Убедитесь, что обе половины замены на месте: расписание существует в Параметры, затем Cron, и установлен DISABLE_WP_CRON. Раздел WP-Cron на вкладке WordPress показывает текущее состояние обеих половин.
Задача выполняется, но во время её работы сайт работает медленно. Перенесите её на более тихий час или разбейте работу на меньшие порции. Использование ресурсов на уровне сайта видно в разделе Производительность: см. Повышение скорости сайта.
Задача перестала работать после обновления плагина. Возможно, изменился путь к команде. Проверьте лог, затем обновите команду в таблице задач, удалив старую задачу и добавив исправленную.