Вы нажимаете «Обновить всё» для двенадцати плагинов. Пять минут спустя клиент пишет, что кнопка оформления заказа не работает.

Большинство руководств по обновлению заканчиваются на советах «сначала сделайте бэкап» и «откатитесь, если что-то сломается». Откат всей группы плагинов работает, но он также отменяет и те одиннадцать обновлений, с которыми всё было в порядке. А ведь некоторые из них могли содержать патчи безопасности, ради которых вы и запускали обновление.

Откатывать плагины по одному — безопаснее, но если «подозреваемых» двенадцать, на это может уйти двенадцать попыток.

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

Перед тем как начать: дело точно в одном из обновлений?

Потратьте на это две минуты. Это сэкономит вам целый час.

  1.  Воспроизведите проблему намеренно. Запишите точный URL и шаги воспроизведения, а также проверьте, проявляется ли баг под авторизованным пользователем, неавторизованным или в обоих случаях. Очистите кэш страниц и протестируйте снова. Если вы не можете воспроизвести сбой по шагам, вы не сможете выполнить бисекцию (поиск делением пополам).
  2.  Проверьте, что ещё изменилось. Не обновлялось ли ядро в то же самое время? Тема? Версия PHP (хостеры иногда меняют её, отправив письмо, которое вы могли пропустить)? Если да, сначала протестируйте их.
  3.  Изучите логи. Если включён  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: чините «вперёд», а не «назад»

Как только вы вычислили проблемное обновление:

  1. Снова обновите всё остальное. Не оставляйте одиннадцать плагинов на старых версиях из-за одного.
  2. Оставьте на предыдущей версии только проблемный плагин и запретите ему автообновление, чтобы баг не вернулся:
    wp plugin auto-updates disable slug-of-the-bad-one
 
  1. Создайте тикет с указанием версий, шагов для воспроизведения и строкой из лога (ранее я писал о том, как составить информативный багрепорт для плагина WordPress).
  2. Поставьте напоминание в календарь, чтобы включить автообновления обратно, когда выйдет фикс. Зафиксированные версии легко забыть, а забытый фиксатор станет вашей следующей проблемой с безопасностью.

На будущее: обновляйте меньшими группами

Настоящее решение лежит на уровень выше:

  • Сохраняйте  before.csv  перед каждым обновлением.
  • Обновляйте плагины оформления заказа, оплаты, членства (membership) и форм отдельно, тестируя эти сценарии после каждого из них.
  • Объединяйте в группы низкорисковые плагины (SEO, админ-утилиты, оптимизаторы изображений).

Группа из четырёх плагинов — это два теста для бисекции. Группа из тридцати — уже пять.

Когда откатиться невозможно

Откат версий помогает понять, какое именно обновление сломало сайт. Но иногда вам нужно просто узнать, какой плагин замешан в проблеме: например, у вас нет staging-копии, откат боевого интернет-магазина посреди рабочего дня недопустим или у вас нет старых zip-архивов премиум-плагинов.

В таком случае тот же принцип деления пополам работает и с отключением плагинов вместо их откатов. Я создал для этого бесплатный плагин Culprit Finder (дисклеймер: это мой проект). Он отключает плагины только для вашего авторизованного браузера, поэтому посетители и заказы продолжают работать без сбоев. Плагин задаёт вопросы «да/нет» после каждого шага и умеет находить парные конфликты плагинов. Он не меняет версии, поэтому как только вы поймёте, на какой плагин смотреть, вы сможете применить откат, описанный выше.

Он доступен на WordPress.org: https://wordpress.org/plugins/culprit-finder/


А как вы справляетесь с массовыми обновлениями? Обновляете всё сразу и потом разбираетесь с поломками или делите плагины по степени риска?