이미지 Pull 오류(imagePullSecrets 및 Service Account 설정) 관련 문의

K-Seven Group 0 평판 포인트
2026-10-12T05:49:40.27+00:00

Pod가 이미지를 가져오려고 할 때 rpc error: code = Unknown desc = Error response from daemon 오류가 발생하여 컨테이너가 정상적으로 시작되지 않고 있습니다.

현재 이미지 레지스트리 인증 문제로 보이는데, imagePullSecrets와 Service Account를 올바르게 설정하는 방법이 궁금합니다.

Pod 또는 네임스페이스 수준에서 imagePullSecrets를 연결하는 방법과 Service Account를 통해 여러 Pod에서 공통으로 사용할 수 있도록 구성하는 방법을 자세히 안내해 주시면 감사하겠습니다.

비즈니스용 Windows | Windows 365 Enterprise
댓글 0개

답변 1개

정렬 기준: 가장 유용함
가장 유용함 최신순 등록순
  1. HLBui 13,580 평판 포인트 독립 자문가
    2026-10-12T06:17:34.5466667+00:00

    안녕하세요 K-Seven Group

    말씀해 주신 증상은 대부분 이미지 레지스트리 인증 정보가 없거나 잘못 연결되었을 때 발생하는 경우가 많습니다. 먼저 kubectl create secret docker-registry 명령으로 imagePullSecret을 생성한 뒤, Pod 스펙의 imagePullSecrets 항목에 해당 Secret 이름을 연결해 보시는 것을 권장드립니다.

    여러 Pod에서 동일한 인증 정보를 사용해야 한다면, Service Account에 imagePullSecret을 연결하는 방법이 훨씬 관리가 편합니다. 예를 들어 Service Account에 imagePullSecrets를 지정한 후 Pod에서 해당 Service Account를 사용하도록 설정하면, 개별 Pod마다 Secret을 반복해서 정의할 필요가 없습니다.

    또한 kubectl describe pod <pod-name> 명령으로 이벤트 로그를 확인해 보시면 실제로 인증 실패인지, 이미지 이름 오타인지, 혹은 레지스트리 접근 권한 문제인지 보다 정확한 원인을 확인할 수 있습니다. 특히 ACR, Docker Hub, Harbor 같은 프라이빗 레지스트리를 사용 중이라면 Secret에 저장된 계정 정보가 현재도 유효한지 꼭 점검해 주세요.

    위 방법으로 대부분의 image pull 인증 문제는 해결되는 경우가 많습니다. 도움이 되셨다면 "Accept Answer" 를 눌러 주시면 다른 분들이 동일한 문제를 해결하는 데도 큰 도움이 됩니다.

    이 대답이 도움이 되었나요?

답변

질문 작성자는 답변을 '승인됨'으로 표시하고, 중재자는 답변을 '추천됨'으로 표시할 수 있습니다. 이를 통해 사용자는 해당 답변이 작성자의 문제를 해결했다는 것을 알 수 있습니다.