CI/CDDevOps 학습 로드맵 · 22/28편

Helm은 템플릿 도구가 아니라 릴리스 버전 관리자다

Helm을 'YAML 템플릿 엔진'으로만 설명하면 반쪽짜리다. Chart(정의) - Release(배포 인스턴스) - Revision(버전 이력) 세 개념과, helm rollback이 어떻게 이전 버전의 매니페스트를 그대로 재생해 되돌리는지, ConfigMap/Secret에 저장되는 릴리스 이력의 실체까지 정리한다.

2026-09-148 min read
#Helm#Kubernetes#버전관리#릴리스#롤백
DevOps 학습 로드맵시리즈 목차
1채용공고 요구사항 6개 중 자신 있게 답할 수 있는 게 절반도 안 됐다2kubeadm으로 온프레미스 Kubernetes 클러스터를 처음부터 세우는 절차3FastAPI 서비스 골격, RabbitMQ DLQ, Harbor+Trivy, Jenkins→ArgoCD 파이프라인 구축 절차4Argo Rollouts로 카나리 배포와 Prometheus 메트릭 기반 자동 롤백 붙이기5yaml 복붙 관리의 드리프트 문제를 Kustomize overlay로 구조화하기6Terraform과 Ansible로 클러스터를 코드에서 다시 세울 수 있게 만드는 절차7Prometheus·Loki·OpenTelemetry로 세운 관측 스택 - 메트릭·로그·트레이스를 하나로8관측 스택이 진짜로 장애를 잡는가 - 노드 다운·OOMKill·디스크풀 직접 주입해보기9SLI/SLO/에러 버짓을 실제로 계산해서 배포 판단 기준으로 써보기10임계값 없이 - 통계 기반 이상탐지로 Datadog Watchdog 흉내내기11Grafana OnCall로 PagerDuty 없이 온콜·에스컬레이션 구현하기12자체 JWT 구현부터 취약점 실험, Keycloak 마이그레이션까지의 실제 절차13ISMS-P 인프라 영역 심사를 가정하고 내 클러스터의 증적을 만드는 절차14SealedSecret이 못 남기는 것 - OpenBao + External Secrets Operator로 감사 로그 확보하기15번외: 더미 워커를 실제 ONNX 추론으로, GPU 스케줄링까지 교체하는 절차16번외: 인터넷을 완전히 끊고도 클러스터가 돌아가는지 - 폐쇄망(에어갭) 시뮬레이션 절차17번외: 부하테스트로 관측 스택을 실전 검증하기 - k6 + HPA + MSA 파이프라인18번외: DORA 4대 지표를 Four Keys로 자동 집계해보기19실무와 다른 4가지를 채우려고 로드맵을 이렇게 짰다20OpenSearch·Loki·Datadog, 로그 스택은 왜 하나로 안 끝나는가21Control-Plane HA는 언제 정당한가 - etcd 쿼럼, kube-vip 페일오버, cordon/drain의 수학22OpenTelemetry는 무엇을 표준화하는가 - Prometheus·Grafana·Loki·Tempo가 실제로 맞물리는 지점23Helm은 템플릿 도구가 아니라 릴리스 버전 관리자다24카나리 배포와 블루그린 배포, 뭐가 다르고 언제 뭘 써야 하는가25SRE는 정확히 무엇을 하는 직군인가 - '운영을 소프트웨어 문제로 본다'는 말의 실체26온콜은 왜 필요하고, 어떻게 지속 가능하게 운영하는가27IaC는 한 계층이 아니다 - Terraform·Packer·Helm이 각각 다루는 것, 그리고 RKE2 vs kubeadm28SLI·SLO·에러 버짓과 온콜·에스컬레이션 - 숫자로 문제를 정의하고 사람에게 연결하기

왜 "템플릿 도구"라는 설명이 반쪽짜리인가

Helm을 소개할 때 제일 흔한 설명이 "반복되는 YAML을 템플릿화해서 값만 바꿔 재사용하는 도구"다. 틀린 말은 아니지만, 그게 Helm을 쓰는 이유의 절반밖에 안 된다. 나머지 절반은 배포 이력을 버전으로 관리하고, 그 버전으로 되돌릴 수 있다는 것이다. 템플릿 엔진 역할만 본다면 Kustomize로도 충분한 경우가 많은데, Helm이 따로 존재하는 이유는 정확히 이 릴리스(Release) 개념 때문이다.

1. Chart, Release, Revision - 세 층위를 구분한다

Helm을 정확히 이해하려면 세 단어를 헷갈리지 않아야 한다.

개념정의비유
Chart애플리케이션을 배포하는 방법이 정의된 템플릿 패키지(버전 관리되는 소스)클래스(class)
Release그 Chart를 실제 클러스터의 특정 네임스페이스에 설치한 "인스턴스"그 클래스로 만든 객체(instance)
Revision하나의 Release가 upgrade될 때마다 쌓이는 버전 번호 (1, 2, 3, ...)그 객체의 변경 이력(git commit 하나하나)

