El comando docker tag
permite asignar una nueva etiqueta (tag) a una imagen de Docker existente, sin duplicarla. Esto es útil cuando necesitas organizar imágenes en diferentes versiones o asociarlas a un repositorio específico, facilitando su administración y despliegue.
docker tag
La sintaxis básica de docker tag
es la siguiente:
docker tag <imagen_origen> <nombre_destino:tag>
Parámetro | Descripción |
---|---|
<imagen_origen>
|
ID o nombre de la imagen existente que quieres etiquetar. |
<nombre_destino>
|
Nuevo nombre de la imagen con el formato nombre_imagen:tag .
|
tag
|
(Opcional) Etiqueta específica de la imagen (por ejemplo, latest o v1 ).
|
docker tag
1. Agregar una etiqueta a una imagen local:
Si tienes una imagen local llamada mi_app
sin ninguna etiqueta, puedes asignarle la etiqueta v1
de la siguiente manera:
docker tag mi_app mi_app:v1
2. Renombrar y etiquetar una imagen para prepararla para un repositorio:
Supongamos que tienes una imagen con el ID 123abc
y quieres prepararla para subirla a Docker Hub en un repositorio llamado usuario/mi_app
, etiquetándola como v2
:
docker tag 123abc usuario/mi_app:v2
3. Cambiar una etiqueta de latest a una versión específica:
Si tienes una imagen mi_app:latest
y quieres asignarle la etiqueta v1.0
, puedes hacer lo siguiente:
docker tag mi_app:latest mi_app:v1.0
4. Mover una imagen entre repositorios:
Puedes etiquetar una imagen existente para subirla a otro repositorio. Por ejemplo, si tienes mi_app:v1
en tu repositorio personal, y necesitas subirla al repositorio de tu organización empresa
, puedes hacer lo siguiente:
docker tag mi_app:v1 empresa/mi_app:v1
tag
) es opcional, pero es recomendable para diferenciar versiones. Si no se especifica, Docker asignará automáticamente latest
.
Para más detalles sobre docker tag
, puedes consultar la documentación oficial de Docker.
Jorge García
Fullstack developer