Cum se remediază eroarea „Docker: Format de referință nevalid”

Docker facilitează construirea, rularea și gestionarea containerelor. Cu toate acestea, este posibil să întâmpinați o eroare „Format de referință nevalid” atunci când rulați sau construiți o imagine. În majoritatea cazurilor, aceasta se datorează unei erori minore de formatare în numele sau eticheta imaginii. De exemplu, eroarea ar putea fi cauzată de litere majuscule, caractere speciale sau valori lipsă. Acest ghid va explica cauzele frecvente ale acestei erori și cum să o remediați pentru a preveni repetarea ei.

Remediați eroarea „Format de referință nevalid”

Să aflăm cele mai frecvente cauze ale erorii „Format de referință nevalid” și cum să le remediem:

Litere mari în numele imaginilor

Docker necesită ca numele imaginilor să fie scrise cu litere mici. Chiar și o singură literă mare poate cauza erori de formatare. De exemplu, rularea următoarei comenzi va genera o eroare:

docker pull NGINX
Cum se remediază eroarea „Docker: Format de referință nevalid”
Numele arhivelor trebuie să fie scrise cu litere mici

Pentru a evita această eroare, verificați întotdeauna dacă numele imaginii este scris cu litere mici înainte de a executa comanda.

docker pull nginx
Cum se remediază eroarea „Docker: Format de referință nevalid”
Folosește litere mici

Caracter special sau nevalid

Uneori, utilizatorii adaugă accidental caractere pe care Docker nu le permite. Acestea includ semnele @, spațiile sau caracterele copiate de pe un site web sau un document care arată normal, dar nu sunt.

De exemplu, următoarea comandă conține caracterul special @, care va cauza următoarea eroare:

docker run ubuntu@:latest
Cum se remediază eroarea „Docker: Format de referință nevalid”
Eroare de caracter special

Pentru a remedia această eroare, asigurați-vă că nu există caractere suplimentare sau probleme de formatare în comandă. Puteți utiliza un editor de text simplu pentru a verifica și curăța comanda (dacă este necesar):

docker run ubuntu:latest
Cum se remediază eroarea „Docker: Format de referință nevalid”
Evitați caracterele speciale

Colon fără etichetă

Una dintre cele mai frecvente greșeli este să pui două puncte la sfârșitul numelui imaginii, dar să nu incluzi eticheta. De exemplu, să încercăm următoarea comandă pentru a extrage Node:

docker pull node:

Docker așteaptă o valoare după două puncte, cum ar fi latest , 18-alpine sau orice altă etichetă validă. Dacă nu este furnizată nicio valoare, numele imaginii este considerat incomplet și va cauza o eroare „Format de referință invalid”:

Cum se remediază eroarea „Docker: Format de referință nevalid”
Colon fără etichetă

Pentru a remedia această eroare, adăugați o etichetă corespunzătoare după două puncte pentru a face numele imaginii complet și valid:

docker pull node:latest
Cum se remediază eroarea „Docker: Format de referință nevalid”
Adăugați etichete după două puncte

Calea fișierului sau montarea volumului conține spații

Când includeți o cale de fișier care conține spații, în special cu opțiuni precum -v (montare volum), Docker poate interpreta greșit părți ale căii ca argumente separate sau chiar ca parte a numelui imaginii. Drept urmare, este posibil să întâmpinați rezultate neașteptate, cum ar fi cel prezentat mai jos:

docker run -v /home/user/My Folder:/app ubuntu
Cum se remediază eroarea „Docker: Format de referință nevalid”
Spațiile din numele fișierelor

Pentru a evita acest lucru, includeți întotdeauna spații în ghilimele pentru calea fișierului, așa cum se arată mai jos:

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

Înlocuiți „/home/user/My Folder” cu calea reală către directorul pe care doriți să îl montați în container.

Utilizarea necorespunzătoare a variabilelor

Când se lucrează cu Docker, este obișnuit să se utilizeze variabile în comenzi, în special atunci când se specifică versiuni de imagine. Cu toate acestea, dacă o variabilă precum $VERSION nu este setată corect, Docker poate întâmpina probleme precum eroarea „Format de referință nevalid”.

De exemplu, executați următoarea comandă pentru a extrage Ubuntu din Docker Hub:

docker pull ubuntu:$VERSION

Aici, $VERSION ar trebui să reprezinte versiunea imaginii Ubuntu pe care doriți să o extrageți. Dar dacă nu îi atribuiți o valoare, Docker va interpreta comanda ca „docker pull ubuntu:”. Aceasta va duce la un nume de imagine invalid, deoarece se termină cu două puncte și îi lipsește eticheta de versiune necesară.

