# 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:

```text
[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](https://pkg.go.dev/github.com/distribution/reference#pkg-overview)
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`:

```console
$ 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`:

```console
$ 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`:

```console
$ 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).

```console
$ docker tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0
```