Jak naprawić błąd „Docker: nieprawidłowy format odniesienia”

Docker ułatwia budowanie, uruchamianie i zarządzanie kontenerami. Jednak podczas uruchamiania lub budowania obrazu może wystąpić błąd „Nieprawidłowy format odniesienia”. W większości przypadków przyczyną jest drobny błąd formatowania nazwy lub tagu obrazu. Na przykład błąd może wynikać z użycia wielkich liter, znaków specjalnych lub brakujących wartości. Ten przewodnik wyjaśni najczęstsze przyczyny tego błędu i sposoby jego rozwiązania, aby zapobiec jego ponownemu wystąpieniu.

Napraw błąd „Nieprawidłowy format odniesienia”

Poznajmy najczęstsze przyczyny błędu „Nieprawidłowy format odniesienia” i dowiedzmy się, jak go naprawić:

Wielkie litery w nazwach obrazów

Docker wymaga, aby nazwy obrazów były pisane małymi literami. Nawet jedna wielka litera może spowodować błędy formatowania. Na przykład uruchomienie poniższego polecenia spowoduje błąd:

docker pull NGINX

Jak naprawić błąd „Docker: nieprawidłowy format odniesienia” — Nazwy archiwów muszą być pisane małymi literami

Aby uniknąć tego błędu, zawsze przed uruchomieniem polecenia sprawdź, czy nazwa obrazu jest zapisana małymi literami.

docker pull nginx

Znak specjalny lub nieprawidłowy

Czasami użytkownicy przypadkowo dodają znaki niedozwolone przez Dockera. Należą do nich znaki @, spacje lub znaki skopiowane ze strony internetowej lub dokumentu, które wyglądają normalnie, ale takie nie są.

Na przykład poniższe polecenie zawiera znak specjalny @, który spowoduje następujący błąd:

docker run ubuntu@:latest

Aby naprawić ten błąd, upewnij się, że w poleceniu nie ma zbędnych znaków ani błędów formatowania. Możesz użyć edytora tekstu, aby sprawdzić i poprawić polecenie (w razie potrzeby):

docker run ubuntu:latest

Dwukropek bez znacznika

Jednym z najczęstszych błędów jest dodanie dwukropka na końcu nazwy obrazu bez dodania tagu. Na przykład, spróbujmy następującego polecenia, aby pobrać Node:

docker pull node:

Docker oczekuje wartości po dwukropku, takiej jak latest, 18-alpine lub dowolnego innego prawidłowego znacznika. W przypadku braku wartości nazwa obrazu zostanie uznana za niekompletną i spowoduje błąd „Nieprawidłowy format odniesienia”:

Aby naprawić ten błąd, dodaj odpowiedni tag po dwukropku, aby nazwa obrazu była pełna i prawidłowa:

docker pull node:latest

Ścieżka pliku lub miejsce zamontowania woluminu zawiera spacje

Jeśli ścieżka do pliku zawiera spacje, zwłaszcza z opcjami takimi jak -v (montowanie woluminu), Docker może błędnie zinterpretować części ścieżki jako osobne argumenty lub nawet jako część nazwy obrazu. W rezultacie mogą wystąpić nieoczekiwane rezultaty, takie jak te pokazane poniżej:

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

Aby tego uniknąć, zawsze umieszczaj ścieżkę dostępu do pliku w cudzysłowie, używając spacji, jak pokazano poniżej:

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

Zastąp „/home/user/My Folder” rzeczywistą ścieżką do katalogu, który chcesz zamontować w kontenerze.

Niewłaściwe użycie zmiennych

Podczas pracy z Dockerem często używa się zmiennych w poleceniach, zwłaszcza przy określaniu wersji obrazu. Jeśli jednak zmienna, taka jak $VERSION, nie jest poprawnie ustawiona, Docker może napotkać problemy, takie jak błąd „Nieprawidłowy format odniesienia”.

Na przykład uruchom następujące polecenie, aby pobrać Ubuntu z Docker Hub:

docker pull ubuntu:$VERSION

W tym przypadku zmienna $VERSION powinna reprezentować wersję obrazu Ubuntu, którą chcesz pobrać. Jeśli jednak nie przypiszesz jej wartości, Docker zinterpretuje polecenie jako „docker pull ubuntu:”. W rezultacie nazwa obrazu będzie nieprawidłowa, ponieważ kończy się dwukropkiem i nie zawiera wymaganego znacznika wersji.

Aby tego uniknąć, upewnij się, że wszystkie zmienne użyte w poleceniu są poprawnie zdefiniowane. W systemie Linux możesz ustawić zmienną, używając następującej składni.

$VERSION=latest

Następnie pobierz określoną wersję, wykonując następujące polecenie.

docker pull ubuntu:$VERSION

W wierszu poleceń CMD systemu Windows należy użyć słowa kluczowego set, aby zdefiniować zmienną (np. version), a następnie użyć składni %VARIABLE%, aby odwołać się do niej w poleceniach, takich jak docker pull.

set VERSION=latest
docker pull ubuntu:%VERSION%

W tym przypadku $VERSION przechowuje najnowszą wartość, więc Docker bez problemu pobiera obraz ubuntu:latest . W razie potrzeby można również przypisać konkretną wersję, na przykład 18.04.

Problem z kopiowaniem i wklejaniem