Cum se remediază eroarea „Docker: Format de referință nevalid”
Utilizarea incorectă a variabilelor

Pentru a evita acest lucru, asigurați-vă că toate variabilele utilizate în comandă sunt definite corect. În Linux, puteți seta o variabilă folosind următoarea sintaxă.

$VERSION=latest

Apoi extrageți versiunea specificată executând următoarea comandă.

docker pull ubuntu:$VERSION

În Windows CMD, trebuie să utilizați cuvântul cheie set pentru a defini o variabilă (cum ar fi version), apoi să utilizați sintaxa %VARIABLE% pentru a face referire la aceasta în comenzi precum docker pull.

set VERSION=latest
docker pull ubuntu:%VERSION%

Aici, $VERSION conține cea mai recentă valoare, așa că Docker extrage imaginea ubuntu:latest fără probleme. De asemenea, puteți atribui o versiune specifică, cum ar fi 18.04, dacă este necesar.

Cum se remediază eroarea „Docker: Format de referință nevalid”
Definiți corect variabilele

Problemă de copiere și lipire

Uneori, utilizatorii copiază comenzi din tutoriale sau documentație online. Aceste comenzi copiate pot conține caractere ascunse, cum ar fi spații invizibile, punctuație care nu este în limba engleză sau ghilimele speciale. Aceste caractere pot corupe în mod silențios comenzile Docker.

Pentru a evita acest lucru, este mai bine să tastați comanda singur, atunci când este posibil, sau să o lipiți mai întâi într-un editor de text simplu pentru a elimina formatarea nedorită.

Acum că știți cauzele frecvente ale erorii „Format de referință nevalid” în Docker și cum să o remediați, veți fi pe cale să evitați această problemă în viitor. De la verificarea majusculelor până la asigurarea că variabilele sunt setate corect, aceste sfaturi simple vă pot economisi mult timp și frustrare. Dacă sunteți gata să explorați mai departe, puteți afla și cum să etichetați și să trimiteți imaginile personalizate Docker în registry sau cum să curățați imaginile neutilizate pentru a vă menține sistemul curat.

Tags: #System
Sign up and earn $1000 a day ⋙

Leave a Comment

Ce este VPN? Avantajele și dezavantajele unei rețele private virtuale VPN

Ce este VPN? Avantajele și dezavantajele unei rețele private virtuale VPN

Ce este VPN-ul, care sunt avantajele și dezavantajele VPN-ului? Haideți să discutăm cu WebTech360 despre definiția VPN-ului, cum să aplicăm acest model și sistem în muncă.

Majoritatea oamenilor nu folosesc aceste funcții ascunse în Securitate Windows.

Majoritatea oamenilor nu folosesc aceste funcții ascunse în Securitate Windows.

Securitatea Windows face mai mult decât să protejeze împotriva virușilor de bază. Protejează împotriva phishing-ului, blochează ransomware-ul și împiedică rularea aplicațiilor rău intenționate. Cu toate acestea, aceste caracteristici nu sunt ușor de observat - sunt ascunse în spatele unor straturi de meniuri.

Codarea nu este atât de dificilă pe cât crezi

Codarea nu este atât de dificilă pe cât crezi

Odată ce înveți și încerci pe cont propriu, vei descoperi că criptarea este incredibil de ușor de utilizat și incredibil de practică pentru viața de zi cu zi.

Recuperarea datelor șterse cu Recuva Portable în Windows 7

Recuperarea datelor șterse cu Recuva Portable în Windows 7

În articolul următor, vom prezenta operațiunile de bază pentru recuperarea datelor șterse în Windows 7 cu instrumentul de asistență Recuva Portable. Cu Recuva Portable, le puteți stoca pe orice stick USB convenabil și le puteți utiliza oricând este nevoie. Instrumentul este compact, simplu, ușor de utilizat și are câteva dintre următoarele caracteristici:

Cum să ștergi fișierele duplicate pentru a economisi memorie pe calculator folosind CCleaner

Cum să ștergi fișierele duplicate pentru a economisi memorie pe calculator folosind CCleaner

CCleaner scanează fișierele duplicate în doar câteva minute, apoi vă permite să decideți care dintre ele sunt sigure pentru ștergere.

De ce să schimbi locația implicită de descărcare în Windows 11?

