Как исправить ошибку «Docker: недопустимый формат ссылки»

Зарегистрируйтесь и зарабатывайте 1000$ в день ⋙

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 может столкнуться с такими проблемами, как ошибка «Invalid Reference Format».

Например, выполните следующую команду, чтобы извлечь 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
Sign up and earn $1000 a day ⋙

Leave a Comment

Что такое VPN? Преимущества и недостатки виртуальной частной сети VPN

Что такое VPN? Преимущества и недостатки виртуальной частной сети VPN

Что такое VPN, каковы его преимущества и недостатки? Давайте обсудим с WebTech360 определение VPN, а также как применять эту модель и систему в работе.

Большинство людей не используют эти скрытые функции безопасности Windows.

Большинство людей не используют эти скрытые функции безопасности Windows.

«Безопасность Windows» защищает не только от базовых вирусов. Она защищает от фишинга, блокирует программы-вымогатели и предотвращает запуск вредоносных приложений. Однако эти функции нелегко обнаружить — они скрыты за слоями меню.

Программирование не так сложно, как вы думаете

Программирование не так сложно, как вы думаете

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

Восстановление удаленных данных с помощью Recuva Portable в Windows 7

Восстановление удаленных данных с помощью Recuva Portable в Windows 7

В этой статье мы расскажем об основных операциях по восстановлению удалённых данных в Windows 7 с помощью утилиты Recuva Portable. Recuva Portable позволяет сохранить данные на любом удобном USB-накопителе и использовать их по мере необходимости. Эта утилита компактна, проста и удобна в использовании, а также обладает следующими функциями:

Как удалить дубликаты файлов для экономии памяти компьютера с помощью CCleaner

Как удалить дубликаты файлов для экономии памяти компьютера с помощью CCleaner

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

Зачем менять место загрузки по умолчанию в Windows 11?

Зачем менять место загрузки по умолчанию в Windows 11?

Перемещение папки «Загрузки» с диска C на другой диск в Windows 11 поможет уменьшить емкость диска C и обеспечит более плавную работу компьютера.

Как остановить обновления Windows на ПК

Как остановить обновления Windows на ПК

Это способ укрепить и настроить вашу систему так, чтобы обновления происходили по вашему собственному графику, а не по графику Microsoft.

Как показать расширения файлов, просмотреть расширения файлов в Windows

Как показать расширения файлов, просмотреть расширения файлов в Windows

Проводник Windows предлагает множество возможностей для настройки просмотра файлов. Возможно, вы не знаете, что одна важная опция по умолчанию отключена, хотя она критически важна для безопасности вашей системы.

5 бесплатных инструментов для поиска шпионского и рекламного ПО на вашем ПК

5 бесплатных инструментов для поиска шпионского и рекламного ПО на вашем ПК

Используя правильные инструменты, вы сможете просканировать свою систему и удалить шпионское, рекламное ПО и другие вредоносные программы, которые могут находиться в вашей системе.

14 приложений и программ Windows, которые вам понадобятся на новом компьютере

14 приложений и программ Windows, которые вам понадобятся на новом компьютере

Ниже представлен список рекомендуемого программного обеспечения при установке нового компьютера, чтобы вы могли выбрать самые необходимые и лучшие приложения на свой компьютер!

Как клонировать настройки Windows, чтобы использовать свой рабочий процесс где угодно

Как клонировать настройки Windows, чтобы использовать свой рабочий процесс где угодно

Перенос всей операционной системы на флеш-накопитель может быть очень полезен, особенно если у вас нет ноутбука. Но не думайте, что эта функция доступна только дистрибутивам Linux — самое время попробовать клонировать вашу установку Windows.

Отключите эти 7 служб Windows, чтобы продлить срок службы аккумулятора!

Отключите эти 7 служб Windows, чтобы продлить срок службы аккумулятора!

Отключение некоторых из этих служб может существенно сэкономить время работы аккумулятора, не влияя на повседневное использование устройства.

Зачем нужна комбинация клавиш Ctrl+Z в Windows? Вероятно, она важнее, чем вы думаете.

Зачем нужна комбинация клавиш Ctrl+Z в Windows? Вероятно, она важнее, чем вы думаете.

Ctrl + Z — чрезвычайно распространённое сочетание клавиш в Windows. Ctrl + Z позволяет отменять действия во всех областях Windows.

Не нажимайте на сокращенную ссылку, пока не убедитесь, что она безопасна!

Не нажимайте на сокращенную ссылку, пока не убедитесь, что она безопасна!

Сокращённые URL-адреса удобны для очистки длинных ссылок, но они также скрывают реальный адрес. Если вы хотите избежать вредоносного ПО или фишинга, бездумно нажимать на такую ​​ссылку — не лучший выбор.

Windows 11 22H2: обновление «Момент 1» со множеством примечательных функций