Czasami użytkownicy kopiują polecenia z samouczków online lub dokumentacji. Te skopiowane polecenia mogą zawierać ukryte znaki, takie jak niewidoczne spacje, znaki interpunkcyjne inne niż angielskie lub cudzysłowy. Znaki te mogą dyskretnie uszkodzić polecenia Dockera.

Aby tego uniknąć, lepiej jest wpisać polecenie ręcznie, o ile to możliwe, lub najpierw wkleić je do edytora zwykłego tekstu, aby usunąć niepożądane formatowanie.

Teraz, gdy znasz już najczęstsze przyczyny błędu „Nieprawidłowy format referencji” w Dockerze i wiesz, jak go naprawić, będziesz na dobrej drodze do uniknięcia tego problemu w przyszłości. Od sprawdzania kapitalizacji po upewnienie się, że zmienne są poprawnie ustawione – te proste wskazówki mogą zaoszczędzić Ci mnóstwo czasu i nerwów. Jeśli chcesz dowiedzieć się więcej, możesz również dowiedzieć się, jak tagować i przesyłać niestandardowe obrazy Dockera do rejestru, a także jak czyścić nieużywane obrazy, aby utrzymać system w czystości.

Tags: #System

Jak wyświetlić zegar na ekranie systemu Windows 11

Oprócz wyświetlania zegara na pasku zadań w systemie Windows 11 można ustawić wyświetlanie zegara na ekranie komputera.

Jak naprawić błąd płyty głównej pokazujący czerwone światło

Straszne jest, gdy na płycie głównej świeci się czerwona dioda, a system nie chce się uruchomić, zwłaszcza jeśli płyta główna nie chce wyjaśnić, dlaczego dioda się świeci.

Podsumowanie kilku prostych sposobów wyłączania portów USB w komputerach z systemem Windows

Odblokowanie portów USB w BIOS-ie nie jest trudne. Ale jak zablokować porty USB w komputerze? Dowiedzmy się z Quantrimang.com!

Jak naprawić błąd „Bad System Config Info” w systemie Windows 10

Błędne informacje o konfiguracji systemu to częsty błąd sprawdzania błędów w systemach Windows 10. Przyjrzyjmy się rozwiązaniom, które rozwiążą ten problem.

Jak odwrócić kolory ekranu za pomocą Lupy w systemie Windows 11

Funkcja odwrócenia lupy w systemie Windows 11 może poprawić czytelność tekstu, zwłaszcza w przypadku osób wrażliwych na światło.

Włącz XMP, aby zoptymalizować prędkość pamięci RAM

Jeśli zamierzasz zbudować własny system komputerowy i zdecydujesz się zainwestować w szybką pamięć RAM, w jaki sposób możesz mieć pewność, że pamięć RAM będzie działać z deklarowaną prędkością?

10 ustawień systemu Windows, których nigdy nie należy pozostawiać domyślnych

W systemie Windows zabezpieczenia nie są domyślnie skonfigurowane, co oznacza, że trzeba zmienić pewne domyślne ustawienia.

6 najlepszych darmowych dostawców dynamicznego DNS

Dynamiczny DNS (znany również jako DDNS lub DynDNS) to usługa mapowania nazwy domeny internetowej na komputer z dynamicznym adresem IP. Większość komputerów łączy się z routerem za pośrednictwem protokołu DHCP, co oznacza, że router losowo przypisuje komputerowi adres IP.

Jak zwolnić 48 GB na komputerze z systemem Windows 11 bez utraty ważnych danych

Istnieje wiele sposobów na odzyskanie miejsca bez konieczności usuwania plików osobistych — są to pliki tymczasowe, nieaktualne kopie zapasowe, zduplikowane dane i nieużywane aplikacje.

Sprawdź MD5 i SHA1, aby sprawdzić integralność pliku

Użyjemy specjalistycznego programu do sprawdzenia kodów MD5 i SHA1 pliku, aby sprawdzić, czy nie ma w nim błędów. Oprogramowanie do sprawdzania MD5 HashCalc to jedno z najprzydatniejszych narzędzi do sprawdzania kodów MD5 i SHA1.

7 sprytnych sposobów na korzystanie z monitora bez komputera

Myśląc o monitorze, wyobrażasz sobie go podłączonego do komputera stacjonarnego lub laptopa. Jednak w rzeczywistości monitor ten może współpracować z wieloma innymi urządzeniami.

Dlaczego na dysku znajduje się ikona kłódki i jak ją usunąć?

Zastanawiasz się, dlaczego na dysku w Eksploratorze plików pojawia się ikona kłódki? Ten artykuł wyjaśnia, co to jest i jak usunąć ikonę kłódki z dysku w systemie Windows 10.

Jak zmienić format liczb w systemie Windows 11

Formaty liczb określają sposób wyświetlania liczb, w tym wybór separatora dziesiętnego (takiego jak kropka lub przecinek) i separatora tysięcy. Oto jak zmienić format liczb w systemie Windows 11.

Jak sprawdzić historię komputera, aby dowiedzieć się, czy ktoś miał do niego dostęp i z niego korzystał?

Jeśli podejrzewasz, że ktoś uzyskuje dostęp do Twojego komputera i korzysta z niego bez Twojej zgody, możesz zastosować poniższe sztuczki, aby sprawdzić historię włączania i wyłączania komputera oraz przejrzeć ostatnie działania na komputerze, aby się o tym przekonać.