Как да поправите грешката „Docker: Невалиден формат на препратката“

Docker улеснява изграждането, изпълнението и управлението на контейнери. Въпреки това, може да срещнете грешка „Невалиден формат на референцията“, когато изпълнявате или изграждате изображение. В повечето случаи това се дължи на незначителна грешка във форматирането на името или етикета на изображението. Например, грешката може да се дължи на главни букви, специални символи или липсващи стойности. Това ръководство ще обясни често срещаните причини за тази грешка и как да я поправите, за да предотвратите повторното ѝ възникване.

Поправка на грешката „Невалиден формат на препратката“

Нека разберем най-честите причини за грешката „Невалиден формат на препратката“ и как да я поправим:

Главни букви в имената на изображенията

Docker изисква имената на изображенията да са с малки букви. Дори една главна буква може да причини грешки при форматиране. Например, изпълнението на следната команда ще доведе до грешка:

docker pull NGINX
Как да поправите грешката „Docker: Невалиден формат на препратката“
Имената на архивите трябва да бъдат с малки букви

За да избегнете тази грешка, винаги проверявайте дали името на изображението е с малки букви, преди да изпълните командата.

docker pull nginx
Как да поправите грешката „Docker: Невалиден формат на препратката“
Използвайте малки букви

Специален или невалиден символ

Понякога потребителите случайно добавят символи, които Docker не позволява. Те включват знаци @, интервали или символи, копирани от уебсайт или документ, които изглеждат нормални, но не са.

Например, следната команда съдържа специалния символ @, който ще доведе до следната грешка:

docker run ubuntu@:latest
Как да поправите грешката „Docker: Невалиден формат на препратката“
Грешка със специален символ

За да коригирате тази грешка, уверете се, че няма излишни символи или проблеми с форматирането в командата. Можете да използвате текстов редактор, за да проверите и почистите командата (ако е необходимо):

docker run ubuntu:latest
Как да поправите грешката „Docker: Невалиден формат на препратката“
Избягвайте специални символи

Дебело черво без етикет

Една от най-често срещаните грешки е да се постави двоеточие в края на името на изображението, но да не се включва тагът. Например, нека опитаме следната команда, за да изтеглим Node:

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 може да срещне проблеми като грешката „Невалиден формат на препратката“.

Например, изпълнете следната команда, за да изтеглите Ubuntu от Docker Hub:

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 изображения в системния регистър или как да почиствате неизползваните изображения, за да поддържате системата си чиста.

Tags: #System

Leave a Comment

Как да освободите 48GB на компютър с Windows 11, без да губите важни данни

Как да освободите 48GB на компютър с Windows 11, без да губите важни данни

Между временните файлове, остарелите резервни копия, дублиращите се данни и неизползваните приложения, има много начини да освободите място, без да докосвате личните си файлове.

Проверете MD5 и SHA1, за да проверите целостта на файла

Проверете MD5 и SHA1, за да проверите целостта на файла

Ще използваме специализирана програма, за да проверим MD5 и SHA1 кодовете на файла, за да видим дали има грешки във файла. А софтуерът за проверка на MD5 HashCalc е един от доста полезните инструменти за проверка на MD5 и SHA1 кодове.

Как да покажете скрити файлове и папки в Windows 10/8/7

Как да покажете скрити файлове и папки в Windows 10/8/7

Прегледът на скрити файлове, скрити папки и скрити системни файлове в Windows е съвсем лесен. Читателите могат да видят подробни инструкции за показване на скрити файлове и преглед на файлови разширения в тази статия.

Поправка на проблема с работата на пряката връзка Windows + Shift + S в Windows 10

Поправка на проблема с работата на пряката връзка Windows + Shift + S в Windows 10

Комбинацията от клавиши Win + Shift + S в Windows 10 позволява на потребителите да заснемат част или целия екран и да го копират в клипборда. В повечето случаи тази функция работи както се очаква, но понякога може да спре да реагира.

