helm upgrade --atomic으로 자동 롤백하기 · 게시판

helm upgrade를 돌렸는데 중간에 실패해서 일부 리소스만 바뀐 어중간한 상태로 남은 적이 있을 겁니다. 이럴 때 --atomic을 붙이면 업그레이드가 실패할 경우 변경분을 이전 릴리스로 자동 롤백해줍니다. 배포 파이프라인에서 깨진 상태를 손으로 되돌리는 수고를 덜어줍니다.

helm upgrade --install myapp ./chart \
  --atomic \
  --timeout 10m

--atomic을 쓰면 --wait가 자동으로 켜집니다. 그래서 Pod, PVC, Service, Deployment/StatefulSet/ReplicaSet의 최소 Ready 개수가 준비될 때까지 기다렸다가 성공으로 처리합니다. 기다리는 시간은 --timeout을 따르는데 기본값이 개별 작업당 5m0s라 느린 이미지 풀이나 헬스체크가 있으면 넉넉히 늘려두는 게 좋습니다. 여기에 --cleanup-on-fail을 같이 주면 실패한 업그레이드에서 새로 만들어진 리소스까지 지워줍니다.

알아둘 점은 --atomic 롤백 자체가 클러스터 상태를 되돌리는 동작이라는 겁니다. 운영 릴리스에 쓸 때는 롤백이 돌면서 이전 버전으로 복귀한다는 걸 전제로 깔고, 중요한 변경은 helm history로 리비전을 먼저 확인해두고 적용하는 편이 안전합니다.

🔗 https://helm.sh/docs/v3/helm/helm_upgrade/