跳到主要内容

停止一个或多个pod

介绍​

podman pod stop 命令用于停止一个或多个运行的 Pod。当你想要终止一个或多个 Pod 的运行时，这个命令会非常有用。

命令语法​

podman pod stop [OPTIONS] POD [POD...]

选项（OPTIONS）​

--all, -a​

停止所有pods

--ignore

忽略某些错误或条件（此选项在官方文档中未明确提及，可能不是podman pod stop的有效选项）

--latest

停止最后创建的pod。（此选项不适用于远程Podman客户端，包括Mac和Windows（不包括WSL2）机器）

--pod-id-file.pod

从指定的文件中读取pod ID列表，并停止这些pods（文件路径应为file1、file2等，而不是.pod后缀）

--time

设置停止pod的超时时间（该选项通常写作-t后跟时间值，如-t 1表示1秒超时）

示例（EXAMPLE）​

使用给定的名称停止pod。

$ podman pod stop mywebserverpod
cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907

使用给定的ID停止多个pods。

$ podman pod stop 490eb 3557fb
490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab

停止最后创建的pod。

$ podman pod stop --latest
3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab

停止所有pods。

$ podman pod stop --all
19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9
cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907

通过--pod-id-file选项停止两个pods。

$ podman pod stop --pod-id-file file1 --pod-id-file file2
19456b4cd555eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907

使用1秒的超时停止所有pods。

$ podman pod stop -a -t 1
3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9
  • 强制停止 Pod（使用 --force 选项）可能会导致容器内的进程被突然终止，因此应谨慎使用。
  • 停止 Pod 不会影响 Pod 关联的存储卷或数据持久性。
  • 停止 Pod 后，可以通过 podman pod list 命令来确认 Pod 的状态。

6. 常见问题及解决方案​

  • 问题：Pod 停止后，容器状态没有立即变为 Stopped。

    • 解决方案：这可能是因为容器仍在执行清理操作或等待进程正常退出。可以通过 podman ps -a 查看容器的状态，并等待一段时间或使用 --force 选项强制停止。

  • 问题：没有权限停止 Pod。

    • 解决方案：确保你有足够的权限来管理 Pod。在某些系统上，你可能需要使用 sudo 或以 root 用户身份运行命令。

7. 相关命令​

8. 历史​

  • 2018 年 7 月，最初由 Peter Hunt 编译整理。