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) 手冊頁。