zeabur-migration

Zeabur のマイグレーションに関する問題

Zeabur CLI の実行には、常に npx zeabur@latest を使用してください。 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 スキルを使用してください。