名称

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

当指定项不在容器存储中时忽略错误。用户可能已决定手动删除一个容器，这导致引用该容器的 systemd 服务的 ExecStop 指令失败。

--latest, -l

不提供名称或 ID，而是使用最新创建的容器。注意：最新创建的容器可能来自主机上 Podman 的其他用户。（此选项不适用于远程 Podman 客户端，包括 Mac 和 Windows（WSL2 除外）机器）

--pod-id-file=file

从指定文件中读取 Pod ID 并停止该 Pod。可多次指定。

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

--time, -t=秒数

强制停止前等待的秒数。使用 -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 初次编译