같은 Chart를 같은 클러스터에 helm install my-app, helm install my-app-staging 두 번 설치하면 Release가 두 개 생긴다 - Chart는 하나지만 Release는 독립적인 두 개다. 그리고 my-app Release를 helm upgrade로 세 번 업그레이드하면, Revision이 1→2→3→4로 쌓인다.

2. Revision은 실제로 어디에 저장되는가

helm history my-app을 실행하면 지난 업그레이드 목록이 나오는데, 이 이력이 클러스터 안의 Secret(또는 구버전은 ConfigMap) 오브젝트로 저장된다는 걸 아는 사람은 생각보다 적다.

kubectl get secrets -n <namespace> -l owner=helm
# sh.helm.release.v1.my-app.v1
# sh.helm.release.v1.my-app.v2
# sh.helm.release.v1.my-app.v3   ← 가장 최근 Revision

각 Secret의 데이터에는 그 Revision 시점에 실제로 클러스터에 적용됐던 완전한 렌더링 결과(매니페스트 전체) 가 gzip 압축 + base64 인코딩되어 그대로 들어있다. 즉 Helm은 "이번에 뭘 바꿀지"만 기억하는 게 아니라, 매 Revision마다 그 시점의 완성된 상태 전체를 스냅샷으로 통째로 저장해둔다.

3. helm rollback이 실제로 하는 일

helm rollback my-app 2를 실행하면 Helm이 하는 일은 이렇다.

  1. sh.helm.release.v1.my-app.v2 Secret을 읽어서, Revision 2 시점에 저장해둔 완전한 매니페스트를 꺼낸다.
  2. 그 매니페스트를 지금 클러스터에 그대로 다시 적용(apply)한다.
  3. 이 롤백 자체도 새로운 Revision(예: v5)으로 기록된다 - "되돌렸다"는 사실 자체도 이력에 남는다.

여기서 중요한 포인트: 롤백은 Chart 소스로 다시 렌더링하는 게 아니라, 과거에 이미 렌더링된 결과물을 그대로 재생하는 것이다. 그래서 롤백 시점에 Chart 저장소(Git)에 있는 파일이 바뀌었든 말든 상관없이, 그 Revision이 실제로 클러스터에 적용됐던 그 상태 그대로 정확히 복원된다. Kustomize나 순수 kubectl apply -f로는 이 "과거 렌더링 결과의 스냅샷"이 자동으로 남지 않기 때문에, 되돌리려면 Git에서 해당 커밋의 YAML을 다시 apply해야 하고 그 사이 참조하던 다른 리소스가 바뀌어 있으면 결과가 100% 같지 않을 수 있다.

4. GitOps(ArgoCD)와 같이 쓸 때는 무엇이 달라지는가

ArgoCD 같은 GitOps 툴은 "Git의 선언 상태 = 진실의 원천"이라는 철학이라, 롤백도 원칙적으로는 Git에서 이전 커밋으로 되돌리고 그 상태를 다시 동기화하는 방식을 권장한다. Helm의 Revision 롤백과는 철학이 약간 다르다 - Helm은 "클러스터 안에 저장된 과거 스냅샷"을 신뢰하고, GitOps는 "Git 저장소에 있는 선언"을 신뢰한다.

ArgoCD에서 Helm Chart를 배포 대상으로 쓸 경우, 실무적으로는 두 이력이 같이 존재한다 - Git 커밋 이력(어떤 값·템플릿이 언제 바뀌었는지)과 Helm Revision 이력(그게 실제로 클러스터에 언제 적용됐는지, 정확히 어떤 렌더링 결과였는지). 배포 드리프트를 조사할 때는 두 이력을 같이 봐야 "선언은 이렇게 바뀌었는데 실제로는 언제 적용됐는가"가 정확히 맞춰진다.

5. 정리 - 템플릿 엔진 + 릴리스 버전 관리자

역할담당 개념대체 가능한 도구
반복 YAML을 값으로 치환Chart의 templates/values.yamlKustomize로도 어느 정도 대체 가능
배포 인스턴스 식별Release(Kustomize엔 이 개념이 없음)
버전별 완전한 스냅샷 저장·롤백Revision(클러스터 내 Secret)(Kustomize·순수 kubectl엔 이 개념이 없음)

"Helm을 쓰는 이유"를 한 줄로 압축하면, **템플릿 재사용은 덤이고 진짜 이유는 "배포된 상태를 버전으로 관리하고 그 버전으로 정확히 되돌릴 수 있다는 것"**이다.

체크리스트

  • Chart·Release·Revision 세 개념을 각각 정확히 구분해서 설명할 수 있는가
  • Revision 이력이 클러스터 안 Secret에 완전한 매니페스트 스냅샷으로 저장된다는 것을 아는가
  • helm rollback이 Chart를 다시 렌더링하는 게 아니라 과거 렌더링 결과를 그대로 재생한다는 차이를 설명할 수 있는가
  • Helm Revision 이력과 GitOps(Git 커밋 이력)가 서로 다른 신뢰 원천이라는 것을 설명할 수 있는가