Docker: 잘못된 참조 형식 오류를 수정하는 방법

Docker를 사용하면 컨테이너를 쉽게 빌드, 실행 및 관리할 수 있습니다. 하지만 이미지를 실행하거나 빌드할 때 "잘못된 참조 형식" 오류가 발생할 수 있습니다. 대부분의 경우 이미지 이름이나 태그의 사소한 형식 오류로 인해 발생합니다. 예를 들어 대문자, 특수 문자 또는 누락된 값이 원인일 수 있습니다. 이 가이드에서는 이 오류의 일반적인 원인과 재발 방지를 위한 해결 방법을 설명합니다.

"잘못된 참조 형식" 오류 수정

"잘못된 참조 형식" 오류의 가장 일반적인 원인과 해결 방법을 알아보겠습니다.

이미지 이름의 대문자

Docker에서는 이미지 이름을 소문자로 사용해야 합니다. 대문자가 하나라도 입력되면 형식 오류가 발생할 수 있습니다. 예를 들어, 다음 명령을 실행하면 오류가 발생합니다.

docker pull NGINX
"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
아카이브 이름은 소문자여야 합니다.

이 오류를 방지하려면 명령을 실행하기 전에 이미지 이름이 소문자인지 항상 두 번 확인하세요.

docker pull nginx
"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
소문자를 사용하세요

특수 문자 또는 잘못된 문자

사용자가 Docker에서 허용하지 않는 문자를 실수로 추가하는 경우가 있습니다. 여기에는 @ 기호, 공백, 웹사이트나 문서에서 복사한 문자 등이 포함되는데, 겉보기에는 정상이지만 실제로는 정상이 아닙니다.

예를 들어, 다음 명령에는 특수 문자 @가 포함되어 있어 다음과 같은 오류가 발생합니다.

docker run ubuntu@:latest
"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
특수문자 오류

이 오류를 해결하려면 명령에 불필요한 문자나 서식 문제가 없는지 확인하세요. 필요한 경우 일반 텍스트 편집기를 사용하여 명령을 확인하고 정리할 수 있습니다.

docker run ubuntu:latest
"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
특수문자는 피하세요

태그 없는 콜론

가장 흔한 실수 중 하나는 이미지 이름 끝에 콜론을 넣고 태그를 포함하지 않는 것입니다. 예를 들어, 다음 명령을 사용하여 Node.js를 가져오는 방법을 살펴보겠습니다.

docker pull node:

Docker는 콜론 뒤에 latest , 18-alpine 또는 기타 유효한 태그와 같은 값을 기대합니다. 값을 제공하지 않으면 이미지 이름이 불완전한 것으로 간주되어 "잘못된 참조 형식" 오류가 발생합니다.

"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
태그 없는 콜론

이 오류를 해결하려면 콜론 뒤에 적절한 태그를 추가하여 이미지 이름을 완전하고 유효하게 만드세요.

docker pull node:latest
"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
콜론 뒤에 태그를 추가합니다.

파일 경로 또는 볼륨 마운트에 공백이 포함되어 있습니다.

공백이 포함된 파일 경로를 포함할 때, 특히 -v(볼륨 마운트)와 같은 옵션을 사용할 경우, Docker가 경로의 일부를 별도의 인수 또는 이미지 이름의 일부로 잘못 해석할 수 있습니다. 결과적으로 아래와 같은 예상치 못한 결과가 발생할 수 있습니다.

docker run -v /home/user/My Folder:/app ubuntu
"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
파일 이름의 공백

이를 방지하려면 아래와 같이 파일 경로를 항상 공백과 큰따옴표로 묶어야 합니다.

docker run -v "/home/user/My Folder:/app" ubuntu

"/home/user/My Folder"를 컨테이너에 마운트하려는 디렉토리의 실제 경로로 바꾸세요 .

변수의 부적절한 사용

Docker를 사용할 때, 특히 이미지 버전을 지정할 때 명령에 변수를 사용하는 것이 일반적입니다. 하지만 $VERSION과 같은 변수가 올바르게 설정되지 않으면 Docker에서 "잘못된 참조 형식" 오류와 같은 문제가 발생할 수 있습니다.

예를 들어, Docker Hub에서 Ubuntu를 가져오려면 다음 명령을 실행하세요.

docker pull ubuntu:$VERSION

여기서 $VERSION은 가져오려는 Ubuntu 이미지의 버전을 나타냅니다. 하지만 값을 지정하지 않으면 Docker는 명령을 "docker pull ubuntu:"로 해석합니다. 따라서 이미지 이름이 콜론으로 끝나고 필수 버전 태그가 없으므로 잘못된 이미지 이름이 생성됩니다.

"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
변수의 잘못된 사용

이를 방지하려면 명령에 사용된 모든 변수가 올바르게 정의되어 있는지 확인하세요. Linux에서는 다음 구문을 사용하여 변수를 설정할 수 있습니다.

$VERSION=latest

그런 다음 다음 명령을 실행하여 지정된 버전을 가져옵니다.

