容器与云原生 / 系统课时
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 最终保存的策略。
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:
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预期输出
api unless-stopped 0
importer on-failure 3MaximumRetryCount 为 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 更容易暴露真实故障。