Ingeniería

Qué es un hotfix: significado, diferencias y cómo lanzarlo

7 min de lectura

Un hotfix es la corrección de un problema grave en producción, publicada fuera del ciclo normal de lanzamientos porque esperar a la siguiente release planificada costaría más que el riesgo de ir deprisa. Es pequeño por diseño, pasa por una versión abreviada de las comprobaciones habituales y los usuarios se enteran en cuanto es posible. La palabra significó primero un cambio aplicado a un sistema “caliente”, un servidor que seguía atendiendo usuarios, y hoy describe la urgencia más que la forma de instalar la corrección.

TérminoQué esCuándo saleAlcance típico
HotfixUna corrección urgente de un problema que los usuarios sufren ahoraEn cuanto está lista, fuera del calendarioUn solo defecto
BugfixCualquier corrección de un defectoNormalmente con la siguiente release planificadaUno o más defectos
ParcheUna actualización de software existente; en SemVer, una release que sube el último númeroPlanificada o urgenteCorrecciones retrocompatibles
Service pack o rollupUn paquete acumulativo y probado de correcciones anterioresSegún un calendarioMuchas correcciones, a veces funciones pequeñas
Live patchUna corrección aplicada a código en ejecución sin reiniciarCuando reiniciar es demasiado costosoUnas pocas funciones

¿Qué significa hotfix en software?

Un hotfix es un cambio hecho deprisa para corregir un problema en software que ya está en uso, publicado por separado en lugar de esperar a la siguiente versión. El término lleva dos ideas a la vez: el problema es grave y el proceso normal se ha acortado para atenderlo.

El artículo de Wikipedia sobre hotfix traza ese cambio de sentido. El término se refería originalmente a parchear un sistema caliente, un servidor de producción que atiende clientes en ese momento, y con el tiempo pasó a significar cualquier actualización creada con urgencia o publicada fuera del ciclo normal de actualizaciones. Microsoft usó la palabra durante años y desde entonces ha pasado a otra terminología, aunque su lista actual de tipos de actualización sigue describiendo un service pack como un conjunto acumulativo y probado de hotfixes, actualizaciones de seguridad, actualizaciones críticas y actualizaciones. El sentido original de “caliente” pervive en el live patching, que la documentación de livepatch del kernel de Linux describe como corregir funciones críticas sin reiniciar el sistema.

¿Cuál es la diferencia entre un hotfix y un parche?

Un parche es cualquier actualización que cambia software existente, y un hotfix es un parche definido por su urgencia y su momento. Todo hotfix es un parche; la mayoría de los parches están planificados y salen con una release normal.

El solapamiento con el versionado causa la mayor parte de la confusión. Con Semantic Versioning, el número PATCH sube cuando haces correcciones de errores retrocompatibles, así que un hotfix sobre la versión 2.4.0 normalmente sale como 2.4.1. Una release de mantenimiento planificada también puede ser 2.4.1. El número de versión registra qué tipo de cambio es, y la palabra hotfix registra por qué no podía esperar. Un bugfix es el mismo tipo de cambio con un calendario normal: el código puede ser idéntico, y la diferencia está en si rompiste el ciclo de lanzamientos para publicarlo.

¿Cuándo merece un bug un hotfix?

Cuando dejarlo en producción hasta la siguiente release cuesta más que el riesgo de publicar un cambio apresurado. Ese juicio debe hacerlo una persona concreta, con criterios que el equipo acordó con calma, y no quien esté más alarmado.

Problemas que suelen justificar un hotfix:

  • Pérdida o corrupción de datos, incluidos datos mal escritos que habrá que limpiar más tarde.
  • Una vulnerabilidad de seguridad que se está explotando o que es fácil de explotar.
  • Un flujo central roto para muchos usuarios: iniciar sesión, pagar, guardar el trabajo.
  • Una regresión de la última release que bloquea a clientes que ayer estaban bien.
  • Una obligación legal o contractual que el software ha dejado de cumplir.

Los problemas que normalmente pueden esperar a la siguiente release son los cosméticos, los bugs con una solución alternativa razonable y todo lo que afecta a pocos usuarios y no empeora. Conviene escribir la lista porque toda corrección urgente se salta algunas de las comprobaciones que protegen producción, y un equipo que hace hotfix de todo ha abandonado en silencio su proceso de lanzamiento.

¿Cómo se lanza un hotfix con seguridad?

Corrige la versión que de verdad se está ejecutando, cambia lo mínimo, prueba la corrección sobre la build exacta que vas a desplegar, ten una vía de vuelta atrás y fusiona la corrección en la línea principal para que la siguiente release no traiga el bug de vuelta.

  1. Confirma y acota. Reproduce el problema, confirma que cumple los criterios anteriores y nombra a una persona responsable de la corrección.
  2. Crea la rama desde lo que está en producción. En el modelo git-flow del artículo sobre el modelo de ramas de Vincent Driessen, una rama de hotfix parte de la etiqueta de producción en master, la versión se sube de inmediato y la rama terminada se fusiona de vuelta tanto en master como en develop. La propia nota de 2020 de Driessen sobre ese artículo recomienda un flujo más sencillo para apps web de entrega continua, y ahí el hotfix es un pull request pequeño sobre la rama principal que se despliega enseguida.
  3. Haz el cambio más pequeño que lo corrija. Nada de refactorizar ni de funciones extra. Todo lo que no sea la corrección puede salir la semana que viene.
  4. Demuéstralo. Añade una prueba que reproduzca el bug y falle sin la corrección, y después ejecuta la suite completa sobre el commit que vas a desplegar.
  5. Versiona y etiqueta. Sube el número de parche y etiqueta el commit, como se describe en tags de git y releases.
  6. Despliega con una vía de vuelta atrás. Haz el despliegue gradual donde puedas, vigila las tasas de error y conoce el comando de rollback antes de necesitarlo.
  7. Fusiona de vuelta. Si la corrección se hizo sobre una rama de release, fusiónala en la línea principal ese mismo día.

¿Necesita un hotfix una entrada de changelog y notas de versión?

Sí. Los usuarios que sufrieron el bug necesitan saber que está corregido y qué deben hacer, si es que deben hacer algo, y quien lea el historial de versiones más adelante necesita saber por qué existe una 2.4.1 dos días después de la 2.4.0.

Mantén la nota breve: qué estaba roto, a quién afectó, qué cambia para ellos y qué versión contiene la corrección. Cuando el hotfix responde a un incidente, se aplica la guía de las notas de versión de emergencia, y para una corrección rutinaria basta el formato de las notas de versión de corrección de errores. Si tu pipeline bloquea los merges sin una entrada de changelog, el artículo sobre el check de CI explica cómo gestionar excepciones urgentes sin apagar el gate. Changeloop redacta una entrada a partir de cada pull request fusionado, así que el PR de un hotfix recibe un borrador como cualquier otro merge, y alguien lo aprueba antes de que se publique nada.

¿Cómo evitas que los hotfixes se vuelvan rutina?

Cuéntalos e investiga cada uno. Un hotfix es prueba de que algo llegó a producción que las comprobaciones normales deberían haber detectado, y el recuento te dice si eso va mejorando o empeorando.

Las métricas de entrega de software de DORA incluyen la tasa de fallos de cambios, la proporción de despliegues que requieren intervención inmediata después de salir, lo que probablemente acaba en un rollback o un hotfix. Una tasa que sube suele apuntar a releases demasiado grandes o a pruebas que se dejan áreas enteras del producto. Después de cada hotfix, pregunta por qué se escapó el bug y añade la prueba, la comprobación o el paso de revisión que lo habría frenado. El artículo sobre el proceso de gestión de releases explica dónde encajan esas comprobaciones en una release normal.

FAQ

¿Es un hotfix lo mismo que un parche? Todo hotfix es un parche, porque cambia software existente. La palabra hotfix añade que el parche era urgente y salió fuera del calendario normal de lanzamientos.

¿Qué número de versión debe tener un hotfix? Normalmente la siguiente versión de parche según Semantic Versioning, así que un hotfix sobre 2.4.0 sale como 2.4.1. Un hotfix debería contener solo correcciones retrocompatibles, que es exactamente lo que promete un incremento de parche.

¿Quién decide si un bug necesita un hotfix? Un único rol concreto, como la persona de guardia o la responsable de la release, con criterios que el equipo escribió de antemano. Decidir por comité durante un incidente es lento, y decidir por quien grite más fuerte convierte los hotfixes en rutina.

¿Debe un hotfix saltarse la revisión de código? No. Acorta la revisión, pero mantenla: una segunda persona leyendo un cambio de diez líneas tarda minutos y detecta el error tipográfico que convertiría un incidente en dos.


Las afirmaciones técnicas de este artículo no se han revisado de forma independiente. Si algo está mal, avísanos y lo corregiremos.

Relacionado en Changeloop: Generador de changelog, Plantilla de release notes

changeloop
El equipo que crea un changelog que cierra el círculo. Tus usuarios lo piden, tu equipo lo publica y quien lo pidió se entera.