docker image history
| 說明 | 顯示映像檔的歷史記錄 |
|---|---|
| 用法 | docker image history [選項] 映像檔 |
| 別名 | docker history |
說明
顯示映像檔的歷史記錄
選項
| 選項 | 預設值 | 說明 |
|---|---|---|
--format | 使用自訂範本格式化輸出 'table': 以表格格式列印輸出，包含欄位標題（預設） 'table TEMPLATE': 使用指定的 Go 範本以表格格式列印輸出 'json': 以 JSON 格式列印 'TEMPLATE': 使用指定的 Go 範本列印輸出。 參考 https://docker-docs.dev.org.tw/go/formatting/ | |
--no-trunc | 不要截斷輸出 | |
-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