跳到主要内容

Podman RMI 开发者手册

一、概述​

Podman RMI 命令用于移除一个或多个本地存储的容器镜像。通过该命令，开发者可以方便地管理本地镜像仓库，释放存储空间，并避免不必要的镜像堆积。

二、命令格式​

podman rmi [选项] 镜像 [...]

podman image rm [选项] 镜像 [...]

三、选项说明​

--all, -a​

该选项用于移除本地存储中的所有镜像。

--force, -f​

该选项强制移除镜像，即使该镜像正在被容器使用。在移除镜像之前，Podman 会先停止并删除使用该镜像的所有容器。

--ignore, -i​

如果指定的镜像在本地存储中不存在，该选项会忽略错误并继续执行命令。

--no-prune​

该选项禁止移除指定镜像的悬挂父镜像。悬挂父镜像是指没有标签且没有被其他镜像引用的镜像。

四、使用示例​

示例 1：通过短ID删除镜像​

$ podman rmi c0ed59d05ff7

示例 2：删除镜像及其相关联的容器​

$ podman rmi --force 镜像ID

示例 3：删除多个镜像​

$ podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7

示例 4：删除所有镜像和容器​

$ podman rmi -a -f

示例 5：忽略不存在的镜像​

$ podman rmi --ignore nothing

五、退出状态​

Podman RMI 命令执行完毕后，会根据操作结果返回不同的退出状态码：

  • 0：所有指定的镜像已成功删除。
  • 1：其中一个指定的镜像不存在，且没有其他错误。
  • 2：其中一个指定的镜像有子镜像或被容器使用。
  • 125：命令因其他原因失败。

六、注意事项​

  • 在使用 --force 选项时，请确保了解相关风险，因为该选项会强制停止并删除使用该镜像的所有容器。
  • 移除镜像前，请确保该镜像不再被需要，以免意外删除重要数据。
  • 如果需要从远程注册表中删除镜像，请使用 skopeo delete 命令。

七、相关命令​

  • podman(1)：Podman 主命令，用于管理容器和镜像。
  • skopeo-delete(1)：用于从远程注册表中删除镜像的命令。

八、总结​

Podman RMI 命令是 Podman 工具集中用于移除本地存储的容器镜像的重要命令。通过结合不同的选项和参数，开发者可以高效地管理本地镜像仓库，释放存储空间，并保持系统的整洁和高效。希望本手册能帮助您更好地理解和使用 Podman RMI 命令。

历史​

2017年3月，最初由Dan Walsh整理