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| Parte | Ejemplo | Significado |
|---|---|---|
| Repositorio | nginx | Nombre de la imagen. |
| Tag | 1.27-alpine | Versión o variante seleccionada. |
| Registry | ghcr.io | Servidor donde vive la imagen. |
| Namespace | mi-org | Organización o espacio del registry. |
| Digest | sha256:… | 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:laboratorioQué 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-slimErrores 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
- Cómo descargar imágenes Docker: practica pull y digests.
- Cómo elegir una buena imagen base Docker: elige tags de base con criterio.
- Docker Hub: entiende repositorios y publicación.
- Cómo ejecutar un contenedor en Docker: usa tags al crear contenedores.
Documentación oficial y recursos
- docker image tag reference: referencia oficial para crear tags.
- docker image pull reference: descargar imágenes por tag o digest.
- docker image inspect reference: ver RepoTags y RepoDigests.
- Build, tag and publish an image: guía oficial para construir, etiquetar y publicar.
- Manage tags on Docker Hub: gestión de tags en Docker Hub.
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.

