Engineering

Wat is een hotfix? Betekenis, hotfix vs patch en uitrollen

6 min lezen

Een hotfix is een fix voor een serieus probleem in productie, buiten de normale releasecyclus uitgebracht omdat wachten op de volgende geplande release meer zou kosten dan het risico van snel handelen. Hij is bewust klein, doorloopt een ingekorte versie van de gebruikelijke controles en gebruikers horen er zo snel mogelijk van. Het woord betekende oorspronkelijk een wijziging op een “hot” systeem, een server die nog gebruikers bedient, en beschrijft tegenwoordig meer de urgentie dan de manier waarop de fix wordt geïnstalleerd.

TermWat het isWanneer het uitkomtTypische reikwijdte
HotfixEen dringende fix voor een probleem waar gebruikers nu last van hebbenZodra hij klaar is, buiten het schema omEén defect
BugfixElke fix voor een defectMeestal met de volgende geplande releaseEen of meer defecten
PatchEen update van bestaande software; in SemVer een release die het laatste getal ophoogtGepland of dringendAchterwaarts compatibele fixes
Servicepack of rollupEen geteste, cumulatieve bundel van eerdere fixesVolgens een schemaVeel fixes, soms kleine features
Live patchEen fix op draaiende code zonder herstartAls een herstart te duur isEen paar functies

Wat betekent hotfix in software?

Een hotfix is een snel gemaakte wijziging om een probleem in software die al in gebruik is te verhelpen, los uitgebracht in plaats van te wachten op de volgende versie. De term draagt twee ideeën tegelijk: het probleem is serieus en het normale proces is ingekort om het aan te pakken.

Het hotfix-artikel van Wikipedia schetst de verschuiving. De term verwees oorspronkelijk naar het patchen van een hot systeem, een productieserver die actief clients bedient, en ging na verloop van tijd elke update betekenen die met urgentie is gemaakt of buiten de normale updatecyclus is uitgebracht. Microsoft gebruikte het woord jarenlang en is inmiddels op andere terminologie overgestapt, al beschrijft de huidige lijst met updatetypen een servicepack nog steeds als een geteste, cumulatieve set hotfixes, beveiligingsupdates, kritieke updates en updates. De oorspronkelijke “hot”-betekenis leeft voort in live patching, die de livepatch-documentatie van de Linux-kernel beschrijft als het repareren van kritieke functies zonder herstart van het systeem.

Wat is het verschil tussen een hotfix en een patch?

Een patch is elke update die bestaande software wijzigt, en een hotfix is een patch die wordt bepaald door urgentie en timing. Elke hotfix is een patch; de meeste patches zijn gepland en komen mee met een reguliere release.

De overlap met versienummering veroorzaakt de meeste verwarring. Onder Semantic Versioning gaat het PATCH-nummer omhoog als je achterwaarts compatibele bugfixes maakt, dus een hotfix voor versie 2.4.0 komt normaal uit als 2.4.1. Een geplande onderhoudsrelease kan ook 2.4.1 zijn. Het versienummer legt vast wat voor soort wijziging het is, en het woord hotfix legt vast waarom hij niet kon wachten. Een bugfix is dezelfde soort wijziging volgens een normaal schema: de code kan identiek zijn, en het verschil is of je de releasecyclus doorbrak om hem uit te brengen.

Wanneer verdient een bug een hotfix?

Wanneer de bug tot de volgende release laten staan meer kost dan het risico van een haastige wijziging. Dat oordeel hoort te worden geveld door een benoemd persoon, aan de hand van criteria die het team in rustige tijden heeft afgesproken, en niet door wie het meest in paniek is.

Problemen die meestal een hotfix rechtvaardigen:

  • Dataverlies of datacorruptie, inclusief data die verkeerd is weggeschreven en later moet worden opgeschoond.
  • Een beveiligingslek dat wordt misbruikt of makkelijk te misbruiken is.
  • Een kernflow die voor veel gebruikers kapot is: inloggen, betalen, werk opslaan.
  • Een regressie uit de laatste release die klanten blokkeert die gisteren nog geen last hadden.
  • Een wettelijke of contractuele verplichting waaraan de software niet meer voldoet.

Problemen die meestal kunnen wachten tot de volgende release: cosmetische kwesties, bugs met een redelijke workaround en alles wat weinig gebruikers raakt en niet erger wordt. Het is belangrijk om de lijst op te schrijven, omdat elke dringende fix een deel van de controles omzeilt die productie beschermen, en een team dat alles hotfixt zijn releaseproces stilletjes heeft opgegeven.

Hoe breng je een hotfix veilig uit?

