データベース層の構築
最初に、データベース層となる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は、この後のハンズオンでも使用するため、削除せずに残しておいてください。 |