Docker Compose 服务启动顺序控制指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00709/article/details/148549384

Docker Compose 服务启动顺序控制指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

概述

在分布式应用开发中，服务之间的依赖关系管理至关重要。Docker Compose 提供了强大的工具来控制多容器应用的启动和关闭顺序，确保服务按照正确的依赖关系启动和停止。本文将深入探讨如何利用 Docker Compose 的各种配置选项来精确控制服务生命周期。

为什么需要控制启动顺序

想象一个典型的 Web 应用场景：你的应用服务需要连接数据库服务。如果应用服务在数据库服务完全就绪前启动，应用可能会因为找不到可用的数据库而崩溃。这种"竞态条件"在容器化环境中尤为常见，因为容器启动速度可能差异很大。

基础依赖控制

Docker Compose 通过 depends_on 属性提供基本的启动顺序控制：

services:
  web:
    depends_on:
      - db
      - redis
  db:
    image: postgres
  redis:
    image: redis

这种配置确保 db 和 redis 服务会在 web 服务之前启动。但要注意，这仅保证容器进程已启动，不保证服务已准备好接收请求。

高级就绪状态检测

为了解决基础依赖控制的局限性，Docker Compose 提供了更精细的控制机制：

1. 服务启动条件 (condition)

service_started: 仅检查依赖服务是否已启动（默认行为）
service_healthy: 等待依赖服务通过健康检查
service_completed_successfully: 等待依赖服务成功完成（适用于一次性任务）

2. 健康检查配置

健康检查是确保服务真正可用的关键。以下是一个 PostgreSQL 数据库的健康检查示例：

services:
  db:
    image: postgres
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 10s
      retries: 5
      start_period: 30s

参数说明：

interval: 检查间隔
timeout: 单次检查超时时间
retries: 失败重试次数
start_period: 容器启动后的初始化宽限期

完整示例

services:
  web:
    build: .
    depends_on:
      db:
        condition: service_healthy
        restart: true
      redis:
        condition: service_started
  redis:
    image: redis
  db:
    image: postgres
    environment:
      POSTGRES_USER: user
      POSTGRES_DB: dbname
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      retries: 5
      start_period: 30s
      timeout: 10s

这个配置实现了：