docker attach
Table of Contents:
Command Name:
docker history
Description:
Show the history of an image.
Syntax:
easywhatis$ docker history --help
Usage: docker history [OPTIONS] IMAGE
Show the history of an image
Options:
--format string Pretty-print images using a Go template
-H, --human Print sizes and dates in human readable format (default true)
--no-trunc Don't truncate output
-q, --quiet Only show numeric IDs
easywhatis$
Example:
easywhatis$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
nginx latest ed21b7a8aee9 12 days ago 127MB
ubuntu latest 4e5021d210f6 3 weeks ago 64.2MB
busybox latest 83aa35aa1c79 4 weeks ago 1.22MB
easywhatis$ docker history ubuntu --no-trunc
IMAGE CREATED CREATED BY SIZE COMMENT
sha256:4e5021d210f65ebe915670c7089120120bc0a303b90208592851708c1b8c04bd 3 weeks ago /bin/sh -c #(nop) CMD ["/bin/bash"] 0B
<missing> 3 weeks ago /bin/sh -c mkdir -p /run/systemd && echo 'docker' > /run/systemd/container 7B
<missing> 3 weeks ago /bin/sh -c set -xe && echo '#!/bin/sh' > /usr/sbin/policy-rc.d && echo 'exit 101' >> /usr/sbin/policy-rc.d && chmod +x /usr/sbin/policy-rc.d && dpkg-divert --local --rename --add /sbin/initctl && cp -a /usr/sbin/policy-rc.d /sbin/initctl && sed -i 's/^exit.*/exit 0/' /sbin/initctl && echo 'force-unsafe-io' > /etc/dpkg/dpkg.cfg.d/docker-apt-speedup && echo 'DPkg::Post-Invoke { "rm -f /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin || true"; };' > /etc/apt/apt.conf.d/docker-clean && echo 'APT::Update::Post-Invoke { "rm -f /var/cache/apt/archives/*.deb /var/cache/apt/archives/partial/*.deb /var/cache/apt/*.bin || true"; };' >> /etc/apt/apt.conf.d/docker-clean && echo 'Dir::Cache::pkgcache ""; Dir::Cache::srcpkgcache "";' >> /etc/apt/apt.conf.d/docker-clean && echo 'Acquire::Languages "none";' > /etc/apt/apt.conf.d/docker-no-languages && echo 'Acquire::GzipIndexes "true"; Acquire::CompressionTypes::Order:: "gz";' > /etc/apt/apt.conf.d/docker-gzip-indexes && echo 'Apt::AutoRemove::SuggestsImportant "false";' > /etc/apt/apt.conf.d/docker-autoremove-suggests 745B
<missing> 3 weeks ago /bin/sh -c [ -z "$(apt-get indextargets)" ] 987kB
<missing> 3 weeks ago /bin/sh -c #(nop) ADD file:594fa35cf803361e69d817fc867b6a4069c064ffd20ed50caf42ad9bb11ca999 in / 63.2MB
easywhatis$
easywhatis$ docker history ubuntu
IMAGE CREATED CREATED BY SIZE COMMENT
4e5021d210f6 3 weeks ago /bin/sh -c #(nop) CMD ["/bin/bash"] 0B
<missing> 3 weeks ago /bin/sh -c mkdir -p /run/systemd && echo 'do... 7B
<missing> 3 weeks ago /bin/sh -c set -xe && echo '#!/bin/sh' > /... 745B
<missing> 3 weeks ago /bin/sh -c [ -z "$(apt-get indextargets)" ] 987kB
<missing> 3 weeks ago /bin/sh -c #(nop) ADD file:594fa35cf803361e6... 63.2MB
easywhatis$
Format the output:
Sometimes we need to format the output in human readable format.
(–format) will be useful in that case.
The formatting option (–format) will pretty-prints history output using a Go template.
There are few placeholders which we can use and those are as go templates standards.
Placeholders Description
.ID Image ID
.CreatedSince Created Since
.CreatedAt Created At
.CreatedBy Created By
.Size Image Size
.Comment Image Comment
easywhatis$ docker history --format "{{.ID}}: {{.CreatedSince}}" ubuntu
4e5021d210f6: 3 weeks ago
<missing>: 3 weeks ago
<missing>: 3 weeks ago
<missing>: 3 weeks ago
<missing>: 3 weeks ago
easywhatis$ docker history --format "{{.ID}}-- {{.CreatedSince}}" ubuntu
4e5021d210f6-- 3 weeks ago
<missing>-- 3 weeks ago
<missing>-- 3 weeks ago
<missing>-- 3 weeks ago
<missing>-- 3 weeks ago
easywhatis$ docker history --format "Image ID - {{.ID}}, Created Since -- {{.CreatedSince}}" ubuntu
Image ID - 4e5021d210f6, Created Since -- 3 weeks ago
Image ID - <missing>, Created Since -- 3 weeks ago
Image ID - <missing>, Created Since -- 3 weeks ago
Image ID - <missing>, Created Since -- 3 weeks ago
Image ID - <missing>, Created Since -- 3 weeks ago
easywhatis$ docker history --format "Image ID - {{.ID}}, Created Since -- {{.CreatedSince}}, Created At => {{.CreatedAt}}" ubuntu
Image ID - 4e5021d210f6, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:20+05:30
easywhatis$ docker history --format "Image ID - {{.ID}}, Created Since -- {{.CreatedSince}}, Created At => {{.CreatedAt}} || {{.CreatedBy}}" ubuntu
Image ID - 4e5021d210f6, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c #(nop) CMD ["/bin/bash"]
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c mkdir -p /run/systemd && echo 'do...
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 || /bin/sh -c set -xe && echo '#!/bin/sh' > /...
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 ||
/bin/sh -c [ -z "$(apt-get indextargets)" ]
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:20+05:30 || /bin/sh -c #(nop) ADD file:594fa35cf803361e6...
easywhatis$ docker history --format "Image ID - {{.ID}}, Created Since -- {{.CreatedSince}}, Created At => {{.CreatedAt}} || {{.CreatedBy}} ## size = {{.Size}}" ubuntu
Image ID - 4e5021d210f6, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c #(nop) CMD ["/bin/bash"] ## size = 0B
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c mkdir -p /run/systemd && echo 'do... ## size = 7B
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 || /bin/sh -c set -xe && echo '#!/bin/sh' > /... ## size = 745B
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 || /bin/sh -c [ -z "$(apt-get indextargets)" ] ## size = 987kB
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:20+05:30 || /bin/sh -c #(nop) ADD file:594fa35cf803361e6... ## size = 63.2MB
easywhatis$ docker history --format "Image ID - {{.ID}}, Created Since -- {{.CreatedSince}}, Created At => {{.CreatedAt}} || {{.CreatedBy}} ## size = {{.Size}} || Comments {{.Comment}}" ubuntu
Image ID - 4e5021d210f6, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c #(nop) CMD ["/bin/bash"] ## size = 0B || Comments
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c mkdir -p /run/systemd && echo 'do... ## size = 7B || Comments
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 || /bin/sh -c set -xe && echo '#!/bin/sh' > /... ## size = 745B || Comments
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 || /bin/sh -c [ -z "$(apt-get indextargets)" ] ## size = 987kB || Comments
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:20+05:30 || /bin/sh -c #(nop) ADD file:594fa35cf803361e6... ## size = 63.2MB || Comments
easywhatis$ docker history --format "Image ID - {{.ID}}, Created Since -- {{.CreatedSince}}, Created At => {{.CreatedAt}} || {{.CreatedBy}} ## size = {{.Size}} || Comments: {{.Comment}}" ubuntu
Image ID - 4e5021d210f6, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c #(nop) CMD ["/bin/bash"] ## size = 0B || Comments:
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:22+05:30 || /bin/sh -c mkdir -p /run/systemd && echo 'do... ## size = 7B || Comments:
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 || /bin/sh -c set -xe && echo '#!/bin/sh' > /... ## size = 745B || Comments:
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:21+05:30 || /bin/sh -c [ -z "$(apt-get indextargets)" ] ## size = 987kB || Comments:
Image ID - <missing>, Created Since -- 3 weeks ago, Created At => 2020-03-21T00:50:20+05:30 || /bin/sh -c #(nop) ADD file:594fa35cf803361e6... ## size = 63.2MB || Comments:
easywhatis$