容器与云原生 / 系统课时

Restart Policy 应该怎么配置

Restart Policy 应该怎么配置

长期运行的 Compose 服务需要在进程崩溃或 Docker 重启后恢复,但“无条件重启”也可能把启动失败变成持续循环。本节按退出原因和人工停机语义选择 restart 策略,并用实际容器配置验证策略,避免把重启当成故障修复。

学习目标

  • 根据服务类型选择 no、on-failure、always 或 unless-stopped
  • 使用有限重试避免失败任务无限循环
  • 验证容器实际采用的 Restart Policy,并正确应用配置变更

根据服务行为选择策略

Compose 的 restart 决定容器退出后 Docker 是否再次启动它。关键不是“哪个最强”,而是服务退出意味着什么。

策略 适合场景 关键行为
"no" 一次性任务、手工运行工具 默认值,退出后不自动重启
on-failure 非零退出码表示临时故障的任务 只在失败退出时重启
"on-failure:3" 希望失败后有限重试的任务 最多重试 3 次
unless-stopped 常驻 API、代理、缓存等服务 异常退出或 Docker 重启后恢复,但人工停止状态会保留
always 明确要求 Docker 恢复后继续运行的常驻服务 会持续采用重启策略;人工停止后,Docker 守护进程再次启动时也会重新启动

on-failure 不会因为 Docker 守护进程重启而自动拉起已停止的容器,因此它更适合“失败重试”,而不是“机器重启后保证常驻”。

配置并检查实际策略

下面同时配置一个长期运行的 API 和一个只允许有限失败重试的导入任务。示例中的命令保持容器运行,便于直接检查 Docker 最终保存的策略。

yaml
services:
  api:
    image: nginx:1.29-alpine
    restart: unless-stopped

  importer:
    image: alpine:3.22
    command: ["sh", "-c", "sleep 3600"]
    restart: "on-failure:3"

启动后检查两个容器的 Restart Policy:

bash
docker compose up -d
for service in api importer; do
  id="$(docker compose ps -q "$service")"
  printf '%s ' "$service"
  docker inspect --format '{{.HostConfig.RestartPolicy.Name}} {{.HostConfig.RestartPolicy.MaximumRetryCount}}' "$id"
done

预期输出

text
api unless-stopped 0
importer on-failure 3

MaximumRetryCount 为 0 对 unless-stopped 并不表示“不重启”,而是该策略没有有限重试次数;on-failure:3 则明确记录最大重试次数为 3。

避免无限重启掩盖故障

always 和 unless-stopped 很适合长期服务,但如果应用因为缺少配置、数据库不可达或启动参数错误而反复退出,自动重启只能重复失败,不能修复根因。日志中真正的首次异常还可能被大量重复启动信息淹没。

对于允许失败的批处理或消费者,优先考虑 "on-failure:<次数>" 这类有界重试;对于必须常驻的服务,可以使用 unless-stopped 或 always,但仍应配合日志、健康检查和外部监控判断服务是否真正可用。

修改策略后让配置真正生效

修改 compose.yaml 里的 restart 后,重新执行 docker compose up -d,Compose 才会根据配置差异更新或重建容器。单独执行 docker compose restart 只是重启现有容器,不会把新写入 Compose 文件的配置应用到它。

选择策略时可以用一个简单原则收尾:先确定“正常退出是否应该重启”,再确定“人工停止后 Docker 重启时是否应该恢复”,最后决定失败重试是否必须设上限。这样比对所有服务统一写 restart: always 更容易暴露真实故障。

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

目录与阅读设置

阅读设置

17

记录一个想法

Restart Policy 应该怎么配置

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

登录哪都通