名称

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

概要

podman pod rm [选项] pod

描述

podman pod rm 从主机中删除一个或多个已停止的 Pod 及其容器。可以使用 Pod 名称或 ID。-f 选项将停止所有容器，然后在删除 Pod 之前将它们删除。如果用户添加的所有容器都处于退出状态，则 Pod 将被删除。

选项

--all, -a

删除所有 Pod。可以与 -f 结合使用。

--force, -f

在删除 Pod 之前停止正在运行的容器并删除所有已停止的容器。

--ignore, -i

忽略指定 Pod 不在容器存储中的错误。用户可能已决定手动删除 Pod，这会导致在引用该 Pod 的 systemd 服务的 ExecStop 指令期间出现故障。

--latest, -l

不提供 Pod 名称或 ID，而是使用最后创建的 Pod。注意：最后启动的 Pod 可能来自主机上其他 Podman 用户。(此选项不可与远程 Podman 客户端一起使用，包括 Mac 和 Windows (不包括 WSL2) 机器)

--pod-id-file=文件

从指定的 文件 中读取 Pod ID 并删除该 Pod。可以多次指定。

如果指定，则 pod-id-file 将与 Pod 一起删除。

--time, -t=秒

强制停止 Pod 中运行的容器之前等待的秒数。使用 -1 表示无限等待。

必须指定 --force 选项才能使用 --time 选项。

示例

删除具有给定名称的 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)

历史

2018 年 7 月，最初由 Peter Hunt pehunt@redhat.com 编译