NAME

Podman-rm-移除一个或多个容器

SYNOPSIS

podman rm [options] container

podman container rm [options] container

DESCRIPTION

podman rm 从主机中删除一个或多个容器。可以使用容器名称或ID。这不会删除图像。运行或不可用的容器不会在没有 -f 选择。

OPTIONS

--all ， -a

移走所有容器。可以与一起使用 -f 也是。

--cidfile = file

从指定的读取容器ID file 并对集装箱进行包装。可以多次指定。

命令在以下情况下不会失败 file 缺少且用户已指定--忽略。

--depend

删除选定的容器并递归删除所有依赖它的容器。

--filter = 过滤

过滤容器移除的内容。可以通过多次使用--Filter标志来指定多个筛选器。具有相同关键工作的筛选器(包括 label 这是排他性的。具有不同密钥的筛选器始终以独占方式工作。

下面列出了有效的筛选器：

Filter	Description
ID号	[ID] 容器的ID(默认情况下CID前缀匹配；接受regex)
名字	[Name] 容器的名称(接受正则表达式)
标签	[Key] 或 [Key=Value] 分配给容器的标签
已退出	[Int] 容器的出口代码
状态	[状态] 容器状态：‘已创建’、‘已退出’、‘已暂停’、‘正在运行’、‘未知’
祖先	[ImageName] 用于创建容器的图像或后代
在此之前	[ID] 或 [Name] 在此容器之前创建的容器
因为	[ID] 或 [Name] 自该容器以来创建的容器
卷	[VolumeName] 或 [MountpointDestination] 装载在容器中的卷
健康状况	[状态] 健康或不健康
豆荚	[Pod] Pod的名称或完整或部分ID
网络	[网络] 网络的名称或完整ID
直到	[DateTime] 在给定持续时间或时间之前创建的容器。

--force ， -f

强制移除正在运行和暂停的容器。强制移除容器也会将容器从容器存储中移除，即使Podman不知道该容器也是如此。例如，由不同容器引擎(如Buildah)创建的容器。此外，可以使用强制删除不可用的容器，例如其OCI运行时已变得不可用的容器。

--ignore ， -i

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

进一步忽略指定的 --cidfile 不存在，因为它可能已随容器一起删除。

--latest ， -l

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

--time ， -t = 一秒

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

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

--volumes ， -v

删除与容器关联的匿名卷。这不包括使用创建的命名卷 podman volume create ，或 --volume 选项： podman run 和 podman create 。

EXAMPLE

删除具有给定名称的容器：

$ podman rm mywebserver

删除具有给定名称的容器以及依赖它的所有容器：

$ podman rm --depend mywebserver

删除具有给定名称或ID的多个容器：

$ podman rm mywebserver myflaskserver 860a4b23

删除具有从文件读取的ID的多个容器：

$ podman rm --cidfile ./cidfile-1 --cidfile /home/user/cidfile-2

强制移除具有给定ID的容器：

$ podman rm -f 860a4b23

无论运行状态如何，删除所有容器：

$ podman rm -f -a

强制删除最后创建的容器。(此选项不适用于远程Podman客户端，包括Mac和Windows(不包括WSL2)计算机)：

$ podman rm -f --latest

退出状态

0 已删除所有指定的容器

1 指定的容器之一不存在，并且没有其他失败

2 指定的容器之一已暂停或正在运行

125 该命令由于任何其他原因而失败

另请参阅

[podman(1)]

HISTORY

2017年8月，最初由Ryan Colerycole@redhat.com汇编