docker container kill

說明

docker kill 子指令會終止一個或多個容器。容器內的主要程序會收到 SIGKILL 信號（預設），或是以 --signal 選項指定的信號。您可以使用容器的 ID、ID 前綴或名稱來參考容器。

--signal 旗標設定傳送到容器的系統呼叫信號。此信號可以是格式為 SIG<名稱> 的信號名稱，例如 SIGINT，或與核心系統呼叫表格中位置相符的無符號數字，例如 2。

雖然預設 (SIGKILL) 信號會終止容器，但透過 --signal 設定的信號可能不會終止容器，具體取決於容器的主要程序。例如，在 plupart 的情況下，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

請參閱 signal(7) 手冊頁面，以取得標準 Linux 信號列表。