docker container restart

重启一个或多个容器。

用法

docker container restart [OPTIONS] CONTAINER [CONTAINER...]

别名

别名是较长命令的简短或易于记忆的替代形式。

• docker restart

选项

选项	默认值	描述
-s, --signal		发送给容器的信号
-t, --time		在强制终止容器前等待的秒数

详细说明

--signal 标志用于向容器发送系统调用信号以使其退出。 该信号可以是形如 SIG<NAME> 的信号名称（例如 SIGKILL），也可以是与内核系统调用表中位置对应的无符号数字（例如 9）。可用信号请参考 signal(7) 手册页。

默认使用的信号由镜像的 StopSignal 定义，该值可以在构建镜像时通过 Dockerfile 中的 STOPSIGNAL 指令设置，或在创建容器时通过 --stop-signal 选项配置。 如果容器未配置任何信号，则默认使用 SIGTERM。

--time 标志设置在发送预定义信号（见 --signal）后，等待容器停止的秒数。 如果超时后容器仍未退出，将强制使用 SIGKILL 信号将其终止。

如果你将 --time 设置为 -1，则不应用超时，守护进程将无限期等待容器退出。

容器的默认超时时间可在创建容器时通过 --stop-timeout 选项指定。 如果未为容器配置默认值，则由守护进程决定：Linux 容器默认为 10 秒，Windows 容器默认为 30 秒。

示例

使用信号重启容器 (-s, --signal)

$ docker restart -s SIGHUP my_container

使用超时重启容器 (-t, --timeout)

$ docker restart -t 30 my_container