Docker & Containers

Analizador de referencias Dockercomprueba el destino y el selector

Analiza una referencia o compón sus campos. Revisa los valores predeterminados y la prioridad del digest antes de copiar.

Analizador de referencias Docker

Referencia o campos

Las referencias se procesan en este navegador. Sin consultas al registro, cargas ni acceso al daemon de Docker.

Referencia analizada

Introduce una referencia o ruta de repositorio.

Modo de entrada y ejemplos

Cada modo conserva su borrador. Deja el registro vacío para Docker Hub y escribe la ruta completa del repositorio por separado. host:5000 identifica un registro sin ambigüedad.

Una referencia, hasta 4.096 caracteres. Ruta del repositorio: 255; etiqueta: 128. Digests sha256/384/512 completos en hexadecimal minúsculo.

Esperando para analizar la última entrada…

Este Analizador de referencias Docker ayuda cuando un despliegue apunta al registro equivocado. En registry.example.com:5000/team/api:v2, los dos signos de dos puntos separan un puerto y una etiqueta. Dividir por el primero no basta para interpretar el destino.

Compara el nombre corto con el ejemplo de registro privado. La ruta del repositorio aparece separada del selector de contenido y el texto original se conserva. Así puedes detectar un host omitido o un latest que no esperabas.

Por qué usar este Analizador de referencias Docker

Reconocer lo que Docker añade

Este Analizador de referencias Docker expande nginx a docker.io/library/nginx:latest. Las marcas diferencian los valores añadidos de los indicados por ti. En un registro privado, la ruta conserva su estructura y no recibe un prefijo library improcedente.

Una referencia corta se expande en componentes de colores para registro, repositorio y etiqueta

Conservar la etiqueta y mostrar la prioridad

Una referencia puede llevar etiqueta y digest a la vez. La vista normalizada conserva ambos para su revisión; la referencia efectiva muestra la selección por digest, sin insinuar que la etiqueta se ha contrastado con el contenido real.

Una etiqueta móvil y una huella fija apuntan a un contenedor, y la huella determina la selección

Revisa los separadores y los valores omitidos

01

Observa el primer segmento con barra

Antes de la primera barra, un punto, dos puntos, una mayúscula o localhost identifica el registro. Sin barra, incluso localhost es un nombre de repositorio en Docker Hub. registry/api, en minúsculas y sin puerto, usa un espacio de nombres.

02

Mantén cada dato en su campo

Al cambiar de modo se conserva el otro borrador. La ruta incluye el espacio de nombres, pero :tag y @digest van en sus propios campos. Un registro vacío selecciona Docker Hub y no detecta automáticamente tu servidor local.

03

Comprueba que la salida sea actual

El análisis automático espera 350 ms tras editar. Desactívalo para mostrar el botón, o usa Ctrl/Cmd + Intro. Los ejemplos y el vaciado pasan por una vista previa; deshacer restaura una vez la entrada y su resultado conjuntamente.

Inspección desde el host hasta el contenido

Resolver abreviaturas de Docker Hub

docker.io, library y latest se añaden solo bajo sus condiciones respectivas. index.docker.io se normaliza a docker.io. Se conserva la distinción entre mayúsculas y minúsculas de la etiqueta, mientras que una mayúscula en la ruta produce un error explícito.

Validar partes con reglas diferentes

El nombre de imagen se interpreta con un host, un puerto numérico o una dirección IPv6 pura entre corchetes. Se revisan por separado los separadores de ruta, los caracteres de etiqueta y la longitud del digest, sin confundir un hash incompleto con una versión.

Componer referencias y guardar el resultado

Los campos registro, repositorio, etiqueta y digest usan las mismas reglas que el texto libre. Copia la referencia normalizada o efectiva, o guarda los campos y las marcas de valores predeterminados como JSON. Editar o cambiar de modo bloquea la exportación hasta que el borrador actual se procese correctamente.

Límites de una comprobación de sintaxis

Sin inspección de imágenes remotas
No se comprueban registro, permisos, manifiestos, arquitectura, firmas ni vulnerabilidades. Componer solo genera una cadena de referencia; no construye un archivo de imagen ni ejecuta operaciones de descarga, ejecución o envío.
No convertir etiquetas en digests
latest se añade únicamente cuando faltan ambos selectores. Un digest indicado tiene prioridad, pero no demuestra que coincida con la etiqueta. La herramienta no calcula hashes ni consulta el registro para resolver esa relación.
Una referencia con nombre cada vez
No se extraen imágenes de archivos Dockerfile, Compose, Kubernetes, archivos comprimidos o listas. Se recortan espacios exteriores; se rechazan espacios internos, credenciales, esquemas URL y variables sin expandir. Un ID aislado no se traduce a un repositorio.
Longitudes y algoritmos concretos
La entrada activa admite 4.096 caracteres, la ruta normalizada 255 y la etiqueta 1–128 caracteres ASCII permitidos, sin punto ni guion inicial. Solo se admiten sha256/384/512 completos en hexadecimal minúsculo. Se excluyen identificadores de zona IPv6 y formas mixtas con IPv4 decimal; el puerto numérico no se comprueba mediante una conexión.

Preguntas sobre el Analizador de referencias Docker

¿Por qué Docker muestra repository name must be lowercase?

Los componentes de la ruta del repositorio deben estar en minúsculas; la etiqueta sí puede contener mayúsculas. Revisa el espacio de nombres y el nombre antes del separador de etiqueta. La herramienta informa del error sin cambiar la ruta silenciosamente, para no ocultar una errata en el destino.

¿Docker comprueba que la etiqueta y el digest coincidan cuando se incluyen ambos?

No debes contar con esa comprobación. Cuando aparecen ambos, el digest determina la selección. La salida normalizada conserva la etiqueta y la efectiva la omite. Para demostrar su correspondencia, consulta por separado los metadatos reales del registro.

¿Cómo saber a qué versión apunta realmente latest?

latest es una etiqueta elegida por quien publica la imagen, no una instrucción para calcular la versión semántica más alta. Su destino puede cambiar. Aquí se muestra el valor literal; conocer el digest actual requiere consultar el registro fuera de esta herramienta.

¿Por qué mi registro local intenta enviar imágenes a docker.io?

En registry/api, el primer segmento en minúsculas no tiene punto ni puerto, por lo que Docker lo interpreta como espacio de nombres. Comprueba si necesitas registry:5000/api o un host completo. El modo de campos rechaza esa ambigüedad en lugar de generar un destino inesperado en Docker Hub.

¿Qué diferencia hay entre el ID de una imagen y su digest?

El ID local identifica el contenido de configuración de la imagen; un digest del registro puede identificar un manifiesto o un índice de imágenes. Esos hashes no suelen ser intercambiables. Introduce el repositorio seguido de @ y su digest; esta herramienta no obtiene uno a partir del otro.

¿Te queda alguna duda?

Comprueba la próxima referencia

Usa el Analizador de referencias Docker para revisar el destino y el selector juntos. Copia la referencia efectiva cuando el borrador actual haya pasado la validación.