データベース層の構築

最初に、データベース層となるMySQLコンテナを構築します。

1. イメージの取得

以下のコマンドで、Docker がインストールされていることを確認します。

docker --version

以下のように Docker のバージョンが表示されれば、インストールは確認できています。

Docker version 27.x.x, build xxxxxxx

バージョンが表示されない場合は、Docker Desktopのインストール を先に実施してください。

インストールが確認できたら、MySQLの公式イメージをDocker Hubから取得します。

docker pull mysql:latest
💡 ポイント
latestは最新バージョンを指すタグです。本番環境では、mysql:8.0のようにバージョンを明示的に指定することが推奨されます。

イメージが取得されたことを確認します。

docker image ls

以下のようにmysqlが表示されていれば成功です。

REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
mysql        latest    xxxxxxxxxxxx   x days ago    xxx MB

2. コンテナの起動

MySQLコンテナを起動します。

docker container run -d --name db-container \
  -v notedb-data:/var/lib/mysql \
  --env MYSQL_ROOT_PASSWORD=rootpass \
  --env MYSQL_DATABASE=notedb \
  --env MYSQL_USER=noteuser \
  --env MYSQL_PASSWORD=notepass \
  mysql:latest
オプション 値 説明
-d - バックグラウンドでコンテナを実行する
--name db-container コンテナに名前を付ける
-v notedb-data:/var/lib/mysql - データ永続化用のボリュームをマウントする
--env MYSQL_ROOT_PASSWORD rootpass MySQLのrootユーザのパスワード(必須)
--env MYSQL_DATABASE notedb 起動時に自動作成するデータベース名
--env MYSQL_USER noteuser アプリケーション用のユーザ名
--env MYSQL_PASSWORD notepass アプリケーション用ユーザのパスワード
💡 ポイント
-v notedb-data:/var/lib/mysqlでボリュームをマウントすることで、コンテナを削除してもデータベースのデータが保持されます。コンテナを再作成しても、同じボリュームをマウントすればデータを引き継ぐことができます。
📝 MySQL環境変数について
MySQLの公式イメージは、環境変数を使って初期設定を行うことができます。MYSQL_DATABASEを指定すると、コンテナ起動時にデータベースが自動作成されます。MYSQL_USERとMYSQL_PASSWORDで作成したユーザは、MYSQL_DATABASEで指定したデータベースへのアクセス権限が自動的に付与されます。

コンテナが起動していることを確認します。

docker container ls

STATUSがUpになっていれば、コンテナは正常に起動しています。

3. テーブルの作成

MySQLコンテナに接続し、ノート用のテーブルを作成します。

docker container exec -it db-container mysql -u noteuser -pnotepass notedb

mysql> の待ち受け状態になれば、MySQLにログインできています。

MySQLのプロンプトが表示されたら、以下のSQLを実行してテーブルを作成します。

CREATE TABLE notes (
    id INT AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(100) NOT NULL,
    content TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

テーブルが作成されたことを確認します。

SHOW TABLES;

以下のようにnotesテーブルが表示されれば成功です。

+------------------+
| Tables_in_notedb |
+------------------+
| notes            |
+------------------+

MySQLからログアウトします。

exit
💡 ポイント
実はこのアプリケーションには、APIコンテナ起動時にテーブルを自動作成する仕組み(lifespan関数)が組み込まれています。ここで手動でテーブルを作成したのは、MySQLコンテナに接続してSQLを実行する操作を体験するためです。
💡 ポイント
起動したdb-containerは、この後のハンズオンでも使用するため、削除せずに残しておいてください。