はじめに

AWS ECS 上でデータベースのマイグレーションを実行する際、どの方法を選択するべきかを自分なりに解説します。

個人の備忘録程度の走り書きとなっておりますが、温かい目で見守っていただければ幸いです。

書こうと思ったきっかけ

ECS 上でのデータベースマイグレーションの実行方法には複数の選択肢があり、どの方法を採用するべきか迷うことが多いと感じました。

運用の手間や自動化の観点から、最適な方法を整理し、選択しやすい形でまとめることが重要だと考えました。

migrate.go をビルドして migrate_app というバイナリを作成し、コンテナに含める方法です。

ECS Exec を使用し、実行中のコンテナに入って手動で migrate.go を実行する方法です。

コンテナ起動時に自動で migrate_app を実行するように ENTRYPOINT を設定する方法です。

方法	メリット	デメリット
方法 1: `migrate_app` を追加	手動でも自動でも実行可能	コンテナサイズが少し増える
方法 2: `aws ecs execute-command` を使う	変更不要で簡単に実行可能	毎回手動で実行する必要がある
方法 3: `ENTRYPOINT` に `migrate_app` を追加	自動でマイグレーションされる	アプリ起動時にエラーがあるとコンテナが落ちる

まずは 方法 1 (migrate_app をビルド・デプロイし、ECS Exec で手動実行) するのがベストです。
それで問題なければ、方法 3 に移行すると、マイグレーションの実行を完全に自動化できます。

ECS 上でのマイグレーション実行方法は、大きく3つのアプローチに分かれます。どの方法を選ぶかは、運用のしやすさや、どこまで自動化するかによって決まります。

まずは 方法 1 を導入して様子を見つつ、最適な方法を選択する ことをおすすめします。