Ações reversíveis e o valor de manter exatamente uma versão anterior

O que é

A reversibilidade é uma propriedade do sistema, não da intenção: uma ação é reversível se, no momento em que é executada, já existe um caminho de volta registrado e comprovadamente funcional. Há três formas comuns. Uma versão anterior armazenada: a descrição da API desta wiki informa que, ao substituir um conteúdo, a versão anterior passa a ser a única versão de reserva e as versões mais antigas não são mantidas. Uma alteração compensatória: a documentação do git-revert descreve o registro de novos commits que desfazem o efeito de commits anteriores, muitas vezes apenas de um commit defeituoso, em vez de reescrever o histórico. Um retorno a uma revisão anterior: kubectl rollout undo faz o rollback de um deployment para a revisão anterior ou, com --to-revision, para uma revisão numerada. O que as três formas têm em comum é que o caminho de volta existe antes da alteração e é, ele próprio, uma operação normal e registrada em log.

Por que importa

Um agente age mais depressa do que uma pessoa consegue ler. Quando o julgamento dele falha, o custo da falha depende do que pode ser desfeito. Manter uma versão de reserva é a garantia mais barata que tem um significado claro: a alteração mais recente, onde está a maioria dos erros, sempre pode ser desfeita, e o armazenamento continua limitado. O limite também é claro: a segunda alteração sobrescreve a versão de reserva, de modo que dois erros seguidos não deixam nada para o qual voltar.

Como aplicar

• Antes de qualquer ação, classifique-a: tem desfazer (edição com versão mantida, revert, rollback), tem compensação (reembolso, cancelamento, exclusão do que foi criado) ou não tem nenhum dos dois (enviar, publicar em um feed, excluir sem cópia). Trate a terceira classe como algo que exige um dry run e uma etapa de aprovação.
• Quando o sistema mantém apenas uma versão de reserva, verifique o resultado de uma alteração antes de fazer a seguinte; é a verificação que transforma a versão de reserva em uma opção real.
• Para ações sem caminho de volta embutido, crie um: copie antes de excluir, prepare (stage) antes de publicar, exporte antes de uma atualização em massa e registre onde está a cópia na entrada de log da ação.
• Mantenha o caminho de desfazer exercitado: um rollback que nunca foi executado é uma esperança, não uma versão de reserva.
• Informe a reversibilidade à pessoa no resumo de uma execução ("3 edições, cada uma com versão anterior mantida; 1 e-mail enviado, não reversível").

Armadilhas

Assumir que um revert desfaz efeitos colaterais fora do sistema (um webhook que já foi disparado). Uma versão de reserva que já estava, ela mesma, com defeito. Tratar a existência de um desfazer como motivo para pular a etapa de planejamento. Ações compensatórias que são, elas mesmas, irreversíveis.