[kubernetes] Backoff pulling image에러 원인과 해결책

 

Kubernetes에서 Back-off pulling image 에러는 일반적으로 이미지 레지스트리에서 Docker 이미지를 가져오는 데 문제가 발생했을 때 나타납니다. 이 에러 메시지에서 중요한 부분은 Back-off pulling image 뒤에 있는 이미지 이름과 태그입니다. 예를 들어, A.azurecr.io/a/image:latest와 같은 형식이 보이는데, 이 에러는 Kubernetes가 지정된 이미지를 레지스트리에서 가져오는 데 실패했음을 의미합니다.

원인

이 에러의 주요 원인은 다음과 같습니다:

1. 이미지 이름 오류:
   • 이미지 이름 또는 태그가 잘못되어 해당 이미지를 찾을 수 없을 수 있습니다. 예를 들어, 레지스트리 URL, 이미지 이름, 태그가 정확하지 않으면 Kubernetes는 이미지를 찾을 수 없습니다.
2. 이미지 레지스트리 인증 실패:
   • Azure Container Registry(Azure ACR)와 같은 프라이빗 레지스트리에서 이미지를 풀 때, 인증이 필요한 경우 인증 정보가 부족하거나 잘못된 경우 발생할 수 있습니다. 이 경우 Kubernetes는 이미지를 가져오지 못하고 Back-off 상태에 빠집니다.
3. 이미지 레지스트리의 네트워크 문제:
   • 네트워크 문제로 인해 Kubernetes가 레지스트리와 통신할 수 없거나, 이미지 레지스트리에 문제가 있을 수 있습니다. 예를 들어, 레지스트리가 다운되었거나 네트워크 연결이 불안정한 경우입니다.
4. 이미지가 존재하지 않거나 태그가 없거나 잘못됨:
   • 레지스트리에 해당 이미지와 태그가 존재하지 않으면 Kubernetes는 이미지를 가져올 수 없습니다. latest 태그가 존재하지 않거나, 오타가 있을 수 있습니다.
5. 이미지 풀 속도 제한:
   • Azure ACR에서 이미지 풀 요청이 제한되었을 경우, Kubernetes가 이미지를 가져오는 데 실패할 수 있습니다. 특히 대규모 클러스터에서 많은 요청이 한 번에 일어나면 일시적인 속도 제한이 발생할 수 있습니다.