Вы нажимаете «Обновить всё» для двенадцати плагинов. Пять минут спустя клиент пишет, что кнопка оформления заказа не работает.
Большинство руководств по обновлению заканчиваются на советах «сначала сделайте бэкап» и «откатитесь, если что-то сломается». Откат всей группы плагинов работает, но он также отменяет и те одиннадцать обновлений, с которыми всё было в порядке. А ведь некоторые из них могли содержать патчи безопасности, ради которых вы и запускали обновление.
Откатывать плагины по одному — безопаснее, но если «подозреваемых» двенадцать, на это может уйти двенадцать попыток.
Есть более быстрый способ: откатить половину, протестировать и продолжать делить пополам. Для двенадцати обновлений потребуется около четырёх проверок. В этой статье показано, как сделать это с помощью WP-CLI, а также описан единственный случай, когда этот метод может дать ложный результат.
Перед тем как начать: дело точно в одном из обновлений?
Потратьте на это две минуты. Это сэкономит вам целый час.
- Воспроизведите проблему намеренно. Запишите точный URL и шаги воспроизведения, а также проверьте, проявляется ли баг под авторизованным пользователем, неавторизованным или в обоих случаях. Очистите кэш страниц и протестируйте снова. Если вы не можете воспроизвести сбой по шагам, вы не сможете выполнить бисекцию (поиск делением пополам).
- Проверьте, что ещё изменилось. Не обновлялось ли ядро в то же самое время? Тема? Версия PHP (хостеры иногда меняют её, отправив письмо, которое вы могли пропустить)? Если да, сначала протестируйте их.
-
Изучите логи. Если включён
WP_DEBUG_LOG, fatal error обычно указывает на конкретный файл:
grep "PHP Fatal" wp-content/debug.log | grep -oE "wp-content/plugins/[^/]+" | sort | uniq -c | sort -rn
Если вверху стека указана папка одного из плагинов, начните с него. Если лог пуст (ошибка JavaScript, некорректный вывод данных, пропавший способ оплаты), читайте дальше. Бисекция как раз предназначена для таких случаев.
Шаг 1: выясните, что именно изменилось
Вам понадобятся версии, которые стояли до обновления. WordPress не хранит историю, поэтому проще всего, если вы предварительно сохранили список:
wp plugin list --fields=name,version --format=csv > before.csv
Если вы этого не сделали, список обычно можно восстановить: в вашем плагине резервного копирования или снипшоте хостинга сохранились старые папки плагинов (каждый главный файл плагина содержит заголовок Version: ), а у некоторых управляемых хостингов и инструментов обновления есть лог обновлений.
Впредь запускайте эту команду перед каждой массовой записью обновлений. Это всего одна строка, которая превращает вопрос «что же я обновил?» в готовый файл.
Шаг 2: откатите половину
Разделите двенадцать обновлённых плагинов на две группы по шесть штук. Откатите группу А к старым версиям:
# rollback.sh: roll back the given plugins to the versions in before.csv
for slug in "$@"; do
v=$(awk -F, -v s="$slug" '$1==s {print $2}' before.csv)
wp plugin install "$slug" --version="$v" --force
done
bash rollback.sh slug-1 slug-2 slug-3 slug-4 slug-5 slug-6
Теперь протестируйте сломавшийся сценарий.
-
Всё ещё сломано? Причина в группе B. Снова обновите группу A (
wp plugin update slug-1 slug-2 ...) и разделите группу B пополам. - Починилось? Причина в группе A. Оставьте группу B обновлённой и разделите группу A пополам.
Повторяйте: 12, 6, 3, 2, 1. Четыре проверки.
Делайте это на staging-окружении, если оно у вас есть. На продакшене каждый круг откатов — это реальные изменения, которые видят посетители.
Премиум-плагины: --version работает только для плагинов из каталога WordPress.org. Для премиальных плагинов вам понадобятся старые zip-архивы из личного кабинета разработчика, а затем команда wp plugin install ./old-version.zip --force . Скачайте эти zip-архивы до начала работы, а не в процессе.
Шаг 3: остерегайтесь парных конфликтов
Иногда метод деления пополам указывает на плагин A. Вы откатываете A, сайт начинает работать, а техподдержка плагина A отвечает: «не удаётся воспроизвести».
И они могут быть правы. Баг может возникать из-за сочетания: новая версия A работает некорректно только вместе с новой (или старой) версией плагина B. Откат плагина A скрывает конфликт, хотя сам по себе A не сломан.
Быстрая проверка: при откаченном плагине A и обновлённом всём остальном сайт работает. Теперь снова обновите A и вместо этого откатите вторую половину группы. Если сайт снова заработал, значит A ломается только в паре с чем-то из той половины. Продолжайте делить ту половину, чтобы найти плагин B.
Когда будете отправлять багрепорт, укажите оба плагина и обе их версии. В этом и заключается разница между тикетом, который исправят, и тикетом, который просто закроют.
Шаг 4: чините «вперёд», а не «назад»
Как только вы вычислили проблемное обновление:
- Снова обновите всё остальное. Не оставляйте одиннадцать плагинов на старых версиях из-за одного.
- Оставьте на предыдущей версии только проблемный плагин и запретите ему автообновление, чтобы баг не вернулся:
wp plugin auto-updates disable slug-of-the-bad-one
- Создайте тикет с указанием версий, шагов для воспроизведения и строкой из лога (ранее я писал о том, как составить информативный багрепорт для плагина WordPress).
- Поставьте напоминание в календарь, чтобы включить автообновления обратно, когда выйдет фикс. Зафиксированные версии легко забыть, а забытый фиксатор станет вашей следующей проблемой с безопасностью.
На будущее: обновляйте меньшими группами
Настоящее решение лежит на уровень выше:
- Сохраняйте
before.csvперед каждым обновлением. - Обновляйте плагины оформления заказа, оплаты, членства (membership) и форм отдельно, тестируя эти сценарии после каждого из них.
- Объединяйте в группы низкорисковые плагины (SEO, админ-утилиты, оптимизаторы изображений).
Группа из четырёх плагинов — это два теста для бисекции. Группа из тридцати — уже пять.
Когда откатиться невозможно
Откат версий помогает понять, какое именно обновление сломало сайт. Но иногда вам нужно просто узнать, какой плагин замешан в проблеме: например, у вас нет staging-копии, откат боевого интернет-магазина посреди рабочего дня недопустим или у вас нет старых zip-архивов премиум-плагинов.
В таком случае тот же принцип деления пополам работает и с отключением плагинов вместо их откатов. Я создал для этого бесплатный плагин Culprit Finder (дисклеймер: это мой проект). Он отключает плагины только для вашего авторизованного браузера, поэтому посетители и заказы продолжают работать без сбоев. Плагин задаёт вопросы «да/нет» после каждого шага и умеет находить парные конфликты плагинов. Он не меняет версии, поэтому как только вы поймёте, на какой плагин смотреть, вы сможете применить откат, описанный выше.
Он доступен на WordPress.org: https://wordpress.org/plugins/culprit-finder/
А как вы справляетесь с массовыми обновлениями? Обновляете всё сразу и потом разбираетесь с поломками или делите плагины по степени риска?
Комментарии (0)
Пока нет комментариев — будьте первым.