容器与云原生 / 系统课时
Restart Policy 有哪些策略
Restart Policy 有哪些策略
容器进程退出后是否自动拉起,由 Restart Policy 决定。Docker 常见策略有 no、on-failure、always 和 unless-stopped。选择时不能只看“会不会重启”,还要区分退出原因、手工停止以及 Docker daemon 重启后的行为,否则容易出现服务不恢复或容器反复拉起的问题。
学习目标
- 区分四种常见 Restart Policy 的触发条件
- 能根据批处理任务、常驻服务等场景选择合适策略
- 能用
docker run、docker update和docker inspect配置并验证策略
四种策略的核心差异
| 策略 | 主进程退出后 | Docker daemon 重启后 | 典型用途 |
|---|---|---|---|
no |
不自动重启 | 不自动恢复 | 临时命令、一次性调试 |
on-failure[:N] |
仅非零退出码时重启,可限制次数 | daemon 重启本身不会触发恢复 | 对异常退出进行有限重试的任务 |
always |
无论退出码都持续尝试重启 | 会尝试恢复 | 需要长期运行的服务 |
unless-stopped |
与 always 类似 |
若此前已停止则保持停止 | 长驻服务且希望保留停机意图 |
no 是默认值。on-failure 关注进程是否“异常退出”,而 always 与 unless-stopped 更强调服务是否应持续保持运行。管理员手工停止使用 always 的容器后,自动重启会暂时被抑制;Docker daemon 再次启动或容器被手工启动后,策略重新生效。unless-stopped 则会保留已经停止的状态。
配置并查看 Restart Policy
下面创建一个异常退出后最多自动重启 3 次的容器。示例把进程保持运行一段时间,是为了让容器正常进入 Docker 的监控阶段。
docker run -d --name retry-demo --restart on-failure:3 alpine:3.20 sh -c 'sleep 30; exit 1' >/dev/null
docker inspect --format '{{.HostConfig.RestartPolicy.Name}} {{.HostConfig.RestartPolicy.MaximumRetryCount}}' retry-demo预期输出:
on-failure 3验证完成后删除示例容器:
docker rm -f retry-demo预期输出:
retry-demoDocker 只有在容器成功启动并进入监控阶段后才应用重启策略,这可以避免一个根本无法启动的容器立即陷入高速重启循环。即使配置了自动重启,仍应通过退出码和日志定位持续崩溃的根因。
always 和 unless-stopped 怎么选
两者都适合常驻服务,但对“明确停机”这件事的处理不同。always 表达的是尽量持续运行;unless-stopped 额外表达“如果管理员已经把它停掉,就不要因为 daemon 重启而擅自恢复”。
例如启动长期服务:
docker run -d --name web --restart unless-stopped nginx:1.27-alpine >/dev/null
docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' web预期输出:
unless-stopped如果运维目标是“机器或 Docker daemon 恢复后服务也必须回来”,通常会考虑 always;如果需要保留人工停机状态,unless-stopped 更贴合这个意图。
修改已有容器的策略
不必重建容器,也可以使用 docker update 修改 Restart Policy。下面把已有的 web 改成 always:
docker update --restart always web >/dev/null
docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' web预期输出:
always策略修改只决定“何时重新启动容器”,不会修复容器内部程序的配置错误。若服务持续崩溃,应结合 docker logs web、退出码和应用日志定位根因,而不是单纯依赖自动重启掩盖故障。
Restart Policy 与健康检查不要混为一谈
Restart Policy 主要响应容器主进程退出;HEALTHCHECK 则可以在进程仍然存活时把应用标为 unhealthy。一个 HTTP 服务即使已经无法处理请求,只要主进程没退出,always 也不会因为健康状态变差而主动重启它。
因此,Restart Policy 适合解决“进程退出后的自动恢复”,健康检查适合解决“进程仍在但服务是否可用”的可观测性。生产环境通常需要同时设计这两部分,并让真正的故障处置由编排平台、外部监控或应用自身机制负责。