【要約】Laravel 経験者がAlembicで詰まったところ [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
Laravel経験者がPython環境へ移行した際、マイグレーションの管理手法の違いにより、並行開発時にエラーが発生する問題に直面する。具体的には、以下の事象が課題となる。
- ・Laravelはファイル名のタイムスタンプで順序を管理する。
- ・AlembicはリビジョンIDと
down_revisionによるチェーンで管理する。 - ・並行作業により、同じ親を持つ複数のリビジョン（Multiple heads）が生じる。
- ・Multiple heads状態では、
alembic upgrade headが失敗する。
// Approach
開発者はAlembicの特性に合わせ、エラーを未然に防ぐ運用ルールと、発生後のリカバリ手法を導入する。以下のステップで管理を行う。
- ・事前予防: 後にマージされる側が
down_revisionを最新のheadへ書き換える。 - ・事後対応:
alembic merge headsを使い、複数のheadを1つのリビジョンに合流させる。 - ・履歴整理:
rm -rf alembic/versions/*とautogenerateを組み合わせ、履歴をsquashする。 - ・自動検知: CIで
alembic headsの数が1であることを確認する。
// Result
適切な運用フローを導入することで、開発チームはスキーマ変更に伴う混乱を最小限に抑えられる。具体的な成果は以下の通りである。
- ・Multiple headsの発生をCIで確実に検知できる。
- ・試行錯誤期の汚い履歴を、
squashによって安全に整理できる。 - ・本番環境への移行コストを抑えるため、初期段階からの導入が推奨される。
Senior Engineer Insight
> AlembicはGitに近いグラフ構造を持つ。そのため、開発者にはrebase的な思考が求められる。単なるツールの習熟だけでなく、スキーマ変更に対するオーナーシップが重要だ。CIでの検知と、
squashによる履歴管理を組み合わせることで、実戦的な運用が可能となる。導入タイミングは、本番データが入る前が最適である。