Analice una referencia Docker: registro, repositorio, etiqueta o digest

El analizador separa un registro explícito, incluido un puerto opcional, de la ruta del repositorio y de una etiqueta o un digest de contenido opcionales. Reconoce por qué los dos puntos de registry.example.com:5000 no delimitan una etiqueta y por qué los que siguen al nombre de una imagen sí lo hacen. Las referencias incorrectas generan un error claro, no campos parciales engañosos. No se consulta ningún registro ni se inventan valores omitidos como Docker Hub o latest.

Separe cada parte sin adivinar valores predeterminados ocultos

Una referencia de imagen Docker puede ser tan breve como alpine o tan detallada como registry.example.com:5000/platform/api:2026.07. A simple vista, tanto el puerto del registro como la etiqueta de la imagen utilizan dos puntos, por lo que dividir el texto solo por signos de puntuación produce resultados incorrectos. Este analizador aísla primero el digest y después examina únicamente el último segmento de la ruta para encontrar una etiqueta. Considera que el primer componente separado por una barra es un registro explícito cuando se trata de localhost, contiene un punto, incluye los dos puntos de un puerto o es una dirección IPv6 entre corchetes. Todo lo que sigue a ese componente forma la ruta del repositorio. La salida conserva exclusivamente lo que declara la entrada. Para alpine, el repositorio es alpine y no aparecen campos de registro ni etiqueta. El analizador no sustituye docker.io, no añade el espacio de nombres habitual library ni supone latest. Así, el resultado sirve para analizar configuraciones, aplicar políticas y preparar migraciones donde un valor explícito debe distinguirse de un valor predeterminado del cliente.

Procese correctamente etiquetas, digests, puertos y rutas

Las etiquetas y los digests identifican imágenes de maneras diferentes. Una etiqueta es un nombre móvil como stable, 1.4.2 o release_candidate, mientras que un digest es un identificador basado en el contenido, escrito tras una arroba como algoritmo y valor. El analizador devuelve ambos conceptos en campos independientes y también admite una referencia que contenga los dos, porque las herramientas Docker pueden utilizar un nombre con etiqueta y restringirlo mediante un digest. Las rutas de repositorio pueden incluir varios componentes en minúsculas con los separadores permitidos por las reglas habituales de nombres Docker. Los hosts de registro se validan por separado, incluidos los puertos numéricos del 1 al 65535 y las formas IPv6 en minúsculas entre corchetes. Los algoritmos y valores de digest deben respetar su sintaxis, y el valor debe tener longitud suficiente. No se intenta resolver una etiqueta, comprobar la existencia de un digest ni verificar permisos de descarga. Es únicamente un análisis sintáctico, por lo que el resultado es determinista, privado y no requiere acceso a la red.

Rechace entradas ambiguas antes de automatizarlas

Un analizador demasiado permisivo puede resultar peligroso en la automatización de despliegues, porque un error tipográfico puede señalar una imagen distinta de la prevista. Esta capacidad rechaza valores vacíos, espacios al principio, al final o en medio, esquemas de URL, separadores de digest repetidos, segmentos de ruta vacíos, etiquetas incorrectas, puertos de registro no válidos, nombres de repositorio con mayúsculas y expresiones de digest defectuosas. También limita la longitud de la referencia completa y del repositorio para mantener acotado el trabajo. La validación devuelve un único error claro de entrada no válida, en lugar de un objeto parcial que podría parecer fiable. Utilice este comportamiento en el límite de una tarea de CI, un editor de manifiestos, un importador de inventario de imágenes o un auxiliar de políticas de admisión. Un resultado válido puede encaminarse según contenga registro, etiqueta o digest; un resultado inválido detiene el flujo cuanto antes. La sintaxis válida no garantiza que el repositorio o la imagen existan: comprobarlo exige acceso y autenticación ante el registro. La ejecución en navegador es local y la API cuesta $0.002 por referencia.