Docker Hub 문제 해결
Docker Hub 문제 해결 (Troubleshoot Docker Hub)
Docker Hub에서 발생할 수 있는 풀 rate limit과 429, 500 오류를 해결하는 방법을 배워볼게요.
출처: 문서
본문
Docker Hub에서 문제가 발생하면 다음 해결책을 참고해요.
풀 rate limit 도달 (429 응답 코드)
오류 메시지
이 문제가 발생하면 Docker CLI나 Docker Engine 로그에서 다음 오류 메시지를 받게 돼요:
You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limits
가능한 원인
- 인증된 Docker Personal 사용자로서 풀 rate limit에 도달했어요.
- IPv4 주소 또는 IPv6 /64 서브넷을 기준으로 비인증 사용자로서 풀 rate limit에 도달했어요.
해결 방법
다음 중 하나를 사용할 수 있어요:
- Docker 계정을 인증 하거나 업그레이드 해요.
- 풀 rate limit 을 확인하고, rate limit이 낮아질 때까지 기다린 뒤 다시 시도해요.
요청이 너무 많음 (Too many requests, 429 응답 코드)
오류 메시지
이 문제가 발생하면 Docker CLI나 Docker Engine 로그에서 다음 오류 메시지를 받게 돼요:
Too Many Requests
가능한 원인
- Abuse rate limit 에 도달했어요.
해결 방법
- Docker Hub에 접근하는 고장난 CI/CD 파이프라인이 있는지 확인하고 수정해요.
- 자동 스크립트에 back-off 재시도(재시도 지연) 솔루션을 구현해 분당 수천 건의 요청을 다시 보내지 않도록 해요.
500 응답 코드
오류 메시지
이 문제가 발생하면 Docker CLI나 Docker Engine 로그에서 다음 오류 메시지가 흔히 나타나요:
Unexpected status code 500
가능한 원인
- 일시적인 Docker Hub 서비스 문제가 있어요.
해결 방법
- Docker System Status Page 를 확인해 모든 서비스가 정상 작동 중인지 확인해요.
- Docker Hub에 다시 접근해 보세요. 일시적인 문제일 수 있어요.
- 문제를 신고하려면 Docker Support 에 연락해요.