zeabur-migration

Zeabur 迁移问题

始终使用 npx zeabur@latest 调用 Zeabur CLI。 切勿直接使用 zeabur 或通过其他方式安装。如果无法使用 npx，请先安装 Node.js。

症状

Waiting for database migrations to complete...
Waiting for database migrations to complete...
(repeating forever)

原因

应用预期单独运行迁移，但不存在迁移器服务。

解决方案

选项 A：在 API 启动时运行迁移（编辑模板 YAML — 请参考 zeabur-template 技能）

# In api service — command MUST be inside source
spec:
  source:
    image: myapp:latest
    command:
      - /bin/sh
      - -c
      - "python manage.py wait_for_db && python manage.py migrate && exec ./entrypoint.sh"

选项 B：添加迁移器服务

- name: migrator
  spec:
    source:
      image: same-backend-image
      command:
        - ./bin/docker-entrypoint-migrator.sh
    env:
      DATABASE_URL: ...

选项 A 更简单 — 迁移会在 API 启动时运行，并且是幂等的（可以安全地重复执行）。

如需检查迁移日志中的错误，请使用 zeabur-deployment-logs 技能。如果问题涉及服务在依赖项就绪前启动（而非迁移本身），请改用 zeabur-startup-order 技能。