NAME 名称

podman-pod-rm - Remove one or more stopped pods and containers
podman-pod-rm - 删除一个或多个已停止的 pod 和容器

SYNOPSIS 概要

podman pod rm [options] pod
podman pod rm [选项] pod

DESCRIPTION 描述

podman pod rm removes one or more stopped pods and their containers from the host. The pod name or ID can be used. The -f option stops all containers and then removes them before removing the pod. If all containers added by the user are in an exited state, the pod is removed.
podman pod rm 从主机中删除一个或多个已停止的 pod 及其容器。可以使用 pod 名称或 ID。-f 选项会先停止所有容器,然后再删除它们,最后再删除 pod。如果用户添加的所有容器都处于退出状态,则会删除该 pod。

OPTIONS 选项

--all, -a

Remove all pods. Can be used in conjunction with -f as well.
删除所有的 Pod。也可以与 -f 一起使用。

--force, -f

Stop running containers and delete all stopped containers before removal of pod.
停止运行的容器并在删除 Pod 之前删除所有已停止的容器。

--ignore, -i

Ignore errors when specified pods are not in the container store. A user might have decided to manually remove a pod which leads to a failure during the ExecStop directive of a systemd service referencing that pod.
当指定的 pod 不在容器存储中时忽略错误。用户可能已经决定手动删除一个 pod,这会导致在引用该 pod 的 systemd 服务的 ExecStop 指令期间失败。

--latest, -l

Instead of providing the pod name or ID, use the last created pod. Note: the last started pod can be from other users of Podman on the host machine. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
而不是提供 Pod 名称或 ID,请使用最后创建的 Pod。注意:最后启动的 Pod 可能来自主机上其他 Podman 用户。(此选项不适用于远程 Podman 客户端,包括 Mac 和 Windows(不包括 WSL2)机器)

--pod-id-file=file

Read pod ID from the specified file and rm the pod. Can be specified multiple times.
从指定文件中读取 pod ID 并删除该 pod。可以多次指定。

If specified, the pod-id-file is removed along with the pod.
如果指定,pod-id-file 会与 pod 一起被删除。

--time, -t=seconds --time, -t=秒数

Seconds to wait before forcibly stopping running containers within the pod. Use -1 for infinite wait.
在强制停止 pod 内运行的容器之前等待的秒数。使用 -1 表示无限等待。

The --force option must be specified to use the --time option.
必须指定 --force 选项才能使用 --time 选项。

EXAMPLE 例子 ¶

Remove pod with a given name:
使用给定名称删除 pod:

podman pod rm mywebserverpod

Remove multiple pods with given names and/or IDs:
使用给定的名称和/或 ID 删除多个 Pod:

podman pod rm mywebserverpod myflaskserverpod 860a4b23

Forcefully remove pod with a given ID:
强制删除具有给定 ID 的 Pod:

podman pod rm -f 860a4b23

Forcefully remove all pods:
强制删除所有 Pod:

podman pod rm -f -a
podman pod rm -fa

Remove pod using ID specified in a given file:
使用给定文件中指定的 ID 删除 Pod

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

Exit Status 退出状态 ¶

0 All specified pods removed
0 所有指定的 Pod 已删除

1 One of the specified pods did not exist, and no other failures
1 指定的某个 Pod 不存在,且没有其他失败情况

2 One of the specified pods is attached to a container
指定的 pod 之一已附加到容器

125 The command fails for any other reason
125 由于其他原因命令失败

SEE ALSO 参见 ¶

podman(1), podman-pod(1)

HISTORY 历史 ¶

July 2018, Originally compiled by Peter Hunt pehunt@redhat.com
2018 年 7 月,最初由 Peter Hunt pehunt@redhat.com 编译