De ce să schimbi locația implicită de descărcare în Windows 11?

Mutarea folderului Descărcări de pe unitatea C pe o altă unitate pe Windows 11 vă va ajuta să reduceți capacitatea unității C și va ajuta computerul să funcționeze mai eficient.

Cum să oprești actualizările Windows pe PC

Cum să oprești actualizările Windows pe PC

Aceasta este o modalitate de a consolida și de a ajusta sistemul, astfel încât actualizările să se producă conform programului propriu, nu al Microsoft.

Cum se afișează extensiile de fișiere, cum se vizualizează extensiile de fișiere pe Windows

Cum se afișează extensiile de fișiere, cum se vizualizează extensiile de fișiere pe Windows

Exploratorul de fișiere Windows oferă o mulțime de opțiuni pentru a schimba modul în care vizualizați fișierele. Ceea ce s-ar putea să nu știți este că o opțiune importantă este dezactivată în mod implicit, chiar dacă este crucială pentru securitatea sistemului dvs.

5 instrumente gratuite pentru a găsi spyware și adware pe PC-ul tău

5 instrumente gratuite pentru a găsi spyware și adware pe PC-ul tău

Cu instrumentele potrivite, puteți scana sistemul și elimina programele spyware, adware și alte programe rău intenționate care s-ar putea afla în sistemul dumneavoastră.

14 aplicații și software Windows de care ai nevoie pe noul tău computer

14 aplicații și software Windows de care ai nevoie pe noul tău computer

Mai jos este o listă de software recomandat la instalarea unui computer nou, astfel încât să puteți alege cele mai necesare și mai bune aplicații de pe computerul dvs.!

Cum să clonezi setările Windows pentru a-ți lua fluxul de lucru oriunde

Cum să clonezi setările Windows pentru a-ți lua fluxul de lucru oriunde

A transporta un întreg sistem de operare pe o unitate flash poate fi foarte util, mai ales dacă nu ai un laptop. Dar nu crede că această funcție este limitată la distribuțiile Linux - este timpul să încerci să clonezi instalarea Windows.

Dezactivați aceste 7 servicii Windows pentru a prelungi durata de viață a bateriei!

Dezactivați aceste 7 servicii Windows pentru a prelungi durata de viață a bateriei!

Dezactivarea câtorva dintre aceste servicii vă poate economisi o cantitate semnificativă de energie a bateriei fără a vă afecta utilizarea zilnică.

La ce folosește comanda rapidă Ctrl + Z în Windows? Probabil mai mult decât crezi

La ce folosește comanda rapidă Ctrl + Z în Windows? Probabil mai mult decât crezi

Ctrl + Z este o combinație de taste extrem de comună în Windows. Ctrl + Z vă permite practic să anulați acțiuni în toate zonele Windows.

Nu dați clic pe niciun link scurtat până nu sunteți sigur că este sigur!

Nu dați clic pe niciun link scurtat până nu sunteți sigur că este sigur!

URL-urile scurtate sunt convenabile pentru curățarea link-urilor lungi, dar ascund și destinația reală. Dacă doriți să evitați programele malware sau phishing-ul, nu este o alegere înțeleaptă să faceți clic orbește pe linkul respectiv.

Windows 11 22H2: Prima actualizare cu multe caracteristici notabile

Windows 11 22H2: Prima actualizare cu multe caracteristici notabile

După o lungă așteptare, prima actualizare majoră a Windows 11 a fost lansată oficial.

Ce este VPN? Avantajele și dezavantajele unei rețele private virtuale VPN

Ce este VPN? Avantajele și dezavantajele unei rețele private virtuale VPN

Ce este VPN-ul, care sunt avantajele și dezavantajele VPN-ului? Haideți să discutăm cu WebTech360 despre definiția VPN-ului, cum să aplicăm acest model și sistem în muncă.

Majoritatea oamenilor nu folosesc aceste funcții ascunse în Securitate Windows.

Majoritatea oamenilor nu folosesc aceste funcții ascunse în Securitate Windows.

Securitatea Windows face mai mult decât să protejeze împotriva virușilor de bază. Protejează împotriva phishing-ului, blochează ransomware-ul și împiedică rularea aplicațiilor rău intenționate. Cu toate acestea, aceste caracteristici nu sunt ușor de observat - sunt ascunse în spatele unor straturi de meniuri.

Codarea nu este atât de dificilă pe cât crezi

Codarea nu este atât de dificilă pe cât crezi

