跳到主要内容

podman -pod -rm - 删除一个或多个已停止的pod和容器

概述

podman pod rm 命令用于从主机上删除一个或多个已停止的pod及其容器。可以通过pod的名称或ID来指定要删除的pod。使用 -f 选项可以强制停止正在运行的容器,并删除所有已停止的容器,然后再删除pod。如果pod中的所有容器都是由用户添加的并且都处于退出状态,那么该pod也会被删除。

语法

podman pod rm [选项] pod

描述

podman pod rm 命令通过停止并删除指定的pod及其所有容器来清理资源。这对于管理容器生命周期和释放系统资源非常有用。

选项

--all, -a

删除所有pod。可以与 -f 选项结合使用,以强制删除所有正在运行的pod及其容器。

--force, -f

强制停止正在运行的容器,并删除所有已停止的容器,然后再删除pod。这可以在不需要手动停止容器的情况下快速清理资源。

--ignore

此选项当前未被使用,可以忽略。

--latest

此选项当前未被使用,可以忽略。

--pod-id-file=<文件路径>

如果指定了此选项,则将与pod关联的ID文件从指定路径中删除。这可以用于自动化脚本或与其他工具集成,以便轻松管理pod的ID。

--time

此选项用于指定等待容器停止的超时时间(以秒为单位)。它必须与 --force 选项一起使用,以在强制删除容器时设置超时限制。

示例

删除具有给定名称的pod

podman pod rm mywebserverpod

删除具有给定名称和/或ID的多个pod

podman pod rm mywebserverpod myflaskserverpod 860a4b23

强制删除具有给定ID的pod及其容器

podman pod rm -f 860a4b23

强制删除所有pod及其容器

podman pod rm -f -a
# 或者简写为
podman pod rm -fa

使用文件中指定的ID删除pod

podman pod rm --pod-id-file /path/to/id/file

退出状态

  • 0:所有指定的pod及其容器已成功删除。
  • 1:指定的pod中有一个不存在,并且没有其他失败。
  • 2:指定的pod之一仍然附加到容器中,无法删除。
  • 125:命令因其他原因失败。

另请参阅

podman(1), podman-pod(1)

这些手册页提供了关于podman命令和podman pod子命令的更多详细信息和选项。

历史

2018年7月,最初由Peter Hunt整理。此后,随着podman项目的不断发展,文档和命令选项也得到了持续的更新和完善。