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: 'table': Imprime la salida en formato de tabla con encabezados de columna (por defecto) 'table TEMPLATE': Imprime la salida en formato de tabla utilizando la plantilla Go provista 'json': Imprime en formato JSON 'TEMPLATE': Imprime la salida utilizando la plantilla Go provista. 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) | |
-q, --quiet | Solo muestra los IDs de las imágenes |
Ejemplos
Para ver cómo se construyó la imagen docker:latest:
$ 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:
$ 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)
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:
$ docker history --format "{{.ID}}: {{.CreatedSince}}" busybox
f6e427c148a7: 4 weeks ago
<missing>: 4 weeks ago
Mostrar el historial para una plataforma específica (--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.
$ 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.
$ 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