Как да изключите твърдия диск, когато не се използва в Windows 11

Как да изключите твърдия диск, когато не се използва в Windows 11

Ако компютърът ви има SSD и HDD, можете да изключите твърдия диск след период на неактивност.

Как да поправите грешката при вмъкване на данни от ядрото в Windows

Как да поправите грешката при вмъкване на данни от ядрото в Windows

Грешката при влизане в страницата за данни на ядрото (код за спиране 0x0000007a) се причинява от лоши сектори, вируси, твърди дискове или дефектна RAM памет.

Как да отворите „Защита на Windows“ в Windows 10

Как да отворите „Защита на Windows“ в Windows 10

„Защита в Windows“ е включена и проактивно защитава устройството ви, като сканира за злонамерен софтуер, вируси и други заплахи за сигурността.

Как да активирате разширени настройки в Windows 11

Как да активирате разширени настройки в Windows 11

Microsoft представя преработена страница с разширени настройки в Windows 11, добавяйки системна персонализация за разработчици и потребители с нови функции

Как да поправите грешката „Docker: Невалиден формат на препратката“

Как да поправите грешката „Docker: Невалиден формат на препратката“

Docker улеснява изграждането, изпълнението и управлението на контейнери. Въпреки това, може да срещнете грешка „Невалиден формат на препратката“ (Invalid Reference Format), когато изпълнявате или изграждате образ.

Как да предотвратите автоматичното заключване на Windows

Как да предотвратите автоматичното заключване на Windows

За да предотвратите заключването на компютъра с Windows 10 от страна на потребителите, следвайте стъпките по-долу, за да деактивирате заключения екран в Windows 10.

Как да архивирате и възстановите Microsoft Defender Windows 11

Как да архивирате и възстановите Microsoft Defender Windows 11

Можете да архивирате и възстановите настройките на Microsoft Defender на нов компютър или да отстраните евентуални проблеми с приложението.

Използване на CMD за изтриване на големи папки в Windows

Използване на CMD за изтриване на големи папки в Windows

Големите папки в системата са едни от виновниците, които заемат много системно пространство. Много папки, които създавате, след изтриването им, ще се появят отново след известно време. Може би това са ненужни папки, които се опитвате да премахнете.

Активирайте GodMode на Windows 10, 8 и 7

Активирайте GodMode на Windows 10, 8 и 7

GodeMode се нарича Shortcut Windows Master Control Panel. GodMode (или God Mode) е контролен панел, който ви позволява да настройвате и да имате достъп до всичко на вашата операционна система Windows.

Обобщение на командите на Cisco CCNA

Обобщение на командите на Cisco CCNA

Тази статия ще се опита да обхване CCNA командите както в ICND част 1 и 2, така и в текущия изпит CCNA (640-802).

Как да използвате пространства за съхранение, за да защитите данните в Windows 11

Как да използвате пространства за съхранение, за да защитите данните в Windows 11

Обединяването на множество устройства със Storage Spaces в Windows 11 позволява на потребителите да защитават файловете от повреда на устройството, като същевременно консолидират хранилището в едно, лесно за управление виртуално устройство.

Как да поправите грешката „мрежовият адаптер не е намерен“ в Windows 10

Как да поправите грешката „мрежовият адаптер не е намерен“ в Windows 10

Много хора са се сблъсквали с проблема с изчезването на мрежовия адаптер от диспечера на устройствата или получаването на съобщение за липсващ мрежов адаптер. Тази статия ще ви помогне как да отстраните проблема с липсващия драйвер на мрежовия адаптер в Windows 10.

Как да изтриете отделни точки за възстановяване на системата в Windows

Как да изтриете отделни точки за възстановяване на системата в Windows

Windows автоматично създава точки за възстановяване на системата до зададен лимит, оставяйки ви с десетки точки за възстановяване, които никога не използвате.

Често срещани грешки при извършване на тестове за скорост на интернет

Често срещани грешки при извършване на тестове за скорост на интернет

