Release v1.5.0: Restructure chapters and update for Docker v30.x

04_image/rm.md

@@ -0,0 +1,255 @@
+# 删除本地镜像
+
+## 基本用法
+
+使用 `docker image rm` 删除本地镜像：
+
+```bash
+$ docker image rm [选项] <镜像1> [<镜像2> ...]
+```
+
+> 💡 `docker rmi` 是 `docker image rm` 的简写，两者等效。
+
+---
+
+## 镜像标识方式
+
+删除镜像时，可以使用多种方式指定镜像：
+
+| 方式 | 说明 | 示例 |
+|------|------|------|
+| **短 ID** | ID 的前几位（通常 3-4 位） | `docker rmi 501` |
+| **长 ID** | 完整的镜像 ID | `docker rmi 501ad78535f0...` |
+| **镜像名:标签** | 仓库名和标签 | `docker rmi redis:alpine` |
+| **镜像摘要** | 精确的内容摘要 | `docker rmi nginx@sha256:...` |
+
+### 使用短 ID 删除
+
+```bash
+$ docker image ls
+REPOSITORY   TAG     IMAGE ID       SIZE
+redis        alpine  501ad78535f0   30MB
+nginx        latest  e43d811ce2f4   142MB
+
+# 只需输入足够区分的前几位
+$ docker rmi 501
+Untagged: redis:alpine
+Deleted: sha256:501ad78535f0...
+```
+
+### 使用镜像名删除
+
+```bash
+$ docker rmi redis:alpine
+Untagged: redis:alpine
+Deleted: sha256:501ad78535f0...
+```
+
+### 使用摘要删除
+
+摘要删除最精确，适用于 CI/CD 场景：
+
+```bash
+# 查看镜像摘要
+$ docker images --digests
+REPOSITORY   TAG    DIGEST                   IMAGE ID
+nginx        latest sha256:b4f0e0bdeb5...    e43d811ce2f4
+
+# 使用摘要删除
+$ docker rmi nginx@sha256:b4f0e0bdeb578043c1ea6862f0d40cc4afe32a4a582f3be235a3b164422be228
+```
+
+---
+
+## 理解输出信息
+
+删除镜像时会看到两类信息：**Untagged** 和 **Deleted**
+
+```bash
+$ docker rmi redis:alpine
+Untagged: redis:alpine
+Untagged: redis@sha256:f1ed3708f538b537eb9c2a7dd50dc90a706f7debd7e1196c9264edeea521a86d
+Deleted: sha256:501ad78535f015d88872e13fa87a828425117e3d28075d0c117932b05bf189b7
+Deleted: sha256:96167737e29ca8e9d74982ef2a0dda76ed7b430da55e321c071f0dbff8c2899b
+Deleted: sha256:32770d1dcf835f192cafd6b9263b7b597a1778a403a109e2cc2ee866f74adf23
+```
+
+### Untagged vs Deleted
+
+| 操作 | 含义 |
+|------|------|
+| **Untagged** | 移除镜像的标签 |
+| **Deleted** | 删除镜像的存储层 |
+
+### 删除流程
+
+```
+docker rmi redis:alpine
+        │
+        ▼
+┌───────────────────────────────────────────────────────────────┐
+│  1. Untag：移除 redis:alpine 标签                              │
+│       ↓                                                       │
+│  2. 检查是否还有其他标签指向这个镜像                             │
+│       ├── 有 → 只 Untag，不删除                                │
+│       └── 无 →                                                │
+│             ↓                                                 │
+│  3. 检查是否有容器依赖                                          │
+│       ├── 有 → 报错，无法删除                                  │
+│       └── 无 →                                                │
+│             ↓                                                 │
+│  4. 从上到下逐层删除，检查每层是否被其他镜像使用                   │
+│       ├── 被使用 → 保留                                       │
+│       └── 未使用 → Deleted                                    │
+└───────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 批量删除
+
+### 删除所有虚悬镜像
+
+虚悬镜像（dangling）：没有标签的镜像，通常是旧版本被新版本覆盖后产生的
+
+```bash
+# 查看虚悬镜像
+$ docker images -f dangling=true
+
+# 删除虚悬镜像
+$ docker image prune
+
+# 不提示确认
+$ docker image prune -f
+```
+
+### 删除所有未使用的镜像
+
+```bash
+# 删除所有没有被容器使用的镜像
+$ docker image prune -a
+
+# 保留最近 24 小时的
+$ docker image prune -a --filter "until=24h"
+```
+
+### 按条件删除
+
+```bash
+# 删除所有 redis 镜像
+$ docker rmi $(docker images -q redis)
+
+# 删除 mongo:8.0 之前的所有镜像
+$ docker rmi $(docker images -q -f before=mongo:8.0)
+
+# 删除某个时间之前的镜像
+$ docker image prune -a --filter "until=168h"  # 7天前
+```
+
+---
+
+## 删除失败的常见原因
+
+### 原因一：有容器依赖
+
+```bash
+$ docker rmi nginx
+Error: conflict: unable to remove repository reference "nginx" 
+(must force) - container abc123 is using its referenced image
+```
+
+**解决方案**：
+
+```bash
+# 方案1：先删除依赖的容器
+$ docker rm abc123
+$ docker rmi nginx
+
+# 方案2：强制删除镜像（容器仍可运行，但无法再创建新容器）
+$ docker rmi -f nginx
+```
+
+### 原因二：多个标签指向同一镜像
+
+```bash
+$ docker images
+REPOSITORY   TAG     IMAGE ID
+ubuntu       24.04   ca2b0f26964c
+ubuntu       latest  ca2b0f26964c   # 同一个镜像
+
+$ docker rmi ubuntu:24.04
+Untagged: ubuntu:24.04
+# 只是移除标签，镜像仍存在（因为还有 ubuntu:latest 指向它）
+```
+
+### 原因三：被其他镜像依赖（中间层）
+
+```bash
+$ docker rmi some_base_image
+Error: image has dependent child images
+```
+
+中间层镜像被其他镜像依赖，无法删除。需要先删除依赖它的镜像。
+
+---
+
+## 常用过滤条件
+
+| 过滤条件 | 说明 | 示例 |
+|---------|------|------|
+| `dangling=true` | 虚悬镜像 | `-f dangling=true` |
+| `before=镜像` | 在某镜像之前 | `-f before=mongo:3.2` |
+| `since=镜像` | 在某镜像之后 | `-f since=mongo:3.2` |
+| `label=key=value` | 按标签过滤 | `-f label=version=1.0` |
+| `reference=pattern` | 按名称模式 | `-f reference='*:latest'` |
+
+---
+
+## 清理策略
+
+### 开发环境
+
+```bash
+# 定期清理虚悬镜像
+$ docker image prune -f
+
+# 一键清理所有未使用资源
+$ docker system prune -a
+```
+
+### CI/CD 环境
+
+```bash
+# 只保留最近使用的镜像
+$ docker image prune -a --filter "until=72h" -f
+```
+
+### 查看空间占用
+
+```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
+```
+
+---
+
+## 本章小结
+
+| 操作 | 命令 |
+|------|------|
+| 删除指定镜像 | `docker rmi 镜像名:标签` |
+| 强制删除 | `docker rmi -f 镜像名` |
+| 删除虚悬镜像 | `docker image prune` |
+| 删除未使用镜像 | `docker image prune -a` |
+| 批量删除 | `docker rmi $(docker images -q -f ...)` |
+| 查看空间占用 | `docker system df` |
+
+## 延伸阅读
+
+- [列出镜像](list.md)：查看和过滤镜像
+- [删除容器](../05_container/rm.md)：清理容器
+- [数据卷](../07_data_network/data/volume.md)：清理数据卷