docker container kill
| 描述 | 终止一个或多个运行中的容器 |
|---|---|
| 用法 | docker container kill [OPTIONS] CONTAINER [CONTAINER...] |
| 别名 | docker kill |
描述
docker kill 子命令会杀死一个或多个容器。容器内的主进程会收到 SIGKILL 信号(默认),或者使用 --signal 选项指定的信号。您可以通过 ID、ID 前缀或名称来引用容器。
--signal 标志设置发送到容器的系统调用信号。
该信号可以是格式为 SIG<NAME> 的信号名称,例如 SIGINT,
或者是与内核系统调用表中的位置匹配的无符号数字,
例如 2。
虽然默认的 (SIGKILL) 信号将终止容器,但通过 --signal 设置的信号可能是非终止性的,具体取决于容器的主进程。例如,SIGHUP 信号在大多数情况下是非终止性的,容器在收到信号后将继续运行。
注意
ENTRYPOINT和 shell 形式中的CMD作为/bin/sh -c的子进程运行,该进程不传递信号。这意味着该可执行文件不是容器的 PID 1,并且不会接收 Unix 信号。
选项
| 选项 | 默认 | 描述 |
|---|---|---|
-s, --signal | 发送到容器的信号 |
示例
向容器发送 KILL 信号
下面的示例向名为
my_container的容器发送默认的SIGKILL信号:
$ docker kill my_container
向容器发送自定义信号 (--signal)
下面的示例向名为
my_container的容器发送一个 SIGHUP 信号:
$ 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)
手册页。