Ако резултатите изглеждат по-бавни от очакваното, не бързайте да обвинявате вашия интернет доставчик - грешките при извършване на теста могат да изкривят вашите числа.

Какво е QoS? Как да използвате QoS за по-бързи интернет скорости, когато имате най-голяма нужда от него

Какво е QoS? Как да използвате QoS за по-бързи интернет скорости, когато имате най-голяма нужда от него

В статията по-долу ще ви представим и ще ви насочим да научите за концепцията QoS - качество на услугата (Quality of Service) на рутерите.

Следвайте тези 7 стъпки, за да предотвратите повторното забавяне на Windows 11!

Следвайте тези 7 стъпки, за да предотвратите повторното забавяне на Windows 11!

От изтриване на временни файлове до актуализиране на софтуер, има много прости и ефективни начини да поддържате компютъра си да работи безпроблемно като нов.

Как да освободите 48GB на компютър с Windows 11, без да губите важни данни

Как да освободите 48GB на компютър с Windows 11, без да губите важни данни

Между временните файлове, остарелите резервни копия, дублиращите се данни и неизползваните приложения, има много начини да освободите място, без да докосвате личните си файлове.

Проверете MD5 и SHA1, за да проверите целостта на файла

Проверете MD5 и SHA1, за да проверите целостта на файла

Ще използваме специализирана програма, за да проверим MD5 и SHA1 кодовете на файла, за да видим дали има грешки във файла. А софтуерът за проверка на MD5 HashCalc е един от доста полезните инструменти за проверка на MD5 и SHA1 кодове.

Как да покажете скрити файлове и папки в Windows 10/8/7

Как да покажете скрити файлове и папки в Windows 10/8/7

Прегледът на скрити файлове, скрити папки и скрити системни файлове в Windows е съвсем лесен. Читателите могат да видят подробни инструкции за показване на скрити файлове и преглед на файлови разширения в тази статия.

Поправка на проблема с работата на пряката връзка Windows + Shift + S в Windows 10

Поправка на проблема с работата на пряката връзка Windows + Shift + S в Windows 10

Комбинацията от клавиши Win + Shift + S в Windows 10 позволява на потребителите да заснемат част или целия екран и да го копират в клипборда. В повечето случаи тази функция работи както се очаква, но понякога може да спре да реагира.

Как да изключите твърдия диск, когато не се използва в Windows 11

Как да изключите твърдия диск, когато не се използва в Windows 11

Ако компютърът ви има SSD и HDD, можете да изключите твърдия диск след период на неактивност.

Как да поправите грешката при вмъкване на данни от ядрото в Windows

Как да поправите грешката при вмъкване на данни от ядрото в Windows

Грешката при влизане в страницата за данни на ядрото (код за спиране 0x0000007a) се причинява от лоши сектори, вируси, твърди дискове или дефектна RAM памет.

Как да отворите „Защита на Windows“ в Windows 10

Как да отворите „Защита на Windows“ в Windows 10

„Защита в Windows“ е включена и проактивно защитава устройството ви, като сканира за злонамерен софтуер, вируси и други заплахи за сигурността.

Как да активирате разширени настройки в Windows 11

Как да активирате разширени настройки в Windows 11

Microsoft представя преработена страница с разширени настройки в Windows 11, добавяйки системна персонализация за разработчици и потребители с нови функции

Как да поправите грешката „Docker: Невалиден формат на препратката“

Как да поправите грешката „Docker: Невалиден формат на препратката“

Docker улеснява изграждането, изпълнението и управлението на контейнери. Въпреки това, може да срещнете грешка „Невалиден формат на препратката“ (Invalid Reference Format), когато изпълнявате или изграждате образ.

Как да предотвратите автоматичното заключване на Windows

Как да предотвратите автоматичното заключване на Windows

За да предотвратите заключването на компютъра с Windows 10 от страна на потребителите, следвайте стъпките по-долу, за да деактивирате заключения екран в Windows 10.