Windows 11 22H2: обновление «Момент 1» со множеством примечательных функций

После долгого ожидания официально выпущено первое крупное обновление Windows 11.

Что такое VPN? Преимущества и недостатки виртуальной частной сети VPN

Что такое VPN? Преимущества и недостатки виртуальной частной сети VPN

Что такое VPN, каковы его преимущества и недостатки? Давайте обсудим с WebTech360 определение VPN, а также как применять эту модель и систему в работе.

Большинство людей не используют эти скрытые функции безопасности Windows.

Большинство людей не используют эти скрытые функции безопасности Windows.

«Безопасность Windows» защищает не только от базовых вирусов. Она защищает от фишинга, блокирует программы-вымогатели и предотвращает запуск вредоносных приложений. Однако эти функции нелегко обнаружить — они скрыты за слоями меню.

Программирование не так сложно, как вы думаете

Программирование не так сложно, как вы думаете

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

Восстановление удаленных данных с помощью Recuva Portable в Windows 7

Восстановление удаленных данных с помощью Recuva Portable в Windows 7

В этой статье мы расскажем об основных операциях по восстановлению удалённых данных в Windows 7 с помощью утилиты Recuva Portable. Recuva Portable позволяет сохранить данные на любом удобном USB-накопителе и использовать их по мере необходимости. Эта утилита компактна, проста и удобна в использовании, а также обладает следующими функциями:

Как удалить дубликаты файлов для экономии памяти компьютера с помощью CCleaner

Как удалить дубликаты файлов для экономии памяти компьютера с помощью CCleaner

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

Зачем менять место загрузки по умолчанию в Windows 11?

Зачем менять место загрузки по умолчанию в Windows 11?

Перемещение папки «Загрузки» с диска C на другой диск в Windows 11 поможет уменьшить емкость диска C и обеспечит более плавную работу компьютера.

Как остановить обновления Windows на ПК

Как остановить обновления Windows на ПК

Это способ укрепить и настроить вашу систему так, чтобы обновления происходили по вашему собственному графику, а не по графику Microsoft.

Как показать расширения файлов, просмотреть расширения файлов в Windows

Как показать расширения файлов, просмотреть расширения файлов в Windows

Проводник Windows предлагает множество возможностей для настройки просмотра файлов. Возможно, вы не знаете, что одна важная опция по умолчанию отключена, хотя она критически важна для безопасности вашей системы.

5 бесплатных инструментов для поиска шпионского и рекламного ПО на вашем ПК

5 бесплатных инструментов для поиска шпионского и рекламного ПО на вашем ПК

Используя правильные инструменты, вы сможете просканировать свою систему и удалить шпионское, рекламное ПО и другие вредоносные программы, которые могут находиться в вашей системе.

14 приложений и программ Windows, которые вам понадобятся на новом компьютере

14 приложений и программ Windows, которые вам понадобятся на новом компьютере

Ниже представлен список рекомендуемого программного обеспечения при установке нового компьютера, чтобы вы могли выбрать самые необходимые и лучшие приложения на свой компьютер!

Как клонировать настройки Windows, чтобы использовать свой рабочий процесс где угодно

Как клонировать настройки Windows, чтобы использовать свой рабочий процесс где угодно

Перенос всей операционной системы на флеш-накопитель может быть очень полезен, особенно если у вас нет ноутбука. Но не думайте, что эта функция доступна только дистрибутивам Linux — самое время попробовать клонировать вашу установку Windows.

Отключите эти 7 служб Windows, чтобы продлить срок службы аккумулятора!

Отключите эти 7 служб Windows, чтобы продлить срок службы аккумулятора!

Отключение некоторых из этих служб может существенно сэкономить время работы аккумулятора, не влияя на повседневное использование устройства.

Зачем нужна комбинация клавиш Ctrl+Z в Windows? Вероятно, она важнее, чем вы думаете.

Зачем нужна комбинация клавиш Ctrl+Z в Windows? Вероятно, она важнее, чем вы думаете.

Ctrl + Z — чрезвычайно распространённое сочетание клавиш в Windows. Ctrl + Z позволяет отменять действия во всех областях Windows.

Не нажимайте на сокращенную ссылку, пока не убедитесь, что она безопасна!

Не нажимайте на сокращенную ссылку, пока не убедитесь, что она безопасна!

Сокращённые URL-адреса удобны для очистки длинных ссылок, но они также скрывают реальный адрес. Если вы хотите избежать вредоносного ПО или фишинга, бездумно нажимать на такую ​​ссылку — не лучший выбор.

Windows 11 22H2: обновление «Момент 1» со множеством примечательных функций

Windows 11 22H2: обновление «Момент 1» со множеством примечательных функций

После долгого ожидания официально выпущено первое крупное обновление Windows 11.