O que é hotfix? Significado, hotfix vs patch e como lançar
7 min de leitura
Um hotfix é a correção de um problema sério em produção, lançada fora do ciclo normal de releases porque esperar pela próxima release planejada custaria mais do que o risco de agir rápido. Ele é pequeno de propósito, passa por uma versão reduzida das verificações de sempre, e os usuários ficam sabendo assim que possível. A palavra começou significando uma mudança aplicada a um sistema “quente”, um servidor ainda atendendo usuários, e hoje descreve mais a urgência do que a forma como a correção é instalada.
| Termo | O que é | Quando sai | Escopo típico |
|---|---|---|---|
| Hotfix | Uma correção urgente para um problema que os usuários enfrentam agora | Assim que fica pronta, fora do cronograma | Um defeito |
| Bugfix | Qualquer correção de um defeito | Em geral com a próxima release planejada | Um ou mais defeitos |
| Patch | Uma atualização de software existente; no SemVer, uma release que aumenta o último número | Planejada ou urgente | Correções retrocompatíveis |
| Service pack ou rollup | Um pacote cumulativo e testado de correções anteriores | Em um cronograma | Muitas correções, às vezes pequenas funcionalidades |
| Live patch | Uma correção aplicada ao código em execução sem reiniciar | Quando reiniciar custa caro demais | Algumas funções |
O que significa hotfix em software?
Um hotfix é uma mudança feita às pressas para corrigir um problema em um software que já está em uso, lançada por conta própria em vez de esperar pela próxima versão. O termo carrega duas ideias ao mesmo tempo: o problema é sério, e o processo normal foi encurtado para lidar com ele.
O artigo sobre hotfix da Wikipédia traça essa mudança. O termo se referia originalmente a aplicar um patch em um sistema quente, um servidor de produção atendendo clientes ativamente, e com o tempo passou a significar qualquer atualização criada com urgência ou lançada fora do ciclo normal de atualizações. A Microsoft usou a palavra por anos e depois migrou para outra terminologia, embora a lista de tipos de atualização atual ainda descreva um service pack como um conjunto cumulativo e testado de hotfixes, atualizações de segurança, atualizações críticas e atualizações. O sentido original de “quente” sobrevive no live patching, que a documentação de livepatch do kernel Linux descreve como a correção de funções críticas sem reiniciar o sistema.
Qual é a diferença entre hotfix e patch?
Um patch é qualquer atualização que altera um software existente, e um hotfix é um patch definido por sua urgência e pelo momento em que sai. Todo hotfix é um patch; a maioria dos patches é planejada e sai com uma release regular.
A sobreposição com o versionamento causa a maior parte da confusão. No Semantic Versioning, o número PATCH sobe quando você faz correções de bugs retrocompatíveis, então um hotfix para a versão 2.4.0 normalmente sai como 2.4.1. Uma release de manutenção planejada também pode ser a 2.4.1. O número da versão registra que tipo de mudança é, e a palavra hotfix registra por que ela não podia esperar. Um bugfix é o mesmo tipo de mudança em um cronograma normal: o código pode ser idêntico, e a diferença é se você quebrou o ciclo de releases para lançá-lo.
Quando um bug merece um hotfix?
Quando o custo de deixá-lo em produção até a próxima release é maior do que o risco de lançar uma mudança apressada. Esse julgamento deve ser feito por uma pessoa nomeada, com critérios que o time combinou com calma, e não por quem estiver mais alarmado.
Problemas que costumam justificar um hotfix:
- Perda ou corrupção de dados, incluindo dados gravados errado que precisarão de limpeza depois.
- Uma vulnerabilidade de segurança que está sendo explorada ou é fácil de explorar.
- Um fluxo central quebrado para muitos usuários: entrar, pagar, salvar o trabalho.
- Uma regressão da última release que bloqueia clientes que estavam bem no dia anterior.
- Uma obrigação legal ou contratual que o software deixou de cumprir.
Problemas que geralmente podem esperar pela próxima release: questões cosméticas, bugs com um contorno razoável e qualquer coisa que afete poucos usuários e não esteja piorando. Escrever a lista importa porque toda correção urgente pula parte das verificações que protegem a produção, e um time que faz hotfix de tudo abandonou, sem dizer, o próprio processo de release.
Como lançar um hotfix com segurança?
Corrija a versão que está de fato rodando, mude o mínimo possível, teste a correção na build exata que será implantada, mantenha um caminho de volta e faça o merge da correção na linha principal para que a próxima release não traga o bug de volta.
- Confirme e delimite. Reproduza o problema, confirme que ele atende aos critérios acima e nomeie uma responsável pela correção.
- Crie o branch a partir do que está em produção. No modelo git-flow do artigo sobre o modelo de branches de Vincent Driessen, um branch de hotfix parte da tag de produção em
master, a versão é aumentada logo de início, e o branch pronto é mesclado de volta emmastere emdevelop. A própria nota de 2020 de Driessen sobre esse artigo recomenda um fluxo mais simples para apps web de entrega contínua, e nesse caso o hotfix é um pull request pequeno no branch principal, implantado de imediato. - Faça a menor mudança que resolve. Nada de refatoração nem de funcionalidades extras. Tudo o que não for a correção pode sair na semana que vem.
- Prove que funciona. Adicione um teste que reproduza o bug e falhe sem a correção, depois rode a suíte completa no commit que será implantado.
- Versione e marque. Aumente o número de patch e marque o commit com uma tag, como descrito em tags do git e releases.
- Implante com um caminho de volta. Faça o rollout gradual onde der, acompanhe as taxas de erro e saiba o comando de rollback antes de precisar dele.
- Faça o merge de volta. Se a correção foi feita em um branch de release, mescle-a na linha principal no mesmo dia.
Um hotfix precisa de entrada de changelog e release notes?
Sim. Os usuários que esbarraram no bug precisam saber que ele foi corrigido e o que, se for o caso, devem fazer, e quem ler o histórico de versões depois precisa saber por que existe uma 2.4.1 dois dias depois da 2.4.0.
Mantenha a nota curta: o que estava quebrado, quem foi afetado, o que muda para essas pessoas e qual versão contém a correção. Quando o hotfix responde a um incidente, vale a orientação de release notes de emergência, e para uma correção de rotina o formato de release notes de correção de bugs basta. Se o seu pipeline bloqueia merges sem entrada de changelog, o artigo sobre imposição no CI explica como tratar exceções urgentes sem desligar o gate. O Changeloop redige uma entrada a partir de cada pull request mesclado, então um PR de hotfix recebe um rascunho como qualquer outro merge, e uma revisora o aprova antes de qualquer coisa ser publicada.
Como evitar que hotfixes virem rotina?
Conte-os e investigue cada um. Um hotfix é a prova de que chegou à produção algo que as verificações normais deveriam ter pegado, e a contagem mostra se isso está melhorando ou piorando.
As métricas de entrega de software do DORA incluem a taxa de falha de mudanças, a proporção de deploys que exigem intervenção imediata depois de irem ao ar, provavelmente resultando em rollback ou hotfix. Uma taxa crescente em geral aponta para releases grandes demais ou testes que deixam de cobrir áreas inteiras do produto. Depois de cada hotfix, pergunte por que o bug escapou e adicione o teste, a verificação ou a etapa de revisão que o teria barrado. O artigo sobre processo de gerenciamento de releases mostra onde essas verificações ficam em uma release normal.
FAQ
Hotfix é o mesmo que patch? Todo hotfix é um patch, já que altera um software existente. A palavra hotfix acrescenta que o patch era urgente e saiu fora do cronograma normal de releases.
Que número de versão um hotfix deve receber? Normalmente a próxima versão de patch no Semantic Versioning, então um hotfix para a 2.4.0 sai como 2.4.1. Um hotfix deve conter apenas correções retrocompatíveis, que é exatamente o que um incremento de patch promete.
Quem decide se um bug precisa de hotfix? Um único papel definido, como a engenheira de plantão ou a responsável pela release, com critérios que o time escreveu de antemão. Decidir em comitê durante um incidente é lento, e decidir por quem grita mais alto faz os hotfixes virarem rotina.
Um hotfix deve pular o code review? Não. Encurte a revisão e mantenha-a: uma segunda pessoa lendo uma mudança de dez linhas leva minutos e pega o erro de digitação que transforma um incidente em dois.
As afirmações técnicas deste artigo não foram revisadas de forma independente. Se algo estiver errado, avise a gente e vamos corrigir.