RunContainerError

이 오류가 뜻하는 것

Kubernetes에서 RunContainerError 상태 또는 이벤트가 표시되었음을 뜻합니다.

이 문서는 화면이나 로그의 원문을 식별하고 다음 확인 순서를 제시합니다. 오류 문구만으로 운영 환경의 단일 원인을 확정하지 않습니다.

확인 절차

1. kubectl get pod <pod> -o wide에서 현재 상태와 재시작 횟수를 확인합니다.
2. kubectl describe pod <pod>의 Events와 컨테이너 종료 이유를 확인합니다.
3. 애플리케이션 컨테이너가 한 번 이상 실행된 경우 kubectl logs <pod> --previous를 확인합니다.

해결 순서

1. Events와 컨테이너 종료 코드를 먼저 확인해 이미지·설정·리소스·애플리케이션 중 범위를 좁힙니다.
2. Deployment 매니페스트의 이미지, 환경 변수, probe, resource 설정을 한 항목씩 수정합니다.
3. 새 Pod의 상태와 재시작 횟수가 안정되는지 확인한 뒤에만 이전 ReplicaSet을 정리합니다.

주의

• 운영 중인 데이터, 권한, 포트, 인증서와 배포 대상을 한 번에 변경하지 않습니다.
• 수정 전 오류 원문, 실행 명령, 로그 시각과 관련 버전을 보관합니다.
• 공식 문서가 설명하지 않는 환경별 원인은 재현 결과와 해당 플랫폼 문서를 추가로 확인합니다.

공식 근거

• Pod Lifecycle | Kubernetes (새 창에서 열림)