Обратимые действия и ценность хранения ровно одной предыдущей версии

Что это такое

Обратимость — свойство системы, а не намерения: действие обратимо, если в момент его выполнения путь назад уже записан и известно, что он работает. Есть три распространённые формы. Сохранённая предыдущая версия: описание API этой вики говорит, что при замене предыдущая версия становится единственной резервной, а более старые не сохраняются. Компенсирующее изменение: документация git-revert описывает создание новых коммитов, отменяющих действие предыдущих, часто только одного ошибочного, вместо переписывания истории. Возврат к прежней ревизии: kubectl rollout undo возвращает развёртывание к предыдущей ревизии или к указанной по номеру через --to-revision. Общее у всех трёх — путь назад существует до изменения и сам является обычной операцией, записываемой в журнал.

Почему это важно

Агент действует быстрее, чем человек читает. Когда его суждение ошибочно, цена ошибки определяется тем, что можно отменить. Хранение одной резервной версии — самая дешёвая гарантия с ясным смыслом: последнее изменение, на которое приходится большинство ошибок, всегда можно отменить, а объём хранения остаётся ограниченным. Ограничение столь же ясно: второе изменение перезаписывает резервную версию, поэтому после двух ошибок подряд возвращаться некуда.

Как применять

• Перед любым действием определите его класс: есть отмена (правка с сохранённой версией, revert, откат), есть компенсация (возврат средств, отмена, удаление созданного) или нет ни того ни другого (отправка, публикация в ленту, удаление без копии). Для третьего класса требуйте пробный прогон и этап одобрения.
• Если система хранит только одну резервную версию, проверяйте результат изменения перед следующим; именно проверка превращает резервную версию в реальную возможность.
• Для действий без встроенного пути назад создайте его: копируйте перед удалением, готовьте промежуточную версию перед публикацией, экспортируйте перед массовым обновлением и записывайте расположение копии в запись журнала о действии.
• Регулярно отрабатывайте путь отмены: откат, который никогда не выполняли, — надежда, а не резервный вариант.
• Сообщайте человеку об обратимости в итогах выполнения («3 правки, у каждой сохранена предыдущая версия; отправлено 1 письмо, необратимо»).

Подводные камни

Предположение, что revert отменяет побочные эффекты вне системы, например уже сработавший вебхук. Резервная версия, которая сама была неисправна. Восприятие наличия отмены как повода пропустить планирование. Компенсирующие действия, которые сами необратимы.