본문 바로가기

Helm 4에서 바뀐 --atomic과 --wait 옵션 정리

조회 2 · 댓글 0
냉장고를사다줘작성자2026년 8월 19일

Helm 3에서 배포 실패시 자동 롤백으로 쓰던 --atomic, Helm 4로 오면서 이름이 바뀌었습니다. 이제 정식 이름은 --rollback-on-failure이고 --atomic은 deprecated 별칭이라 붙이면 경고가 뜹니다. 아직 동작은 하지만 이후 릴리스에서 제거될 예정이라 스크립트는 미리 고쳐두는 게 낫습니다.

같이 바뀐 게 --wait입니다. 예전엔 불리언이었는데 Helm 4에서는 WaitStrategy 값을 받습니다. 플래그를 안 주면 기본이 hookOnly라 워크로드 파드 준비는 안 기다리고 훅 리소스만 기다립니다. 파드까지 Ready로 확인하려면 --wait만 붙이면 되는데, 이러면 kstatus 기반 watcher 전략이 선택됩니다. 값은 watcher, hookOnly, legacy 셋이고 legacy가 예전 방식입니다. --rollback-on-failure를 켜면 --wait이 watcher로 자동 설정됩니다.

# 실패하면 자동 롤백 + watcher로 파드 Ready까지 대기
helm upgrade --install myapp ./chart \
  --rollback-on-failure --wait watcher --timeout 5m0s

주의점 하나. --wait 없이 배포하던 파이프라인을 Helm 4로 그냥 올리면 기본 hookOnly라 예전 helm 3과 동일하게 동작합니다. 다만 "배포 후 Ready까지 대기"를 기대했다면 명시적으로 --wait을 넣어야 합니다. --timeout 기본값은 5m0s입니다.

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

🔗 https://helm.sh/docs/overview/

로그인 후 답글을 남길 수 있습니다.