엔지니어링

핫픽스란? 뜻, 핫픽스와 패치의 차이, 안전한 배포

5분 분량

핫픽스는 프로덕션의 심각한 문제를 고치는 수정으로, 다음 정규 릴리스를 기다리는 비용이 빠르게 움직이는 위험보다 크기 때문에 정규 릴리스 주기 밖에서 내보낸다. 의도적으로 작게 만들고, 평소 점검을 줄인 형태로 통과시키며, 사용자는 받을 수 있게 되는 즉시 소식을 듣는다. 이 용어는 원래 “뜨거운” 시스템, 즉 아직 사용자에게 서비스하고 있는 서버에 적용한 변경을 뜻했고, 오늘날에는 수정을 설치하는 방식보다 긴급성을 가리킨다.

용어정의배포 시점일반적인 범위
핫픽스사용자가 지금 겪는 문제에 대한 긴급 수정준비되는 즉시, 일정과 무관하게결함 하나
버그 수정결함에 대한 모든 수정보통 다음 정규 릴리스와 함께결함 하나 이상
패치기존 소프트웨어에 대한 업데이트. SemVer에서는 마지막 숫자를 올리는 릴리스계획된 것 또는 긴급한 것하위 호환 수정
서비스 팩 또는 롤업이전 수정들을 테스트해 누적한 묶음일정에 따라많은 수정, 때로는 작은 기능
라이브 패치재시작 없이 실행 중인 코드에 적용하는 수정재시작 비용이 너무 클 때몇 개의 함수

소프트웨어에서 핫픽스는 무슨 뜻인가

핫픽스는 이미 쓰이고 있는 소프트웨어의 문제를 고치기 위해 빠르게 만든 변경으로, 다음 버전을 기다리지 않고 단독으로 릴리스된다. 이 용어에는 두 가지 생각이 함께 담겨 있다. 문제가 심각하다는 것, 그리고 이를 처리하기 위해 평소 과정을 줄였다는 것이다.

위키백과의 핫픽스 문서가 그 변화를 추적한다. 이 용어는 원래 뜨거운 시스템, 즉 클라이언트에 실제로 서비스 중인 프로덕션 서버에 패치를 적용하는 것을 가리켰고, 시간이 지나면서 긴급하게 만들어졌거나 정규 업데이트 주기 밖에서 릴리스된 모든 업데이트를 뜻하게 되었다. Microsoft는 이 단어를 오랫동안 썼고 이후 다른 용어로 옮겨 갔지만, 현재의 업데이트 유형 목록은 여전히 서비스 팩을 핫픽스, 보안 업데이트, 중요 업데이트, 업데이트를 테스트해 누적한 집합으로 설명한다. “뜨겁다”는 원래 의미는 라이브 패치에 살아 있으며, Linux 커널의 livepatch 문서는 이를 시스템 재부팅 없이 핵심 함수를 고치는 것으로 설명한다.

핫픽스와 패치는 무엇이 다른가

패치는 기존 소프트웨어를 바꾸는 모든 업데이트이고, 핫픽스는 긴급성과 시점으로 정의되는 패치다. 모든 핫픽스는 패치이지만, 대부분의 패치는 계획된 것이고 정규 릴리스와 함께 나간다.

혼란의 대부분은 버전 표기와 겹치는 데서 온다. 유의적 버전(Semantic Versioning)에서는 하위 호환되는 버그를 고칠 때 PATCH 숫자가 올라가므로, 2.4.0 버전에 대한 핫픽스는 보통 2.4.1로 나간다. 계획된 유지보수 릴리스도 2.4.1일 수 있다. 버전 번호는 어떤 종류의 변경인지를 기록하고, 핫픽스라는 말은 왜 기다릴 수 없었는지를 기록한다. 버그 수정은 정상 일정 위에 놓인 같은 종류의 변경이다. 코드가 똑같을 수도 있으며, 차이는 그것을 내보내려고 릴리스 주기를 깼는지 여부다.

어떤 버그가 핫픽스를 받을 만한가

다음 릴리스까지 프로덕션에 그대로 두는 비용이 서둘러 만든 변경을 내보내는 위험보다 클 때다. 이 판단은 가장 불안해하는 사람이 아니라, 평온할 때 팀이 합의한 기준에 따라 지정된 한 사람이 내려야 한다.

보통 핫픽스를 정당화하는 문제는 다음과 같다.

  • 데이터 손실이나 손상. 잘못 기록되어 나중에 정리해야 할 데이터도 포함한다.
  • 악용되고 있거나 악용하기 쉬운 보안 취약점.
  • 로그인, 결제, 작업 저장처럼 핵심 흐름이 많은 사용자에게 깨진 경우.
  • 최신 릴리스의 회귀로, 전날까지 문제없던 고객이 막힌 경우.
  • 소프트웨어가 더 이상 충족하지 못하게 된 법적 또는 계약상의 의무.

보통 다음 릴리스까지 기다려도 되는 문제는 외관상의 문제, 합리적인 우회 방법이 있는 버그, 영향받는 사용자가 적고 악화되지 않는 문제다. 목록을 적어 두는 것이 중요한 이유는 긴급 수정이 모두 프로덕션을 지키는 점검 일부를 건너뛰기 때문이며, 모든 것을 핫픽스로 내보내는 팀은 조용히 릴리스 프로세스를 포기한 것이다.

핫픽스는 어떻게 안전하게 배포하는가

