01
첫 슬래시 앞의 의미를 확인
슬래시가 있을 때만 첫 요소의 점, 콜론, 대문자 또는 localhost를 레지스트리 판별에 사용합니다. 슬래시 없이 localhost만 입력하면 Docker Hub의 저장소 이름입니다. 따라서 짧은 이름과 호스트 주소를 같은 방식으로 해석하면 안 됩니다.
Docker & Containers
Docker 이미지 이름 분석참조 대상과 선택 기준을 확인하세요
이미지 참조 하나를 분석하거나 필드에서 조합하세요. 기본값과 다이제스트 우선순위를 확인한 뒤 결과를 복사할 수 있습니다.
Docker 이미지 이름 분석
참조 또는 필드
참조는 이 브라우저에서만 처리됩니다. 레지스트리 조회, 업로드, Docker daemon 연결은 하지 않습니다.
분석 결과
참조 또는 저장소 경로를 입력하세요.
입력 모드와 예제
모드별 초안을 따로 보관합니다. 레지스트리를 비우면 Docker Hub를 사용합니다. 저장소에는 전체 경로를 넣고 호스트는 host:5000처럼 명확히 지정하세요.
참조 1개, 최대 4,096자. 저장소 경로 255자, 태그 128자. sha256/384/512의 전체 소문자 16진수 다이제스트를 지원합니다.
최신 입력을 분석하기 위해 기다리는 중…
Docker 이미지 이름 분석은 배포가 예상과 다른 저장소로 향할 때 원인을 찾는 데 도움이 됩니다. registry.example.com:5000/team/api:v2에서 첫 번째 콜론은 포트이고 두 번째 콜론은 태그입니다. 콜론 하나만 기준으로 나누면 이 차이를 놓칩니다.
짧은 이름과 사설 레지스트리 예제를 비교하면 생략했던 값이 드러납니다. 원문을 바꾸지 않고 저장소 경로와 콘텐츠 선택 정보를 따로 표시하므로 누락된 호스트나 의도하지 않은 latest를 검토할 수 있습니다.
Docker 이미지 이름 분석이 필요한 이유
생략된 기본값을 눈으로 확인
Docker 이미지 이름 분석은 nginx를 docker.io/library/nginx:latest로 펼치고 추가한 값에 표시를 붙입니다. 사설 레지스트리에는 library를 임의로 넣지 않아 원래 저장소 경로를 유지합니다. 설정에 붙여 넣기 전에 목적지를 다시 확인할 수 있습니다.
태그 정보와 콘텐츠 선택을 구분
이미지 태그와 이미지 다이제스트가 함께 있어도 정규화 결과에는 둘 다 남습니다. 별도의 유효 참조는 다이제스트로 선택하는 대상을 보여 줍니다. 태그가 표시된다는 이유만으로 해당 태그와 다이제스트의 일치가 검증되었다고 해석하지 않도록 구분합니다.
구분자와 기본값을 확인하는 순서
02
모드마다 보관되는 초안을 활용
필드 모드로 전환해도 문자열 초안은 유지됩니다. 저장소 경로에는 네임스페이스를 포함하되 :tag와 @digest는 전용 필드에 넣으세요. 레지스트리를 비워 두면 Docker Hub를 선택하므로 사설 서버를 의도했다면 반드시 확인하세요.
03
현재 입력에 대한 결과인지 확인
자동 분석은 편집을 멈춘 뒤 350ms 후에 실행됩니다. 끄면 실행 버튼이 보이며 Ctrl/Cmd + Enter도 사용할 수 있습니다. 예제와 비우기는 미리보기를 거쳐 적용하고 한 번의 실행 취소로 입력과 결과를 함께 복원합니다.
호스트부터 콘텐츠 선택자까지 분리
Docker Hub 축약 이름 해석
각 조건에 따라 docker.io, library, latest를 추가하고 index.docker.io를 정규화합니다. 이미지 이름과 네임스페이스가 포함된 경로는 소문자여야 하지만 태그는 대소문자를 유지합니다. 잘못된 경로를 자동으로 고쳐 다른 목적지를 감추지 않습니다.
구성 요소별 구문 검사
호스트 이름과 숫자 포트, 대괄호로 묶인 순수 IPv6 레지스트리를 지원합니다. 경로 구분자, 태그 문자와 해시 길이를 별도로 검사합니다. 짧거나 잘못된 다이제스트가 버전 태그인 것처럼 통과하지 않으며 여러 참조를 한 문자열로 섞어 처리하지도 않습니다.
동일한 규칙으로 조합하고 내보내기
레지스트리, 저장소, 태그와 다이제스트를 조합한 뒤 정규화 참조나 유효 참조를 복사할 수 있습니다. JSON에는 분리된 필드와 기본값 표시가 포함됩니다. 입력 또는 모드를 바꾸면 이전 결과 내보내기가 즉시 중지되고 현재 초안이 성공해야 다시 활성화됩니다.
구문 검사로 알 수 없는 정보
- 이미지와 서버의 실제 상태는 조회하지 않음
- 레지스트리, 권한, manifest, 아키텍처, 서명, 취약점은 검사하지 않습니다. 여기서 조합은 참조 문자열을 만드는 작업입니다. Docker 이미지 파일을 빌드하거나 이미지를 내려받고 실행하거나 푸시하는 작업은 수행하지 않습니다.
- 태그와 다이제스트를 서로 계산하지 않음
- 둘 다 없을 때만 latest를 추가합니다. 다이제스트가 있으면 태그보다 우선하지만 두 값이 같은 이미지를 가리킨다는 보장은 없습니다. 태그를 조회해 다이제스트를 구하거나 manifest 내용을 해싱하는 기능도 없습니다.
- 이름이 있는 참조 하나만 입력
- Dockerfile, Compose, Kubernetes 문서, URL, 명령, 이미지 아카이브나 목록에서 값을 추출하지 않습니다. 바깥쪽 공백은 제거하지만 내부 공백, 인증 정보, 미확장 변수는 거부합니다. 단독 이미지 ID에서 저장소 이름을 추측하지 않습니다.
- 문자 수와 알고리즘의 범위
- 현재 입력은 최대 4,096자, 정규화된 저장소 경로는 255자, 태그는 지정된 ASCII 문자로 1~128자입니다. 태그는 점이나 하이픈으로 시작하지 않습니다. sha256/384/512의 전체 소문자 16진수만 허용하며 IPv6 영역 식별자와 점이 포함된 IPv4 혼합 표기는 제외합니다. 숫자 포트가 유효한 서비스인지는 확인하지 않습니다.
Docker 이미지 이름 분석 질문
Docker에서 repository name must be lowercase 오류가 발생하는 이유는 무엇인가요?
저장소 경로 요소는 소문자여야 하지만 태그에는 대문자가 들어갈 수 있습니다. 태그 앞의 네임스페이스와 이름을 먼저 살펴보고 명령이나 변수가 섞이지 않았는지 확인하세요. 이 도구는 오타를 감출 수 있는 자동 소문자 변환 대신 오류를 표시합니다.
태그와 다이제스트를 함께 지정하면 두 값이 일치하는지 확인하나요?
일치 검사를 전제로 사용하면 안 됩니다. 두 값이 함께 있으면 다이제스트가 선택 기준입니다. 정규화 결과에는 태그를 보관하고 유효 참조에서는 뺍니다. 같은 이미지인지 증명해야 한다면 실제 레지스트리 메타데이터를 따로 확인해야 합니다.
latest 태그가 실제로 가리키는 버전은 어떻게 확인하나요?
latest는 관리자가 지정하는 태그이며 가장 큰 버전 번호를 자동 계산하는 명령이 아닙니다. 대상은 바뀔 수 있습니다. 이 페이지는 태그를 문자 그대로 보여 주고 현재 대상을 조회하지 않으므로 실제 버전은 레지스트리에서 확인하세요.
로컬 레지스트리 대신 docker.io로 접근하는 이유는 무엇인가요?
registry/api의 첫 부분은 소문자이며 점이나 포트가 없어 네임스페이스로 해석됩니다. registry:5000/api나 실제 도메인 주소가 필요한지 확인하세요. 필드 조합에서는 이러한 모호한 레지스트리를 거부하여 잘못된 Docker Hub 대상이 생성되지 않도록 합니다.
Docker 이미지 ID와 다이제스트는 어떻게 다른가요?
로컬 이미지 ID는 이미지 구성 콘텐츠를 식별하고 레지스트리 다이제스트는 manifest 또는 이미지 인덱스를 식별할 수 있습니다. 두 해시는 일반적으로 서로 대체할 수 없습니다. 저장소 이름 뒤에 @와 해당 레지스트리 다이제스트를 넣어야 하며 여기서 하나를 다른 값으로 변환할 수는 없습니다.
더 궁금한 점이 있나요?