名称¶
podman-stop - 停止一个或多个正在运行的容器
简介¶
podman stop [选项] 容器 …
podman container stop [选项] 容器 …
描述¶
使用容器 ID 或名称作为输入，停止一个或多个容器。--time 选项指定在向容器发出停止命令后，强制停止容器前等待的秒数。默认值为 10 秒。默认情况下，容器先以 SIGTERM 停止，然后在超时后以 SIGKILL 停止。SIGTERM 的默认值可以被用于创建容器的镜像覆盖，也可以在创建容器时通过命令行覆盖。
选项¶
--all, -a¶
停止所有正在运行的容器。这不包括已暂停的容器。
--cidfile=文件¶
从指定的文件中读取容器 ID，并停止该容器。可以指定多次。
当文件不存在且用户指定了 --ignore 时，命令不会失败。
--filter, -f=过滤器¶
过滤将要停止的容器。可以通过多次使用 --filter 标志来给出多个过滤器。具有相同键的过滤器是包含性的，唯一的例外是 label，它是排他性的。具有不同键的过滤器总是排他性的。
下面列出了有效的过滤器
过滤器 |
描述 |
|---|---|
id |
[ID] 容器的 ID（默认情况下 CID 前缀匹配；接受正则表达式） |
name |
[名称] 容器的名称（接受正则表达式） |
label |
[键] 或 [键=值] 分配给容器的标签 |
exited |
[整数] 容器的退出代码 |
status |
[状态] 容器的状态：“created”、“initialized”、“exited”、“paused”、“running”、“unknown” |
ancestor |
[ImageName] 用于创建容器的镜像或其后代 |
before |
[ID] 或 [名称] 在此容器之前创建的容器 |
since |
[ID] 或 [名称] 在此容器之后创建的容器 |
volume |
[卷名称] 或 [挂载点目标] 挂载在容器中的卷 |
health |
[状态] healthy 或 unhealthy |
pod |
[Pod] pod 的名称或完整或部分 ID |
network |
[网络] 网络的名称或完整 ID |
until |
[DateTime] 在给定持续时间或时间之前创建的容器。 |
command |
[命令] 容器正在执行的命令，只取 argv[0] |
--ignore, -i¶
当指定项不在容器存储中时忽略错误。用户可能已决定手动删除一个容器，这导致引用该容器的 systemd 服务的 ExecStop 指令失败。
--latest, -l¶
不提供名称或 ID，而是使用最新创建的容器。注意：最新创建的容器可能来自主机上 Podman 的其他用户。（此选项不适用于远程 Podman 客户端，包括 Mac 和 Windows（WSL2 除外）机器）
--time, -t=秒数¶
强制停止前等待的秒数。使用 -1 表示无限等待。
示例¶
通过其名称停止指定的容器。
$ podman stop mywebserver
通过其 ID 停止容器。
$ podman stop 860a4b235279
停止多个容器。
$ podman stop mywebserver 860a4b235279
停止 cidfile 中标识的容器。
$ podman stop --cidfile /home/user/cidfile-1
停止 cidfiles 中标识的容器。
$ podman stop --cidfile /home/user/cidfile-1 --cidfile ./cidfile-2
在 2 秒内停止指定的容器。
$ podman stop --time 2 860a4b235279
停止所有正在运行的容器。
$ podman stop -a
停止最后创建的容器（此选项不适用于远程 Podman 客户端，包括 Mac 和 Windows（不包括 WSL2）机器）
$ podman stop --latest
按标签停止。
$ podman stop --filter label=app=frontend
9351ccb3ef4272532bc0c188bd4f0ddfc2b0de217732cd108259ea126b014647
按名称停止。
$ podman stop --filter name=db-replica
6c2680da61d54690718ac3aecdb04a8aad95ae353e42cc942736823bd05c8a1d
按角色标签停止。
$ podman stop --filter label=role=primary
bb3ff91d969a8dc622d627e4a8d76c18bdbd417d317c5e7e66543c0b0c8ed1e8
另请参阅¶
历史¶
2018 年 9 月，最初由 Brent Baude bbaude@redhat.com 编译