Docker 重启策略详解

Docker 容器的重启策略有四种：no、always、on-failure、unless-stopped。

下面通过一个 demo 来演示它们的区别。

准备测试环境

创建一个名为 test.sh 的脚本，5 秒后自动退出：

#!/bin/bash
sleep 5
exit 1

创建 Dockerfile 将其打包进镜像：

FROM ubuntu
ADD test.sh /
CMD /bin/bash /test.sh

构建镜像：

docker build -t test-restart .

no

docker run -d --name=test-restart-no test-restart

容器 5 秒后退出，docker daemon 不做任何处理。

结论：容器退出后不重启。

always

docker run -d --restart=always --name=test-restart-always test-restart

容器退出后 docker daemon 自动重启。虽然每次生命周期只有 5 秒，但不断重启，表面上像一直在运行。

如果手动 docker stop 停止，不会自动重启。但重启 Docker daemon 后，容器会再次启动。

结论：除非手动停止，否则总是重启。重启 Docker daemon 也会触发。

on-failure

docker run -d --restart=on-failure:3 --name=test-restart-on-failure test-restart

容器退出后触发重启。容器退出后触发重启。当重启达到 3 次上限后不再重启。

注意：Docker 认为容器成功启动至少需运行 10 秒。脚本 5 秒就退出，触发重启的次数会持续累加直到上限（参考Docker 官方文档）。

结论：仅在容器非正常退出时重启，可设置最大重试次数。

unless-stopped

docker run -d --restart=unless-stopped --name=test-restart-unless-stopped test-restart

表现和 always 一样——容器退出后自动重启。区别在于：手动 docker stop 停止后，重启 Docker daemon 时容器不会自动启动，而 always 会。

结论：与 always 类似，但手动停止后重启 Docker 不会再次启动。

如何选择

• no：一次性任务、调试环境，不需要自动重启
• always：Web 服务、数据库等需要持续运行的服务
• on-failure：脚本任务、批处理作业，只在出错时重试
• unless-stopped：和 always 类似，但希望手动停止后不再被 Docker 重启时使用

参考资料

• 了解 Docker 容器重启策略，这一篇就够了！ - 墨天轮