인증이 필요한 Registry인데 로그인 정보가 없거나 만료된 상태 이슈 Get "https://abc.com/v2/": ... connection reset by peer

 

상황 요약

• 실행: docker compose pull
• 오류: Get "https://abc.com/v2/": ... connection reset by peer
• 겉으로는 “네트워크 연결이 강제로 끊김”처럼 보였지만,
• 실제 원인: Registry 로그인 세션 만료/미로그인/자격증명 문제

원인 정리 (핵심)

• docker compose pull은 내부적으로 Registry의 /v2/ 엔드포인트로 접속해서 이미지 목록/레이어를 받는데,
• 인증이 필요한 Registry인데 로그인 정보가 없거나 만료된 상태면,
• 환경에 따라 401 Unauthorized가 아니라 TLS 연결 리셋(connection reset) 형태로 보일 수 있음(특히 보안 게이트웨이/프록시/특정 Registry 설정).

해결 방법 (이번 케이스에서 정답)

1. Registry 재로그인

docker login abc.com

1. 다시 pull

docker compose pull

재발 방지 팁

• 배포 서버에서 주기적으로 로그인 세션이 끊기는 환경이면:
  • 배포 스크립트/CI 단계에 docker login을 포함
  • 혹은 credential store(자격증명 저장 방식) 설정 점검
• 서버가 여러 계정/사용자(appuser/root)로 작업한다면:
  • 어떤 사용자로 로그인했는지가 중요합니다. (~/.docker/config.json이 사용자별로 다름)