Qué son los tags de imágenes Docker

Infografía sobre los tags de imágenes Docker, versiones y variantes
Infografía con ejemplos de tags Docker, versiones y variantes de imágenes.

Entender qué son los tags de imágenes en Docker te ayuda a controlar versiones y evitar builds impredecibles. Un tag es una etiqueta legible que apunta a una imagen en un registry, pero no es una garantía absoluta de inmutabilidad.

En esta lección vas a ver cómo leer referencias como nginx:1.27-alpine, qué significa latest, en qué se diferencia un tag de un digest y cómo crear etiquetas locales con docker tag.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Qué son los tags de imágenes

Un tag aparece después de los dos puntos que separan el repositorio y la etiqueta, no después del puerto de un registry. En docker.io/library/redis:7.2, por ejemplo, 7.2 es el tag; en registry.example:5000/org/app:1.3.0, 5000 es el puerto y 1.3.0 el tag. El tag identifica una versión, variante o canal de publicación.

nginx:1.27-alpine
ubuntu:24.04
docker.io/library/redis:7.2
ghcr.io/mi-org/mi-app:v1.3.0
ParteEjemploSignificado
RepositorionginxNombre de la imagen.
Tag1.27-alpineVersión o variante seleccionada.
Registryghcr.ioServidor donde vive la imagen.
Namespacemi-orgOrganización o espacio del registry.
Digestsha256:…Identificador por contenido.

Antes de usar latest

latest no significa “la versión más nueva garantizada” ni “la mejor”. Es solo un tag más, mantenido por quien publica la imagen. Puede cambiar con el tiempo y romper reproducibilidad en CI o producción.

  • Usa latest solo para pruebas rápidas o laboratorios desechables.
  • Usa tags explícitos para Dockerfiles y despliegues repetibles.
  • Lee la política del proyecto: cada imagen usa convenciones distintas.
  • Si necesitas máxima precisión, usa digest además del tag.

Tags de imágenes frente a digests

Un tag puede moverse a otra imagen. Un digest identifica el contenido concreto. Por eso los tags son cómodos para humanos y los digests son útiles cuando necesitas fijar exactamente qué se ejecuta.

docker pull nginx:1.27-alpine
docker image ls nginx --digests
docker image inspect nginx:1.27-alpine --format '{{json .RepoTags}} {{json .RepoDigests}}' 

En muchos flujos prácticos usarás tags explícitos durante desarrollo y digests en pipelines más estrictos. Lo importante es saber que no son lo mismo.

Crear una etiqueta local

docker tag no copia la imagen completa. Crea otra referencia local que apunta al mismo contenido. Es útil antes de subir una imagen a un registry propio o para organizar laboratorios.

docker tag nginx:1.27-alpine mi-nginx:laboratorio
docker image ls mi-nginx
docker image rm mi-nginx:laboratorio

Qué debes observar

  • La imagen aparece con otro repositorio o tag, pero comparte ID.
  • Borrar una etiqueta no siempre borra las capas si quedan otras referencias.
  • Para publicar en un registry, el tag de destino debe incluir el registry y namespace correctos.

Tags de imágenes en Dockerfiles

El tag de la imagen base afecta a los builds. Si usas latest, el mismo Dockerfile puede resolver a otra imagen en otro momento. Elegir una versión o variante explícita reduce cambios inesperados, pero tampoco garantiza inmutabilidad: el mantenedor puede mover ese tag. Para repetir exactamente la misma imagen, fija un digest y actualízalo de forma deliberada.

# Evita depender de esto en producción o CI reproducible
FROM node:latest

# Tag explícito: reduce cambios, pero sigue siendo mutable
FROM node:22-bookworm-slim

Errores comunes con tags de imágenes

  • Pensar que latest siempre es la última versión estable.
  • Creer que un tag nunca cambia.
  • Confundir tag con digest.
  • Etiquetar una imagen local y pensar que ya está subida al registry.
  • Usar tags demasiado genéricos en CI o producción.
  • No documentar qué convención de tags usa tu equipo.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

Dominar qué son los tags de imágenes te ayuda a trabajar con Docker de forma más ordenada. Un buen tag comunica versión, variante y propósito; un digest fija contenido cuando necesitas máxima reproducibilidad.

Como regla práctica: evita latest en proyectos serios, usa tags explícitos en Dockerfiles y apóyate en digests cuando quieras garantizar exactamente qué imagen se descarga o despliega.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *