自动启动容器
Docker 提供 重启策略 来控制容器在退出时或 Docker 重启时是否自动启动。重启策略按正确顺序启动链接的容器。Docker 建议您使用重启策略,并避免使用进程管理器来启动容器。
重启策略与 dockerd
命令的 --live-restore
标志不同。使用 --live-restore
可以在 Docker 升级期间保持容器运行,但网络和用户输入会中断。
使用重启策略
要配置容器的重启策略,请在使用 docker run
命令时使用 --restart
标志。--restart
标志的值可以是以下任何一个
标志 | 说明 |
---|---|
no | 不要自动重启容器。(默认) |
on-failure[:max-retries] | 如果容器由于错误退出,则重启容器,错误表现为非零退出代码。可选地,使用 :max-retries 选项限制 Docker 守护进程尝试重启容器的次数。on-failure 策略仅在容器以失败退出时才会提示重启。如果守护进程重启,则不会重启容器。 |
always | 如果容器停止,则始终重启容器。如果手动停止,则仅在 Docker 守护进程重启或容器本身手动重启时才会重启。(请参阅 重启策略详细信息 中列出的第二点) |
unless-stopped | 与 always 类似,但当容器停止(手动或其他方式)时,即使 Docker 守护进程重启,也不会重启容器。 |
以下命令启动一个 Redis 容器,并将其配置为始终重启,除非容器被明确停止或守护进程重启。
$ docker run -d --restart unless-stopped redis
以下命令更改名为 redis
的正在运行容器的重启策略。
$ docker update --restart unless-stopped redis
以下命令确保所有正在运行的容器都重启。
$ docker update --restart unless-stopped $(docker ps -q)
重启策略详细信息
在使用重启策略时,请记住以下几点
重启策略仅在容器成功启动后才生效。在这种情况下,成功启动意味着容器至少运行了 10 秒,并且 Docker 已经开始监控它。这可以防止一个根本没有启动的容器进入重启循环。
如果您手动停止容器,则重启策略将被忽略,直到 Docker 守护进程重启或容器手动重启。这可以防止重启循环。
重启策略仅适用于容器。要配置 Swarm 服务的重启策略,请参阅 与服务重启相关的标志。
重启前台容器
当您在前台运行容器时,停止容器会导致连接的 CLI 也退出,无论容器的重启策略如何。以下示例说明了这种行为。
创建一个 Dockerfile,它打印数字 1 到 5,然后退出。
FROM busybox:latest COPY --chmod=755 <<"EOF" /start.sh echo "Starting..." for i in $(seq 1 5); do echo "$i" sleep 1 done echo "Exiting..." exit 1 EOF ENTRYPOINT /start.sh
从 Dockerfile 构建镜像。
$ docker build -t startstop .
从镜像运行容器,为其重启策略指定
always
。容器将数字 1..5 打印到 stdout,然后退出。这会导致连接的 CLI 也退出。
$ docker run --restart always startstop Starting... 1 2 3 4 5 Exiting... $
运行
docker ps
显示它仍在运行或重启,这得益于重启策略。但是,CLI 会话已经退出。它不会在初始容器退出后继续存在。$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 081991b35afe startstop "/bin/sh -c /start.sh" 9 seconds ago Up 4 seconds gallant_easley
您可以使用
docker container attach
命令在容器重启之间重新连接终端。在下一次容器退出时,它会再次分离。$ docker container attach 081991b35afe 4 5 Exiting... $
使用进程管理器
如果重启策略不适合您的需求,例如当 Docker 之外的进程依赖于 Docker 容器时,您可以使用进程管理器,例如 systemd 或 supervisor 而不是。
警告
不要将 Docker 重启策略与主机级进程管理器结合使用,因为这会导致冲突。
要使用进程管理器,请将其配置为使用与您通常手动启动容器相同的 docker start
或 docker service
命令启动您的容器或服务。有关更多详细信息,请参阅特定进程管理器的文档。
在容器内使用进程管理器
进程管理器也可以在容器内运行,以检查进程是否正在运行,如果未运行则启动/重启进程。
警告
它们不是 Docker 感知的,只监控容器内的操作系统进程。Docker 不推荐这种方法,因为它依赖于平台,并且在给定 Linux 发行版的不同版本之间可能会有所不同。