현재 Docker Hub에 장애가 있나요?

Docker Hub 가용성 이해하기

Docker Hub의 가용성은 hub.docker.com 웹사이트만을 의미하지 않습니다. 장애가 repository 탐색, 인증 또는 이미지 pull에 각각 다르게 영향을 줄 수 있습니다. 따라서 로그인이나 이미지 pull이 한 번 실패했다고 해서 Docker Hub 전체 플랫폼에 장애가 발생했다고 단정할 수는 없습니다.

보고된 incident와 서비스 성능 저하 여부는 공식 Docker 상태 페이지에서 확인하세요. incident가 표시되지 않는다면 브라우저 접속과 Docker client 동작을 비교하고, 가능하면 다른 네트워크에서도 테스트하세요. 이러한 비교를 통해 Docker Hub incident와 계정, repository, image reference, DNS, proxy, firewall, certificate 또는 로컬 Docker 설정 문제를 구분하는 데 도움이 됩니다.

정확한 오류는 유용한 근거입니다.

• 인증 또는 권한 메시지는 일반적으로 자격 증명이나 repository 접근 권한 문제를 가리킵니다.
• 이미지 이름 또는 tag 오류는 일반적으로 요청한 image reference 문제를 가리킵니다.
• DNS, timeout, connection refused 및 certificate 오류는 일반적으로 연결 또는 로컬 client 경로 문제를 가리킵니다.
• HTTP 5xx 응답은 일시적일 수 있지만, 공식 상태 페이지 및 문제 발생 범위와 함께 비교해야 합니다.

Docker Hub 문제 해결

1. 서비스 incident 확인

공식 Docker 상태 페이지를 열고 활성 incident 또는 성능이 저하된 component가 있는지 확인하세요. incident가 표시된다면 command output과 오류 문구를 저장한 후, 여러 로컬 설정을 한꺼번에 변경하기보다 복구가 보고된 뒤 다시 시도하세요.

incident가 표시되지 않는다면 아래 확인을 계속 진행하세요. 정상 상태 보고가 있다고 해서 특정 계정, repository, 브라우저, Docker client 또는 네트워크 문제까지 배제되는 것은 아닙니다.

2. 웹사이트 접속과 Docker client 접속 비교

• hub.docker.com이 로드되지 않는다면 다른 브라우저나 네트워크를 사용해 보세요. 이를 통해 브라우저, DNS, VPN, firewall 또는 연결 문제와 더 광범위한 도달성 문제를 구분하는 데 도움이 됩니다.
• 웹사이트는 로드되지만 docker pull 또는 인증이 실패한다면 Docker client 경로, 자격 증명, repository 권한, 이미지 이름, tag, proxy 및 certificate 설정을 확인하세요.
• 하나의 repository 또는 tag만 실패한다면 image reference와 계정의 접근 권한을 확인하세요. 단일 이미지 요청 실패만으로 Docker Hub를 사용할 수 없다고 판단할 수는 없습니다.

3. 브라우저 및 계정 원인 확인

웹사이트 로그인 또는 session 문제라면 private browsing 창을 사용하고, 요청을 수정하는 확장 프로그램을 일시적으로 비활성화한 후 다시 로그인하세요. 여러 브라우저와 네트워크에서 동일한 계정 전용 오류가 계속 발생한다면 브라우저 데이터를 반복해서 삭제하기보다 해당 메시지를 바탕으로 자격 증명 또는 권한 문제를 확인하세요.

4. DNS, 네트워크, proxy 및 firewall 원인 확인

DNS failure, connection timeout 또는 connection refused로 인해 서비스가 정상적으로 작동하는 동안에도 Docker Hub가 차단될 수 있습니다. 문제가 발생한 장치에서 이름 해석과 연결을 테스트하고, corporate proxy, VPN, firewall 또는 TLS-inspecting gateway가 Docker traffic을 차단하고 있는지 확인하세요. 가능하면 다른 네트워크와 비교하세요.

관련 증상은 [DNS resolution 실패](/guides/dns-probe-finished-bad-config), [connection timeout](/guides/err-connection-timed-out) 및 [connection refused](/guides/err-connection-refused)를 참조하세요.

5. Docker client 오류 해석

작업을 반복하기 전에 전체 오류를 기록하세요. 인증 또는 권한 메시지는 계정이나 repository 문제를 시사하고, 이름 또는 tag 메시지는 image reference 문제를 시사하며, 네트워크 및 certificate 메시지는 연결 또는 로컬 Docker 설정 문제를 시사합니다.

HTTP 500, 502, 503 또는 504 응답은 공식 상태 페이지의 정보와 비교하고 관련 안내를 확인하세요.

• [HTTP 500 Internal Server Error](/guides/http-500-internal-server-error)
• [HTTP 502 Bad Gateway](/guides/http-502-bad-gateway)
• [HTTP 503 Service Unavailable](/guides/http-503-service-unavailable)
• [HTTP 504 Gateway Timeout](/guides/http-504-gateway-timeout)