首次执行docker-compose up时运行迁移或加载Schema的最佳方案

嘿，这个需求太常见了，完全不用手动跑单独命令！我给你几个经过生产环境验证的最佳实践，都能让新团队成员只敲docker-compose up就能一键启动整个环境：

方案1：在Web应用容器启动前自动执行迁移（最常用） #

这是最直接的方案——修改Web应用的启动脚本，让它先等数据库就绪，再跑迁移，最后启动应用。

步骤1：编写启动脚本（entrypoint.sh） #

在你的Web应用项目根目录创建一个entrypoint.sh脚本，内容如下（以Python/Django为例，你可以换成自己框架的迁移命令）：

#!/bin/sh
set -e  # 脚本遇到错误就退出

# 等待数据库服务可用，这里以PostgreSQL为例，其他数据库替换成对应的检测命令（比如MySQL用mysqladmin）
echo "等待数据库连接..."
until pg_isready -h db -U postgres; do
  sleep 2
done

# 执行数据库迁移
echo "开始执行数据库迁移..."
python manage.py migrate

# 启动Web应用（这里替换成你实际的启动命令）
echo "启动Web应用..."
exec "$@"

步骤2：修改Dockerfile和docker-compose.yml #

在Web应用的Dockerfile里，把脚本复制进去并赋予执行权限：

# 其他Dockerfile内容...
COPY entrypoint.sh /app/
RUN chmod +x /app/entrypoint.sh

然后在docker-compose.yml里配置Web服务的entrypoint：

services:
  webapp:
    build: .
    entrypoint: /app/entrypoint.sh
    command: gunicorn myapp:app --bind 0.0.0.0:8000  # 你的应用启动命令
    depends_on:
      - db
    environment:
      # 配置数据库连接环境变量，和迁移命令保持一致
      DATABASE_URL: postgres://postgres:password@db:5432/mydb
    # 其他配置（端口映射、卷挂载等）...

  db:
    image: postgres:15
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: password
      POSTGRES_DB: mydb
    # 其他配置...

方案2：结合健康检查确保数据库就绪后再执行迁移 #

Docker Compose 3.0+支持healthcheck和带条件的depends_on，可以让Web容器直到数据库完全就绪后再启动，进一步避免迁移失败。

步骤1：给数据库服务加健康检查 #

修改docker-compose.yml里的db服务：

db:
  image: postgres:15
  environment:
    POSTGRES_USER: postgres
    POSTGRES_PASSWORD: password
    POSTGRES_DB: mydb
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U postgres -h localhost"]
    interval: 5s  # 每5秒检查一次
    timeout: 5s   # 超时时间
    retries: 5    # 最多重试5次

步骤2：让Web服务等待数据库健康 #

修改webapp服务的depends_on：

webapp:
  build: .
  entrypoint: /app/entrypoint.sh
  command: gunicorn myapp:app --bind 0.0.0.0:8000
  depends_on:
    db:
      condition: service_healthy  # 只在db健康后才启动
  # 其他配置...

这个方案可以和方案1结合，双重保险——即使健康检查有小问题，entrypoint里的等待逻辑也能兜底。

方案3：独立迁移服务（适合复杂场景） #

如果你的迁移逻辑特别复杂（比如需要额外依赖、或者想和应用启动完全解耦），可以单独加一个migrate服务，它执行完迁移就退出，Web服务等它执行成功后再启动。

修改docker-compose.yml：

services:
  migrate:
    build: .
    entrypoint: /app/entrypoint-migrate.sh  # 专门的迁移脚本
    depends_on:
      db:
        condition: service_healthy
    environment:
      DATABASE_URL: postgres://postgres:password@db:5432/mydb

  webapp:
    build: .
    command: gunicorn myapp:app --bind 0.0.0.0:8000
    depends_on:
      migrate:
        condition: service_completed_successfully  # 等待迁移成功完成
      db:
        condition: service_healthy
    # 其他配置...

  db:
    image: postgres:15
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: password
      POSTGRES_DB: mydb
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -h localhost"]
      interval: 5s
      timeout: 5s
      retries: 5

entrypoint-migrate.sh内容很简单：

#!/bin/sh
set -e
echo "执行数据库迁移..."
python manage.py migrate
echo "迁移完成，退出服务"

关键注意事项 #

• 不要依赖depends_on的默认行为：它只保证容器启动顺序，不保证数据库服务可用，必须加等待逻辑或健康检查
• 环境变量要统一：Web应用和迁移脚本的数据库连接配置要一致，避免连接失败
• 脚本权限要正确：Dockerfile里务必给entrypoint脚本加执行权限，不然容器启动会报错

内容的提问来源于stack exchange，提问作者Garrett Motzner