docker container stop
| 說明 | 停止一個或多個正在執行的容器 |
|---|---|
| 用法 | docker container stop [選項] 容器 [容器...] |
| 別名 | docker stop |
說明
容器內的主要程序將收到 `SIGTERM` 訊號，並在一段寬限期後收到 `SIGKILL` 訊號。第一個訊號可以使用容器 Dockerfile 中的 `STOPSIGNAL` 指令或 `docker run` 和 `docker create` 的 `--stop-signal` 選項來更改。
選項
| 選項 | 預設值 | 說明 |
|---|---|---|
-s, --signal | 要傳送到容器的訊號 | |
-t, --time | 在終止容器前等待的秒數 |
範例
$ docker stop my_container
使用訊號停止容器 (-s, --signal)
`--signal` 旗標會將系統呼叫訊號傳送到容器以使其退出。此訊號可以是格式為 `SIG<名稱>` 的訊號名稱，例如 `SIGKILL`，或是與核心系統呼叫表格中位置相符的無符號數字，例如 `9`。請參閱 signal(7) Dockerfile 指令來設定，或使用建立容器時的 `--stop-signal` 選項來設定。如果沒有為容器設定訊號，則預設使用 `SIGTERM`。
使用逾時停止容器 (-t, --timeout)
`--time` 旗標設定在傳送預先定義的（請參閱 [ `--signal` ](#signal)）系統呼叫訊號後，等待容器停止的秒數。如果容器在逾時到期後仍未退出，則會使用 `SIGKILL` 訊號強制終止它。
如果您將 --time 設定為 -1，則不會套用逾時，且守護行程會無限期地等待容器退出。
可以使用 --stop-timeout 選項在建立容器時指定預設逾時。如果沒有為容器設定預設值，則由守護行程決定預設值，Linux 容器為 10 秒，Windows 容器為 30 秒。