실제로 돌아가고 있는 버전을 고치고, 최소한만 바꾸고, 배포할 바로 그 빌드에서 수정을 테스트하고, 되돌릴 길을 확보하고, 다음 릴리스가 버그를 되살리지 않도록 수정을 메인 라인에 병합하라.

  1. 확인하고 범위를 정한다. 문제를 재현하고, 위 기준에 해당하는지 확인하고, 수정을 맡을 담당자 한 명을 지정한다.
  2. 프로덕션에 있는 것에서 브랜치를 딴다. Vincent Driessen의 브랜칭 모델 글에 나오는 git-flow 모델에서 핫픽스 브랜치는 master의 프로덕션 태그에서 시작하고, 버전을 즉시 올리며, 완성된 브랜치는 master와 develop 양쪽에 병합된다. Driessen 본인이 2020년에 그 글에 덧붙인 노트는 지속적으로 배포하는 웹 앱에는 더 단순한 흐름을 권하며, 이 경우 핫픽스는 메인 브랜치에 올리는 작은 풀 리퀘스트이고 곧바로 배포된다.
  3. 고치는 데 필요한 가장 작은 변경만 한다. 리팩터링도 추가 기능도 안 된다. 수정이 아닌 것은 다음 주에 내보내면 된다.
  4. 증명한다. 수정이 없으면 실패하며 버그를 재현하는 테스트를 추가한 뒤, 배포할 커밋에서 전체 테스트 스위트를 실행한다.
  5. 버전을 올리고 태그를 붙인다. git 태그와 릴리스에서 설명한 대로 패치 번호를 올리고 커밋에 태그를 붙인다.
  6. 되돌릴 길을 두고 배포한다. 가능하면 점진적으로 롤아웃하고, 오류율을 지켜보고, 필요해지기 전에 롤백 명령을 알아 둔다.
  7. 다시 병합한다. 수정을 릴리스 브랜치에서 만들었다면 같은 날 메인 라인에 병합한다.

핫픽스에도 체인지로그 항목과 릴리스 노트가 필요한가

그렇다. 버그를 겪은 사용자는 그것이 고쳐졌다는 것과, 해야 할 일이 있다면 무엇인지 알아야 하고, 나중에 버전 이력을 읽는 사람은 2.4.0이 나온 지 이틀 만에 왜 2.4.1이 존재하는지 알아야 한다.

노트는 짧게 쓴다. 무엇이 망가졌는지, 누가 영향을 받았는지, 그들에게 무엇이 달라지는지, 어느 버전에 수정이 들어 있는지다. 핫픽스가 인시던트에 대응하는 것이라면 긴급 릴리스 노트의 지침이 적용되고, 일상적인 수정이라면 버그 수정 릴리스 노트의 형식으로 충분하다. 파이프라인이 체인지로그 항목 없이는 머지를 막는다면, CI 강제 적용 글이 게이트를 끄지 않고 긴급 예외를 처리하는 방법을 설명한다. Changeloop은 머지된 모든 풀 리퀘스트에서 항목 초안을 만들므로 핫픽스 PR도 다른 머지와 똑같이 초안이 생기고, 검토자가 승인해야 비로소 무엇이든 게시된다.

핫픽스가 일상이 되지 않게 하려면 어떻게 해야 하는가

횟수를 세고 하나하나 조사하라. 핫픽스는 정상적인 점검이 잡았어야 할 것이 프로덕션에 도달했다는 증거이며, 횟수는 그 상황이 나아지는지 나빠지는지를 알려 준다.

DORA의 소프트웨어 배포 지표에는 변경 실패율이 포함된다. 배포한 뒤 즉각적인 조치가 필요한 배포의 비율이며, 대개 롤백이나 핫픽스로 이어진다. 이 비율이 오른다면 보통 릴리스가 너무 크거나 테스트가 제품의 큰 영역을 놓치고 있다는 뜻이다. 핫픽스를 낼 때마다 버그가 왜 빠져나갔는지 묻고, 그것을 막았을 테스트, 점검 또는 검토 단계를 추가하라. 릴리스 관리 프로세스 글은 그런 점검이 정상 릴리스의 어디에 놓이는지 다룬다.

FAQ

핫픽스는 패치와 같은가? 모든 핫픽스는 기존 소프트웨어를 바꾸므로 패치다. 핫픽스라는 말은 그 패치가 긴급했고 정규 릴리스 일정 밖에서 나갔다는 점을 더한다.

핫픽스에는 어떤 버전 번호를 붙여야 하는가? 보통 유의적 버전에서 다음 패치 버전이며, 2.4.0에 대한 핫픽스는 2.4.1로 나간다. 핫픽스에는 하위 호환 수정만 들어가야 하고, 이는 패치 증가가 약속하는 바로 그것이다.

버그에 핫픽스가 필요한지 누가 결정하는가? 온콜 엔지니어나 릴리스 담당자처럼 지정된 한 역할이, 팀이 미리 적어 둔 기준에 따라 정한다. 인시던트 중에 위원회로 결정하면 느리고, 가장 크게 외치는 사람이 정하면 핫픽스가 일상이 된다.

핫픽스는 코드 리뷰를 건너뛰어도 되는가? 아니다. 리뷰를 줄이되 없애지는 마라. 두 번째 사람이 열 줄짜리 변경을 읽는 데는 몇 분이면 되고, 인시던트 하나를 둘로 만드는 오타를 잡아 준다.


이 글의 기술적 내용은 독립적으로 검토되지 않았습니다. 잘못된 부분이 있으면 알려 주세요. 바로잡겠습니다.

Changeloop 관련 페이지: changelog 생성기, 릴리스 노트 템플릿

changeloop
루프를 닫는 changelog를 만드는 팀입니다. 사용자가 무언가를 요청하면 팀이 전달하고, 요청한 사람은 알게 됩니다.