mirror of
https://github.com/yeasy/docker_practice.git
synced 2026-08-10 08:27:25 +00:00
yeasy
51698c89c5
均为书内自证的矛盾，无需外部来源： - 19.3: golang:1.26-alpine 标注为 ~1GB，但 21.7 将 ~900MB 归给非 alpine 的 golang:1.26，且 7.17 实测 alpine 版镜像为 295MB——alpine 变体不可能大于其 非 alpine 版本。改为与 21.7 一致的「golang:1.26 基础镜像的 ~900MB」。 - 20_cases_os: 正文称通用镜像 100-300 MB，紧邻的表格却列 Ubuntu ~80 MB （与 4.2 的 ubuntu 24.04 78MB 一致）。正文改为 80-300 MB。 - 4.2: 「查找大于 500MB 的镜像」的 ^[0-9]+GB 不匹配小数，会漏掉 docker 实际 输出的全部 x.yGB（本书自己的示例即为 2.5GB）。补充可选小数部分。 - 6.2: docker image ls 示例输出把 tag 混入 REPOSITORY 列 （127.0.0.1:5000/ubuntu:latest + TAG latest），与同块 ubuntu/latest 行及 本节自述的 tag 格式不符。 - 5.3: 生命周期状态图缺 Stopped --> Running，而 5.3.6 正是讲 docker start 启动已停止的容器；原图中停止的容器只能被删除。 - 9.5: 端口映射图节点标签 "容器 (Class B: 80)" 语义错乱（Class B 是 IP 地址 分类，与端口无关），改为「容器 (端口: 80)」。 - appendix/faq/errors.md: 标题「常见错误速查表」与 SUMMARY.md 及 faq/README 两处链接文字「常见错误处理」不一致（全书 196 篇中唯一一处标题漂移）。
262 lines
6.7 KiB
Go
262 lines
6.7 KiB
Go
## 4.2 列出镜像
|
||
|
||
在下载了镜像后，我们可以使用 `docker image ls` 命令列出本地主机上的镜像。
|
||
|
||
### 4.2.1 基本用法
|
||
|
||
查看本地已下载的镜像：
|
||
|
||
```bash
|
||
$ docker image ls
|
||
REPOSITORY TAG IMAGE ID CREATED SIZE
|
||
redis latest 5f515359c7f8 5 days ago 183MB
|
||
nginx latest 05a60462f8ba 5 days ago 181MB
|
||
ubuntu 24.04 329ed837d508 3 days ago 78MB
|
||
ubuntu noble 329ed837d508 3 days ago 78MB
|
||
```
|
||
> 💡 `docker images` 是 `docker image ls` 的简写，两者等效。
|
||
|
||
---
|
||
|
||
### 4.2.2 输出字段说明
|
||
|
||
`docker image ls` 命令默认输出的列表包含仓库名、标签、镜像 ID、创建时间和占用空间等信息。
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| **REPOSITORY** | 仓库名 |
|
||
| **TAG** | 标签 (版本)|
|
||
| **IMAGE ID** | 镜像唯一标识 (短 ID，前 12 位)|
|
||
| **CREATED** | 创建时间 |
|
||
| **SIZE** | 本地占用空间 |
|
||
|
||
#### 同一镜像多个标签
|
||
|
||
注意上面的 `ubuntu:24.04` 和 `ubuntu:noble` 拥有相同的 IMAGE ID——它们是同一个镜像的不同标签，只占用一份存储空间。
|
||
|
||
> **版本说明**：`ubuntu:24.04` 是具体版本号，`ubuntu:noble` 是发布代号（Ubuntu 24.04 的代号）。在 Dockerfile 中应优先使用版本号（如 `ubuntu:24.04`）而非发布代号，因为版本号在将来更易理解。
|
||
|
||
---
|
||
|
||
### 4.2.3 理解镜像大小
|
||
|
||
Docker 镜像的大小可能与我们通常理解的文件大小有所不同，这涉及到分层存储的概念。
|
||
|
||
#### 本地大小 vs Hub 显示大小
|
||
|
||
| 位置 | 显示大小 | 说明 |
|
||
|------|---------|------|
|
||
| Docker Hub | 29MB | 压缩后的网络传输大小 |
|
||
| docker image ls | 78MB | 本地解压后的实际大小 |
|
||
|
||
#### 实际磁盘占用
|
||
|
||
由于镜像是分层存储，不同镜像可能共享相同的层：
|
||
|
||
```bash
|
||
ubuntu:24.04 nginx:latest redis:latest
|
||
│ │ │
|
||
└───────┬───────┘ │
|
||
▼ │
|
||
共享基础层 ◄───────────────────┘
|
||
```
|
||
因此，`docker image ls` 中各镜像大小之和 > 实际磁盘占用。
|
||
|
||
#### 查看实际空间占用
|
||
|
||
```bash
|
||
$ docker system df
|
||
TYPE TOTAL ACTIVE SIZE RECLAIMABLE
|
||
Images 15 3 2.5GB 1.8GB (72%)
|
||
Containers 5 2 100MB 80MB (80%)
|
||
Local Volumes 8 2 500MB 400MB (80%)
|
||
Build Cache 0 0 0B 0B
|
||
```
|
||
---
|
||
|
||
### 4.2.4 过滤镜像
|
||
|
||
随着本地镜像数量的增加，我们需要更有效的方式来查找特定的镜像。Docker 提供了多种过滤方式。
|
||
|
||
#### 按仓库名过滤
|
||
|
||
```bash
|
||
## 列出所有 ubuntu 镜像
|
||
|
||
$ docker images ubuntu
|
||
REPOSITORY TAG IMAGE ID SIZE
|
||
ubuntu 24.04 329ed837d508 78MB
|
||
ubuntu noble 329ed837d508 78MB
|
||
ubuntu 22.04 a1b2c3d4e5f6 72MB
|
||
```
|
||
|
||
#### 按仓库名和标签过滤
|
||
|
||
```bash
|
||
$ docker images ubuntu:24.04
|
||
REPOSITORY TAG IMAGE ID SIZE
|
||
ubuntu 24.04 329ed837d508 78MB
|
||
```
|
||
|
||
#### 使用过滤器 --filter
|
||
|
||
| 过滤条件 | 说明 | 示例 |
|
||
|---------|------|------|
|
||
| `dangling=true` | 虚悬镜像 | `-f dangling=true` |
|
||
| `before=镜像` | 在某镜像之前创建 | `-f before=nginx:latest` |
|
||
| `since=镜像` | 在某镜像之后创建 | `-f since=nginx:latest` |
|
||
| `label=key=value` | 按 LABEL 过滤 | `-f label=version=1.0` |
|
||
| `reference=pattern` | 按名称模式 | `-f reference='*:latest'` |
|
||
|
||
```bash
|
||
## 列出 nginx 之后创建的镜像
|
||
|
||
$ docker images -f since=nginx:latest
|
||
|
||
## 列出所有带 latest 标签的镜像
|
||
|
||
$ docker images -f reference='*:latest'
|
||
|
||
## 列出带特定 LABEL 的镜像
|
||
|
||
$ docker images -f label=maintainer=example@email.com
|
||
```
|
||
---
|
||
|
||
### 4.2.5 虚悬镜像
|
||
|
||
在镜像列表里，你可能会看到一些仓库名和标签都为 `<none>` 的镜像，这类镜像被称为虚悬镜像。
|
||
|
||
#### 什么是虚悬镜像
|
||
|
||
仓库名和标签都显示为 `<none>` 的镜像：
|
||
|
||
```bash
|
||
$ docker images
|
||
REPOSITORY TAG IMAGE ID SIZE
|
||
<none> <none> 00285df0df87 342MB
|
||
```
|
||
|
||
#### 产生原因
|
||
|
||
1. **镜像重新构建**：新镜像使用了旧镜像的标签，旧镜像标签被移除
|
||
2. **docker pull 更新**：拉取更新版本时，旧版本失去标签
|
||
|
||
#### 处理虚悬镜像
|
||
|
||
```bash
|
||
## 列出虚悬镜像
|
||
|
||
$ docker images -f dangling=true
|
||
|
||
## 删除虚悬镜像
|
||
|
||
$ docker image prune
|
||
```
|
||
---
|
||
|
||
### 4.2.6 中间层镜像
|
||
|
||
除了虚悬镜像，`docker image ls` 默认列出的只是顶层镜像。还有一种镜像是为了加速镜像构建、重复利用资源而存在的中间层镜像。
|
||
|
||
#### 查看所有镜像：包含中间层
|
||
|
||
```bash
|
||
$ docker images -a
|
||
```
|
||
会显示很多无标签镜像——这些是构建过程中产生的中间层，被其他镜像依赖。
|
||
|
||
> ⚠️ 不要删除中间层镜像。它们是其他镜像的依赖，删除会导致上层镜像无法使用。删除顶层镜像时会自动清理不再需要的中间层。
|
||
|
||
---
|
||
|
||
### 4.2.7 格式化输出
|
||
|
||
为了配合脚本使用或展示更关注的信息，我们可以使用 `--format` 参数来自定义输出格式。
|
||
|
||
#### 只输出 ID
|
||
|
||
```bash
|
||
$ docker images -q
|
||
5f515359c7f8
|
||
05a60462f8ba
|
||
329ed837d508
|
||
```
|
||
常用于配合其他命令：
|
||
|
||
```bash
|
||
## 删除所有镜像
|
||
|
||
$ docker rmi $(docker images -q)
|
||
|
||
## 删除所有 redis 镜像
|
||
|
||
$ docker rmi $(docker images -q redis)
|
||
```
|
||
|
||
#### 显示完整 ID
|
||
|
||
```bash
|
||
$ docker images --no-trunc
|
||
```
|
||
|
||
#### 显示摘要
|
||
|
||
```bash
|
||
$ docker images --digests
|
||
REPOSITORY TAG DIGEST IMAGE ID
|
||
nginx latest sha256:b4f0e0bdeb5... e43d811ce2f4
|
||
```
|
||
|
||
#### 自定义格式
|
||
|
||
使用 Go 模板语法自定义输出：
|
||
|
||
```bash
|
||
## 只显示 ID 和仓库名
|
||
|
||
$ docker images --format "{{.ID}}: {{.Repository}}"
|
||
5f515359c7f8: redis
|
||
05a60462f8ba: nginx
|
||
329ed837d508: ubuntu
|
||
|
||
## 表格形式（带标题）
|
||
|
||
$ docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"
|
||
REPOSITORY TAG SIZE
|
||
redis latest 183MB
|
||
nginx latest 181MB
|
||
ubuntu 24.04 78MB
|
||
```
|
||
|
||
#### 可用模板字段
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `.ID` | 镜像 ID |
|
||
| `.Repository` | 仓库名 |
|
||
| `.Tag` | 标签 |
|
||
| `.Digest` | 摘要 |
|
||
| `.CreatedSince` | 创建后经过的时间 |
|
||
| `.CreatedAt` | 创建时间 |
|
||
| `.Size` | 大小 |
|
||
|
||
---
|
||
|
||
### 4.2.8 常用命令组合
|
||
|
||
```bash
|
||
## 列出所有镜像及其大小，按大小排序（需要系统 sort 命令）
|
||
|
||
$ docker images --format "{{.Size}}\t{{.Repository}}:{{.Tag}}" | sort -h
|
||
|
||
## 查找大于 500MB 的镜像
|
||
|
||
$ docker images --format "{{.Size}}\t{{.Repository}}:{{.Tag}}" | grep -E "^[0-9]+(\.[0-9]+)?GB|^[5-9][0-9]{2}MB"
|
||
|
||
## 导出镜像列表
|
||
|
||
$ docker images --format "{{.Repository}}:{{.Tag}}" > images.txt
|
||
```
|
||
---
|