Docker hace que sea sencillo construir, ejecutar y tener la llave de la despensa contenedores. Sin confiscación, puede encontrar el «Formato de remisión no válidoError al intentar ejecutar o construir una imagen. En la mayoría de los casos, el problema es causado por un pequeño error de formato en el nombre o la ceremonial de la imagen. Por ejemplo, podría deberse a saber mayúsculas, caracteres especiales o un valía faltante. En esta práctico, explicaré las causas comunes de este error y cómo arreglarlas para evitar que vuelva a suceder.
¿Qué significa el error de «formato de remisión no válido» en Docker?
Este error ocurre cuando Docker no puede interpretar el formato del nombre de su imagen. Si el nombre está estructurado incorrectamente, Docker no puede procesar la solicitud y rejón el error de «Formato de remisión no válido».
Docker requiere que los nombres de imágenes sigan una estructura específica para que funcione correctamente. La sintaxis militar es:
(registry/)(repository)(:tag)Para cerciorarse de que su nombre de imagen sea válido, siga estas reglas:
- Use solo saber minúsculas. Docker no permite saber mayúsculas en los nombres de imágenes.
- Puede incluir números, guiones (-), puntos (.) Y subrayos (_) para separar palabras o versiones, como my-app_v1.0.
- Evite exclusivo Personajes como @, #, o $, ya que Docker no los aceptará.
- Los nombres de imágenes de Docker todavía deben seguir las reglas de nombres de DNS, lo que significa que cada sección del nombre (separada por barras o puntos) debe tener entre 1 y 63 caracteres de generoso, y los guiones no pueden colocarse al principio o al final de una sección.
- El nombre completo de la imagen, incluido cualquier registro y información de la ceremonial, no debe tener más de 255 caracteres en total.
Arreglar el error de «formato de remisión no válido»
Exploremos las razones más comunes para el error de «formato de remisión no válido» y cómo solucionarlas:
Literatura mayúsculas en el nombre de la imagen
Docker retraso que los nombres de imágenes estén en todas las saber minúsculas. Incluso una sola composición mayúscula puede hacer que el formato se rompa. Por ejemplo, ejecutar el próximo comando causará un error:
docker pull NGINX
Para evitar este error, siempre verifique que el nombre de su imagen esté en minúsculas antiguamente de ejecutar el comando.
docker pull nginx
Personajes especiales o inválidos
A veces, los usuarios incluyen accidentalmente personajes que Docker no permite. Estos símbolos incluyen el aviso @, los espacios o los caracteres copiados de un sitio web o documento que parecen normales pero no lo son.
Por ejemplo, el próximo comando contiene un carácter exclusivo @, que causará el error establecido:
docker run ubuntu@:latest
Para resolver este error, asegúrese de que no haya caracteres adicionales o problemas de formato en el comando. Puede usar un editor de texto sin formato para corroborar y barrer el comando (si es necesario):
docker run ubuntu:latest
Un colon sin ceremonial
Uno de los errores más comunes es colocar un colon al final del nombre de la imagen pero no incluir una ceremonial. Por ejemplo, intentamos el próximo comando para extraer el nodo:
docker pull node:Docker retraso poco a posteriori del colon, como el postrer, 18 montañoso o cualquier otra ceremonial válida. Si no se proporciona cero, el nombre de la imagen se considera incompleto y causará el error de «formato de remisión no válido»:
Para solucionar esto, agregue una ceremonial adecuada a posteriori del colon para que el nombre de la imagen sea completo y válido:
docker pull node:latest
Rutas de archivo o montajes de grosor con espacios
Cuando incluye una ruta de archivo que contiene espacios, especialmente con opciones como -v (Monte de grosor), Docker puede malinterpretar partes de la ruta como argumentos separados o incluso parte del nombre de la imagen. Como resultado, puede encontrar resultados inesperados como se muestra a continuación:
docker run -v /home/user/My Folder:/app ubuntu
Para evitar esto, siempre coloque rutas de archivo con espacios internamente de cotizaciones dobles, como se muestra a continuación:
docker run -v "/home/user/My Folder:/app" ubuntuReemplace «/home/user/mi carpeta» con la ruta actual a la carpeta que desea costar en el contenedor.
Uso inapropiado de variable
Cuando se trabaja con Docker, es global usar variables en los comandos, especialmente al especificar versiones de imagen. Sin confiscación, si una variable como $VERSION No se establece correctamente, Docker puede encontrar problemas como el error de «Formato de remisión no válido».
Por ejemplo, ejecutamos el próximo comando para sacar a Ubuntu del Docker Hub:
docker pull ubuntu:$VERSIONAquí, el $VERSION se supone que representa la interpretación de la imagen de Ubuntu que desea extraer. Pero si no ha asignado ningún valía, Docker interpreta el comando como «Docker Pull Ubuntu:». Esto da como resultado un nombre de imagen no válido porque termina con un colon y carece de la ceremonial de interpretación requerida.
Para evitar esto, asegúrese de que todas las variables utilizadas en el comando estén definidas correctamente. En Linux, puede establecer una variable utilizando la próximo sintaxis.
$VERSION=latestLuego, extraiga la interpretación especificada ejecutando el próximo comando.
docker pull ubuntu:$VERSIONEn Windows CMD, debe usar el set palabra secreto para especificar una variable (como la interpretación), y luego usar %VARIABLE% Sintaxis para hacer remisión a él en comandos como Docker Pull.
set VERSION=latest
docker pull ubuntu:%VERSION%Aquí, $VERSION posee el valía más tardío, por lo que Docker costal el Ubuntu: Final imagen sin ningún problema. Igualmente puede asignar una interpretación específica, como 18.04, si es necesario.
Copiar y pegar problemas
A veces, los usuarios copian comandos de tutoriales o documentos en orientación. Estos comandos copiados pueden contener caracteres ocultos como espacios invisibles, puntuación no inglesa o calificaciones de cotización especiales. Estos personajes pueden romper silenciosamente su comando Docker.
Para evitar esto, siempre es mejor escribir el comando cuando sea posible o pegarlo en un editor de texto sin formato primero para eliminar el formato no deseado.
Concluir
Ahora que conoce las causas comunes del error de «formato de remisión no válido» en Docker y sus respectivas correcciones, está en una posición mucho mejor para evitar este problema en el futuro. Desde la demostración de saber mayúsculas para cerciorarse de que sus variables estén correctamente establecidas, estos simples consejos pueden ahorrarle mucho tiempo y frustración. Si está dispuesto para explorar más, es posible que todavía desee asimilar cómo etiquetar y aguantar sus propias imágenes de Docker personalizadas a un registro o cómo barrer las imágenes no utilizadas para surtir su sistema organizado.
