docker container kill

描述

docker kill 子命令用于终止一个或多个容器。容器内的主进程会收到 SIGKILL 信号（默认），或者通过 --signal 选项指定的信号。您可以通过容器的 ID、ID 前缀或名称来引用容器。

--signal 标志设置发送到容器的系统调用信号。此信号可以是 SIG<NAME> 格式的信号名称，例如 SIGINT，也可以是与内核系统调用表中的位置匹配的无符号数字，例如 2。

虽然默认的（SIGKILL）信号会终止容器，但通过 --signal 设置的信号可能不会终止容器，这取决于容器的主进程。例如，在大多数情况下，SIGHUP 信号不会终止容器，容器在收到信号后会继续运行。

注意

以 shell 形式运行的 ENTRYPOINT 和 CMD 是 /bin/sh -c 的子进程，它不传递信号。这意味着可执行文件不是容器的 PID 1，并且不会接收 Unix 信号。

选项

示例

向容器发送 KILL 信号

以下示例将默认的 SIGKILL 信号发送到名为 my_container 的容器

$ docker kill my_container

向容器发送自定义信号 (--signal)

以下示例将 SIGHUP 信号发送到名为 my_container 的容器

$ docker kill --signal=SIGHUP  my_container

您可以按名称或数字指定自定义信号。SIG 前缀是可选的，因此以下示例是等效的

$ docker kill --signal=SIGHUP my_container
$ docker kill --signal=HUP my_container
$ docker kill --signal=1 my_container

有关标准 Linux 信号的列表，请参阅 signal(7) 手册页。