Dockerで構築したMySQLのアップグレード手順を徹底解説

Docker版MySQLをアップグレードする前に確認すべきこと

DockerでインストールしたMySQLをアップグレードする前に、以下の準備が整っていることを確認してください。

• MySQLサーバーのDockerイメージをダウンロード済みであること
• MySQLサーバーインスタンスが起動していること
• コンテナ内からMySQLサーバーインスタンスへ接続できること

これらの前提条件を満たしていれば、スムーズにアップグレード作業を進められます。なお、作業を始める前にmysqldumpなどでデータのバックアップを取得しておくことを強くおすすめします。万が一のトラブル発生時にも、確実に元の状態へ復旧できます。

MySQL 5.7から8.0へのアップグレード手順

ここからは、Dockerで稼働中の旧バージョンのMySQLを新しいバージョンへアップグレードする具体的な流れを、コマンド例とともに紹介します。

1. 既存のMySQLサーバーコンテナを停止する

まず、以下のコマンドで稼働中のMySQLサーバーを停止します。ここでは「mysql56」がコンテナ名です。実際の環境に合わせてコンテナ名を読み替えてください。

docker stop mysql56

2. 新しいMySQLサーバーのDockerイメージを取得する

次に、アップグレード先となるMySQLサーバーのDockerイメージをダウンロードします。

3. 旧サーバーのデータと設定を引き継いで新コンテナを起動する

既存サーバーのデータディレクトリと設定ファイルをそのまま利用しながら、新しいMySQL Dockerコンテナを起動します。必要に応じて設定内容の調整も行ってください。

MySQL Community Serverを使用している場合は、以下のコマンドを実行します。

docker run --name=mysql57 \
--mount type=bind,src=/path-on-host-machine/my.cnf,dst=/etc/my.cnf \
--mount type=bind,src=/path-on-host-machine/datadir,dst=/var/lib/mysql \
-d mysql/mysql-server:5.7

ご利用の環境に応じて、「mysql/mysql-server」の部分を正しいリポジトリ名に置き換えてください。

4. サーバーの起動完了を待つ

サーバーが起動処理を完了するまでしばらく待ちます。起動状況は以下のコマンドで確認できます。

docker ps

5. mysql_upgradeユーティリティを実行する

MySQL 5.7サーバーコンテナ内で、mysql_upgradeユーティリティを実行します。

docker exec -it mysql57 mysql_upgrade -uroot -p

パスワードの入力を求められたら、旧MySQLサーバー(5.6)のrootパスワードを入力してください。

6. コンテナを再起動してアップグレードを完了させる

最後に、以下のコマンドでMySQL 5.7サーバーコンテナを再起動すれば、アップグレードは完了です。

docker restart mysql57

まとめ

Docker環境でのMySQLアップグレードは、「既存コンテナの停止 → 新イメージの取得 → データ・設定の引き継ぎ → mysql_upgradeの実行 → 再起動」という流れで進めます。各ステップでコマンドの出力やログをこまめに確認し、問題がないかチェックしながら作業することで、安全にバージョン移行を行えます。