容器与云原生 / 系统课时

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 的监控阶段。

bash
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

预期输出:

text
on-failure 3

验证完成后删除示例容器:

bash
docker rm -f retry-demo

预期输出:

text
retry-demo

Docker 只有在容器成功启动并进入监控阶段后才应用重启策略,这可以避免一个根本无法启动的容器立即陷入高速重启循环。即使配置了自动重启,仍应通过退出码和日志定位持续崩溃的根因。

always 和 unless-stopped 怎么选

两者都适合常驻服务,但对“明确停机”这件事的处理不同。always 表达的是尽量持续运行;unless-stopped 额外表达“如果管理员已经把它停掉,就不要因为 daemon 重启而擅自恢复”。

例如启动长期服务:

bash
docker run -d --name web --restart unless-stopped nginx:1.27-alpine >/dev/null
docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' web

预期输出:

text
unless-stopped

如果运维目标是“机器或 Docker daemon 恢复后服务也必须回来”,通常会考虑 always;如果需要保留人工停机状态,unless-stopped 更贴合这个意图。

修改已有容器的策略

不必重建容器,也可以使用 docker update 修改 Restart Policy。下面把已有的 web 改成 always:

bash
docker update --restart always web >/dev/null
docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' web

预期输出:

text
always

策略修改只决定“何时重新启动容器”,不会修复容器内部程序的配置错误。若服务持续崩溃,应结合 docker logs web、退出码和应用日志定位根因,而不是单纯依赖自动重启掩盖故障。

Restart Policy 与健康检查不要混为一谈

Restart Policy 主要响应容器主进程退出;HEALTHCHECK 则可以在进程仍然存活时把应用标为 unhealthy。一个 HTTP 服务即使已经无法处理请求,只要主进程没退出,always 也不会因为健康状态变差而主动重启它。

因此,Restart Policy 适合解决“进程退出后的自动恢复”,健康检查适合解决“进程仍在但服务是否可用”的可观测性。生产环境通常需要同时设计这两部分,并让真正的故障处置由编排平台、外部监控或应用自身机制负责。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Restart Policy 有哪些策略

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通