Odată ce înveți și încerci pe cont propriu, vei descoperi că criptarea este incredibil de ușor de utilizat și incredibil de practică pentru viața de zi cu zi.

Recuperarea datelor șterse cu Recuva Portable în Windows 7

Recuperarea datelor șterse cu Recuva Portable în Windows 7

În articolul următor, vom prezenta operațiunile de bază pentru recuperarea datelor șterse în Windows 7 cu instrumentul de asistență Recuva Portable. Cu Recuva Portable, le puteți stoca pe orice stick USB convenabil și le puteți utiliza oricând este nevoie. Instrumentul este compact, simplu, ușor de utilizat și are câteva dintre următoarele caracteristici:

Cum să ștergi fișierele duplicate pentru a economisi memorie pe calculator folosind CCleaner

Cum să ștergi fișierele duplicate pentru a economisi memorie pe calculator folosind CCleaner

CCleaner scanează fișierele duplicate în doar câteva minute, apoi vă permite să decideți care dintre ele sunt sigure pentru ștergere.

De ce să schimbi locația implicită de descărcare în Windows 11?

De ce să schimbi locația implicită de descărcare în Windows 11?

Mutarea folderului Descărcări de pe unitatea C pe o altă unitate pe Windows 11 vă va ajuta să reduceți capacitatea unității C și va ajuta computerul să funcționeze mai eficient.

Cum să oprești actualizările Windows pe PC

Cum să oprești actualizările Windows pe PC

Aceasta este o modalitate de a consolida și de a ajusta sistemul, astfel încât actualizările să se producă conform programului propriu, nu al Microsoft.

Cum se afișează extensiile de fișiere, cum se vizualizează extensiile de fișiere pe Windows

Cum se afișează extensiile de fișiere, cum se vizualizează extensiile de fișiere pe Windows

Exploratorul de fișiere Windows oferă o mulțime de opțiuni pentru a schimba modul în care vizualizați fișierele. Ceea ce s-ar putea să nu știți este că o opțiune importantă este dezactivată în mod implicit, chiar dacă este crucială pentru securitatea sistemului dvs.

5 instrumente gratuite pentru a găsi spyware și adware pe PC-ul tău

5 instrumente gratuite pentru a găsi spyware și adware pe PC-ul tău

Cu instrumentele potrivite, puteți scana sistemul și elimina programele spyware, adware și alte programe rău intenționate care s-ar putea afla în sistemul dumneavoastră.

14 aplicații și software Windows de care ai nevoie pe noul tău computer

14 aplicații și software Windows de care ai nevoie pe noul tău computer

Mai jos este o listă de software recomandat la instalarea unui computer nou, astfel încât să puteți alege cele mai necesare și mai bune aplicații de pe computerul dvs.!

Cum să clonezi setările Windows pentru a-ți lua fluxul de lucru oriunde

Cum să clonezi setările Windows pentru a-ți lua fluxul de lucru oriunde

A transporta un întreg sistem de operare pe o unitate flash poate fi foarte util, mai ales dacă nu ai un laptop. Dar nu crede că această funcție este limitată la distribuțiile Linux - este timpul să încerci să clonezi instalarea Windows.

Dezactivați aceste 7 servicii Windows pentru a prelungi durata de viață a bateriei!

Dezactivați aceste 7 servicii Windows pentru a prelungi durata de viață a bateriei!

Dezactivarea câtorva dintre aceste servicii vă poate economisi o cantitate semnificativă de energie a bateriei fără a vă afecta utilizarea zilnică.

La ce folosește comanda rapidă Ctrl + Z în Windows? Probabil mai mult decât crezi

La ce folosește comanda rapidă Ctrl + Z în Windows? Probabil mai mult decât crezi

Ctrl + Z este o combinație de taste extrem de comună în Windows. Ctrl + Z vă permite practic să anulați acțiuni în toate zonele Windows.

Nu dați clic pe niciun link scurtat până nu sunteți sigur că este sigur!

Nu dați clic pe niciun link scurtat până nu sunteți sigur că este sigur!

URL-urile scurtate sunt convenabile pentru curățarea link-urilor lungi, dar ascund și destinația reală. Dacă doriți să evitați programele malware sau phishing-ul, nu este o alegere înțeleaptă să faceți clic orbește pe linkul respectiv.

Windows 11 22H2: Prima actualizare cu multe caracteristici notabile

Windows 11 22H2: Prima actualizare cu multe caracteristici notabile

După o lungă așteptare, prima actualizare majoră a Windows 11 a fost lansată oficial.