docker image tag
| Descripción | Crea una etiqueta IMAGEN_OBJETIVO que refiera a IMAGEN_ORIGEN |
|---|---|
| Uso | docker image tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG] |
| Alias | docker tag |
Descripción
Una referencia de imagen de Docker consta de varios componentes que describen dónde se almacena la imagen y su identidad. Estos componentes son:
[HOST[:PORT]/]NAMESPACE/REPOSITORY[:TAG]HOST- Especifica la ubicación del registro donde reside la imagen. Si se omite, Docker
toma por defecto Docker Hub (
docker.io). PORT- Un número de puerto opcional para el registro, si es necesario (por ejemplo,
:5000). NAMESPACE/REPOSITORY- El espacio de nombres (namespace, opcional) suele representar a un usuario u organización. El
repositorio (repository) es obligatorio e identifica la imagen específica. Si se omite el
espacio de nombres, Docker toma por defecto
library, el espacio de nombres reservado para las Imágenes Oficiales de Docker. TAG- Un identificador opcional utilizado para especificar una versión o variante particular de la
imagen. Si no se proporciona ninguna etiqueta, Docker toma por defecto
latest.
Ejemplos de referencias de imágenes
example.com:5000/team/my-app:2.0
- Host:
example.com - Puerto:
5000 - Espacio de nombres:
team - Repositorio:
my-app - Etiqueta:
2.0
alpine
- Host:
docker.io(por defecto) - Espacio de nombres:
library(por defecto) - Repositorio:
alpine - Etiqueta:
latest(por defecto)
Para obtener más información sobre la estructura y las reglas de nomenclatura de imágenes, consulta la referencia de Distribución como la definición canónica del formato.
Ejemplos
Etiquetar una imagen referenciada por su ID
Para etiquetar una imagen local con ID 0e5574283393 como fedora/httpd con la etiqueta
version1.0:
$ docker tag 0e5574283393 fedora/httpd:version1.0
Etiquetar una imagen referenciada por su Nombre
Para etiquetar una imagen local httpd como fedora/httpd con la etiqueta version1.0:
$ docker tag httpd fedora/httpd:version1.0
Ten en cuenta que dado que no se especifica el nombre de la etiqueta, el alias se crea para la
versión local existente httpd:latest.
Etiquetar una imagen referenciada por Nombre y Etiqueta
Para etiquetar una imagen local con el nombre httpd y la etiqueta test como fedora/httpd
con la etiqueta version1.0.test:
$ docker tag httpd:test fedora/httpd:version1.0.test
Etiquetar una imagen para un registro privado
Para subir una imagen a un registro privado y no al registro público de Docker, debes incluir el nombre de host y el puerto del registro (si es necesario).
$ docker tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0