docker image history
| 描述 | 顯示映象歷史 |
|---|---|
| 用法 | docker image history [OPTIONS] IMAGE |
| 別名 | docker history |
描述
顯示映象歷史
選項
| 選項 | 預設值 | 描述 |
|---|---|---|
--format | 使用自定義模板格式化輸出 'table': 以帶列標題的表格格式列印輸出（預設） 'table TEMPLATE': 使用給定的 Go 模板以表格格式列印輸出 'json': 以 JSON 格式列印 'TEMPLATE': 使用給定的 Go 模板列印輸出。 有關使用模板格式化輸出的更多資訊，請參閱https://docs.docker.net.tw/go/formatting/ | |
-H, --human | true | 以人類可讀的格式列印大小和日期 |
--no-trunc | 不截斷輸出 | |
--platform | API 1.48+ 顯示給定平臺的歷史。格式為 os[/arch[/variant]]（例如，linux/amd64） | |
-q, --quiet | 僅顯示映象 ID |
示例
檢視 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 -
檢視 docker:apache 映象是如何新增到容器的基礎映象的
$ 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 -
格式化輸出 (--format)
格式化選項 (--format) 將使用 Go 模板美觀地列印歷史輸出。
Go 模板的有效佔位符如下所示
| 佔位符 | 描述 |
|---|---|
.ID | 映象 ID |
.CreatedSince | 如果 --human=true，則為自映象建立以來的時間，否則為映象建立時的時間戳 |
.CreatedAt | 映象建立時的時間戳 |
.CreatedBy | 用於建立映象的命令 |
.Size | 映象磁碟大小 |
.Comment | 映象評論 |
當使用 --format 選項時，history 命令要麼完全按照模板宣告輸出資料，要麼在使用 table 指令時包含列標題。
以下示例使用不帶標題的模板，並輸出 busybox 映象的 ID 和 CreatedSince 條目，兩者之間用冒號 (:) 分隔
$ docker history --format "{{.ID}}: {{.CreatedSince}}" busybox
f6e427c148a7: 4 weeks ago
<missing>: 4 weeks ago
顯示特定平臺的歷史記錄 (--platform)
如果存在多個平臺，--platform 選項允許您指定要顯示哪個平臺變體的歷史記錄。預設情況下，docker history 顯示守護程式的原生平臺的歷史記錄，如果不存在，則顯示第一個可用平臺的歷史記錄。
如果本地映象儲存有映象的多個平臺變體，--platform 選項會選擇要顯示哪個變體的歷史記錄。如果給定的平臺不存在於本地映象快取中，則會產生錯誤。
平臺選項採用 os[/arch[/variant]] 格式；例如，linux/amd64 或 linux/arm64/v8。架構和變體是可選的，如果省略，則回退到守護程式的預設值。
以下示例拉取 alpine:latest 映象的 RISC-V 變體並顯示其歷史記錄。
$ 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
以下示例嘗試顯示 alpine:latest 平臺變體的歷史記錄，該變體不存在於本地映象儲存中，從而導致錯誤。
$ 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