Repareer de versie die echt draait, wijzig zo weinig mogelijk, test de fix op exact de build die je gaat deployen, houd een weg terug open en merge de fix in de hoofdlijn, zodat de volgende release de bug niet terugbrengt.

  1. Bevestig en bepaal de reikwijdte. Reproduceer het probleem, bevestig dat het aan de criteria hierboven voldoet en wijs één eigenaar voor de fix aan.
  2. Branch vanaf wat in productie staat. In het git-flowmodel uit Vincent Driessens artikel over zijn branchingmodel begint een hotfixbranch bij de productietag op master, wordt de versie meteen opgehoogd en wordt de afgeronde branch teruggemerged in zowel master als develop. Driessens eigen notitie uit 2020 bij dat artikel raadt een eenvoudiger flow aan voor webapps met continuous delivery, en daar is de hotfix een kleine pull request op de hoofdbranch, direct gedeployed.
  3. Maak de kleinst mogelijke wijziging die het oplost. Geen refactoring en geen extra features. Alles wat niet de fix is, kan volgende week mee.
  4. Bewijs het. Voeg een test toe die de bug reproduceert en zonder de fix faalt, en draai daarna de volledige suite op de commit die je gaat deployen.
  5. Versioneer en tag. Verhoog het patchnummer en tag de commit, zoals beschreven in git tags en releases.
  6. Deploy met een weg terug. Rol waar mogelijk geleidelijk uit, let op foutpercentages en ken het rollbackcommando voordat je het nodig hebt.
  7. Merge terug. Als de fix op een releasebranch is gemaakt, merge hem dezelfde dag in de hoofdlijn.

Heeft een hotfix een changelog-entry en release notes nodig?

Ja. De gebruikers die de bug raakten, moeten weten dat hij is opgelost en wat ze eventueel moeten doen, en wie later de versiegeschiedenis leest, moet weten waarom er twee dagen na 2.4.0 een 2.4.1 bestaat.

Houd de notitie kort: wat kapot was, wie het raakte, wat er voor hen verandert en welke versie de fix bevat. Als de hotfix een incident beantwoordt, geldt de aanpak uit noodrelease notes, en voor een routinefix volstaat het format uit release notes voor bugfixes. Als je pipeline merges zonder changelog-entry blokkeert, legt het artikel over CI-handhaving uit hoe je dringende uitzonderingen afhandelt zonder de gate uit te zetten. Changeloop maakt van elke gemergede pull request een conceptentry, dus een hotfix-PR krijgt een concept zoals elke andere merge, en een reviewer keurt het goed voordat er iets wordt gepubliceerd.

Hoe voorkom je dat hotfixes routine worden?

Tel ze en onderzoek ze stuk voor stuk. Een hotfix is het bewijs dat er iets in productie kwam wat de normale controles hadden moeten vangen, en de telling laat zien of dat beter of slechter wordt.

De softwaredelivery-metrics van DORA bevatten de change fail rate, de verhouding van deployments die direct ingrijpen vereisen nadat ze live gaan, wat waarschijnlijk uitmondt in een rollback of een hotfix. Een stijgend percentage wijst meestal op releases die te groot zijn of tests die hele delen van het product missen. Vraag je na elke hotfix af waarom de bug ontsnapte en voeg de test, controle of reviewstap toe die hem had tegengehouden. Het artikel over het releasemanagementproces laat zien waar die controles in een normale release zitten.

FAQ

Is een hotfix hetzelfde als een patch? Elke hotfix is een patch, omdat hij bestaande software wijzigt. Het woord hotfix voegt eraan toe dat de patch dringend was en buiten het normale releaseschema uitkwam.

Welk versienummer moet een hotfix krijgen? Meestal de volgende patchversie onder Semantic Versioning, dus een hotfix voor 2.4.0 komt uit als 2.4.1. Een hotfix hoort alleen achterwaarts compatibele fixes te bevatten, en dat is precies wat een patchverhoging belooft.

Wie beslist of een bug een hotfix nodig heeft? Eén benoemde rol, zoals de on-callengineer of de releaseowner, aan de hand van criteria die het team vooraf heeft opgeschreven. Beslissen in een commissie tijdens een incident is traag, en beslissen door wie het hardst roept maakt hotfixes routine.

Moet een hotfix de codereview overslaan? Nee. Maak de review korter, maar houd hem: een tweede persoon die een wijziging van tien regels leest, kost minuten en vangt de typefout die van één incident er twee maakt.


De technische beweringen in dit artikel zijn niet onafhankelijk gecontroleerd. Klopt er iets niet, laat het ons weten, dan corrigeren we het.

Meer op Changeloop: Changelog-generator, Sjabloon voor release notes

changeloop
Het team achter een changelog die de cirkel rondmaakt. Je gebruikers vragen iets, je team levert het, degene die het vroeg hoort ervan.