# docker image history

**Descripción:** Muestra el historial de una imagen

**Uso:** `docker image history [OPTIONS] IMAGE`

**Alias:** `docker history`








## Descripción

Muestra el historial de una imagen


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--format` |  |  Formatea la salida utilizando una plantilla personalizada:<br>'table':            Imprime la salida en formato de tabla con encabezados de columna (por defecto)<br>'table TEMPLATE':   Imprime la salida en formato de tabla utilizando la plantilla Go provista<br>'json':             Imprime en formato JSON<br>'TEMPLATE':         Imprime la salida utilizando la plantilla Go provista.<br>Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo dar formato a la salida con plantillas |

 | `-H`, `--human` | `true` |  Imprime tamaños y fechas en un formato legible para humanos |

 | `--no-trunc` |  |  No trunca la salida |

 | `--platform` |  | API 1.48+ Muestra el historial para la plataforma provista. Formateado como `os[/arch[/variant]]` (por ejemplo, `linux/amd64`)<br> |

 | `-q`, `--quiet` |  |  Solo muestra los IDs de las imágenes |




## Ejemplos

Para ver cómo se construyó la imagen `docker:latest`:

```console
$ docker history docker

IMAGE               CREATED             CREATED BY                                      SIZE                COMMENT
3e23a5875458        8 days ago          /bin/sh -c #(nop) ENV LC_ALL=C.UTF-8            0 B
8578938dd170        8 days ago          /bin/sh -c dpkg-reconfigure locales &&    loc   1.245 MB
be51b77efb42        8 days ago          /bin/sh -c apt-get update && apt-get install    338.3 MB
4b137612be55        6 weeks ago         /bin/sh -c #(nop) ADD jessie.tar.xz in /        121 MB
750d58736b4b        6 weeks ago         /bin/sh -c #(nop) MAINTAINER Tianon Gravi <ad   0 B
511136ea3c5a        9 months ago                                                        0 B                 Imported from -
```

Para ver cómo se agregó la imagen `docker:apache` a la imagen base de un contenedor:

```console
$ docker history docker:scm
IMAGE               CREATED             CREATED BY                                      SIZE                COMMENT
2ac9d1098bf1        3 months ago        /bin/bash                                       241.4 MB            Added Apache to Fedora base image
88b42ffd1f7c        5 months ago        /bin/sh -c #(nop) ADD file:1fd8d7f9f6557cafc7   373.7 MB
c69cab00d6ef        5 months ago        /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar   0 B
511136ea3c5a        19 months ago                                                       0 B                 Imported from -
```

### Formatear la salida (--format) {#format}

La opción de formato (`--format`) imprime de forma estética la salida del historial
utilizando una plantilla Go.

A continuación se enumeran los marcadores de posición válidos para la plantilla Go:

| Marcador de posición | Descripción                                                                                               |
|----------------------|-----------------------------------------------------------------------------------------------------------|
| `.ID`                | ID de la imagen                                                                                           |
| `.CreatedSince`      | Tiempo transcurrido desde que se creó la imagen si `--human=true`, de lo contrario, marca de tiempo de creación |
| `.CreatedAt`         | Marca de tiempo de cuándo se creó la imagen                                                                |
| `.CreatedBy`         | Comando que se utilizó para crear la imagen                                                               |
| `.Size`              | Tamaño de disco de la imagen                                                                              |
| `.Comment`           | Comentario de la imagen                                                                                   |

Cuando se utiliza la opción `--format`, el comando `history` escribe
los datos exactamente como lo declara la plantilla o, cuando se utiliza la
directiva `table`, incluye también los encabezados de las columnas.

El siguiente ejemplo utiliza una plantilla sin encabezados y escribe las
entradas `ID` y `CreatedSince` separadas por dos puntos (`:`) para la imagen `busybox`:

```console
$ docker history --format "{{.ID}}: {{.CreatedSince}}" busybox

f6e427c148a7: 4 weeks ago
<missing>: 4 weeks ago
```

### Mostrar el historial para una plataforma específica (--platform) {#platform}

La opción `--platform` te permite especificar para qué variante de plataforma deseas mostrar
el historial si hay múltiples plataformas presentes. Por defecto, `docker history`
muestra el historial de la plataforma nativa del demonio o, si no está presente, de la
primera plataforma disponible.

Si el almacén de imágenes local tiene múltiples variantes de plataforma de una imagen, la
opción `--platform` selecciona de qué variante mostrar el historial. Se produce un error
si la plataforma dada no está presente en la caché de imágenes local.

La opción de plataforma toma el formato `os[/arch[/variant]]`; por ejemplo,
`linux/amd64` o `linux/arm64/v8`. La arquitectura y la variante son opcionales
y, si se omiten, se recurre a los valores predeterminados del demonio.

El siguiente ejemplo descarga la variante RISC-V de la imagen `alpine:latest`
y muestra su historial.

```console
$ docker image pull --quiet --platform=linux/riscv64 alpine
docker.io/library/alpine:latest

$ docker image history --platform=linux/s390x alpine
IMAGE          CREATED       CREATED BY                                      SIZE      COMMENT
beefdbd8a1da   3 weeks ago   /bin/sh -c #(nop)  CMD ["/bin/sh"]              0B
<missing>      3 weeks ago   /bin/sh -c #(nop) ADD file:ba2637314e600db5a…   8.46MB
```

El siguiente ejemplo intenta mostrar el historial de una variante de plataforma de
`alpine:latest` que no existe en el almacén de imágenes local, lo que resulta en
un error.

```console
$ docker image ls --tree
IMAGE                   ID             DISK USAGE   CONTENT SIZE   IN USE
alpine:latest           beefdbd8a1da       10.6MB         3.37MB
├─ linux/riscv64        80cde017a105       10.6MB         3.37MB
├─ linux/amd64          33735bd63cf8           0B             0B
├─ linux/arm/v6         50f635c8b04d           0B             0B
├─ linux/arm/v7         f2f82d424957           0B             0B
├─ linux/arm64/v8       9cee2b382fe2           0B             0B
├─ linux/386            b3e87f642f5c           0B             0B
├─ linux/ppc64le        c7a6800e3dc5           0B             0B
└─ linux/s390x          2b5b26e09ca2           0B             0B

$ docker image history --platform=linux/s390x alpine
Error response from daemon: image with reference alpine:latest was found but does not match the specified platform: wanted linux/s390x
```