在 Compose 中控制启动和关闭顺序


您可以使用 depends_on 属性控制服务的启动和关闭顺序。Compose 始终按依赖关系顺序启动和停止容器,其中依赖关系由 depends_onlinksvolumes_fromnetwork_mode: "service:..." 确定。

一个很好的使用示例是需要访问数据库的应用程序。如果两个服务都使用 docker compose up 启动,则可能会失败,因为应用程序服务可能会在数据库服务启动之前启动,并且找不到可以处理其 SQL 语句的数据库。

控制启动

在启动时,Compose 不会等待容器“就绪”,而只等待其运行。这可能会导致问题,例如,如果您有一个关系型数据库系统,该系统需要在能够处理传入连接之前启动其自己的服务。

检测服务就绪状态的解决方案是使用 condition 属性,并使用以下选项之一

  • service_started
  • service_healthy。这指定依赖项应在启动依赖服务之前处于“健康”状态,这由 healthcheck 定义。
  • service_completed_successfully。这指定依赖项应在启动依赖服务之前成功运行完成。

示例

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

Compose 按依赖关系顺序创建服务。dbredisweb 之前创建。

Compose 等待标记为 service_healthy 的依赖项上的健康检查通过。db 预计在创建 web 之前处于“健康”状态(如 healthcheck 所示)。

db 服务的健康检查使用 pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}' 命令来检查 PostgreSQL 数据库是否就绪。该服务每 10 秒重试一次,最多 5 次。

Compose 还按依赖关系顺序删除服务。webdbredis 之前删除。

参考信息