docker pull ubuntu:$VERSION

Windows CMD에서는 set 키워드를 사용하여 변수(예: version)를 정의한 다음, %VARIABLE% 구문을 사용하여 docker pull과 같은 명령에서 해당 변수를 참조해야 합니다.

set VERSION=latest
docker pull ubuntu:%VERSION%

여기서 $VERSION은 최신 값을 저장하므로 Docker는 문제없이 ubuntu:latest 이미지를 가져옵니다 . 필요한 경우 18.04와 같은 특정 버전을 지정할 수도 있습니다.

"Docker: 잘못된 참조 형식" 오류를 수정하는 방법
변수를 올바르게 정의하세요

복사 및 붙여넣기 문제

사용자가 온라인 튜토리얼이나 문서에서 명령어를 복사하는 경우가 있습니다. 이렇게 복사된 명령어에는 보이지 않는 공백, 영어가 아닌 구두점, 특수 따옴표 등 숨겨진 문자가 포함될 수 있습니다. 이러한 문자는 Docker 명령어를 의도치 않게 손상시킬 수 있습니다.

이를 방지하려면 가능하다면 명령을 직접 입력하거나 일반 텍스트 편집기에 명령을 붙여넣어 원치 않는 서식을 제거하는 것이 좋습니다.

이제 Docker에서 "잘못된 참조 형식" 오류의 일반적인 원인과 해결 방법을 알았으니 앞으로 이 문제를 방지하는 데 큰 도움이 될 것입니다. 대소문자 확인부터 변수 설정까지, 이 간단한 팁들을 활용하면 많은 시간과 번거로움을 줄일 수 있습니다. 더 자세히 알아보고 싶다면, 사용자 지정 Docker 이미지에 태그를 지정하고 레지스트리에 푸시하는 방법이나 사용하지 않는 이미지를 정리하여 시스템을 깔끔하게 유지하는 방법도 알아보세요.

댓글 남기기

Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

Nextcloud 업로드 설정, iOS 권한, 배터리 모드 및 iPhone 백그라운드 예약 기능의 제한 사항을 확인하여 백그라운드 사진 감지 기능을 복원하세요.

ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

ONLYOFFICE의 글꼴 힌팅 모드를 비교하고, 확대/축소 및 Linux 글꼴 사용 가능 여부를 확인하고, 흐림 효과가 편집기에만 적용되는지 아니면 데스크톱 전체에 영향을 미치는지 검증하십시오.

ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

ONLYOFFICE 데스크톱 편집기에서 PDF를 로컬로 변환한 다음 DOCX 파일을 검토하여 레이아웃 변경 사항, 스캔한 페이지 및 수정이 필요한 텍스트를 확인하십시오.

ONLYOFFICE 데스크톱 편집기를 ownCloud 파일에 연결하세요

ONLYOFFICE 데스크톱 편집기에 ownCloud 계정을 추가하고, 연결을 통해 얻을 수 있는 이점을 이해한 다음, 직접 액세스, 동기화 및 브라우저 편집 중에서 선택하세요.

ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

올바른 포털 또는 WebDAV 주소를 사용하고, 휴대폰에서 HTTPS 연결 가능 여부를 테스트하고, 사설 네트워크, TLS 및 로그인 문제를 구분하십시오.

ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

ONLYOFFICE 데스크톱 편집기용 사용자 지정 플러그인을 빌드하고 테스트한 다음, 해당 .plugin 아카이브를 설치하고 디버깅을 위해 개발자 도구를 활성화합니다.

LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

Calc에서 Python 함수를 사용할 수 있도록 만들고, 열려 있는 스프레드시트에서 해당 함수를 실행하고, LibreOffice와 시스템 Python을 혼동하지 않고 누락된 매크로 또는 가져오기 문제를 해결하세요.

선택한 작성자 텍스트를 섹션 암호로 보호하세요

선택한 작성자 텍스트를 섹션 암호로 보호하세요

Writer 문서의 나머지 부분은 계속 사용할 수 있도록 유지하면서 특정 구절에 대한 일반적인 편집을 차단하는 방법과 파일 암호화가 더 나은 선택인 경우를 알아보세요.

LibreOffice Calc 다크 모드에서 스프레드시트 텍스트를 읽기 쉽게 만들기

LibreOffice Calc 다크 모드에서 스프레드시트 텍스트를 읽기 쉽게 만들기

Calc에서 테마, 셀 글꼴 색상, 채우기 및 조건부 서식을 확인하여 잘 보이지 않는 스프레드시트 텍스트를 수정하세요.

LibreOffice Calc에서 수식이 텍스트로 표시되나요? 결과 복원하기

LibreOffice Calc에서 수식이 텍스트로 표시되나요? 결과 복원하기

Calc에서 계산된 값 대신 수식 텍스트가 표시되는 이유를 알아보고, 표시 모드, 텍스트 서식 셀, 작은따옴표 또는 오래된 결과 문제를 해결하세요.