Docker超入門：開発環境コンテナ：Django＋MySQL①

このページで解説している内容は、以下の YouTube 動画の解説で見ることができます。

Docker超入門：開発環境コンテナ：Django＋MySQL①

🐳 開発環境コンテナ：Django＋MySQL①

今回は Docker Compose を使って、Django＋MySQLの開発環境コンテナを構築していきます。
　この構成は「Webアプリ（Django）」＋「データベース（MySQL）」という、王道のセットアップです！

記事は2部構成になっています👇

• 開発環境コンテナ：Django＋MySQL①（今回）… Dockerfile と compose.yaml の準備
• 開発環境コンテナ：Django＋MySQL②（次回）… Django プロジェクトの作成と接続設定

🐍 Djangoとは？

Django（ジャンゴ）は、Pythonで書かれた人気の高いWebアプリケーションフレームワークです。
「フルスタック型」と呼ばれるタイプで、Webアプリに必要な機能がすべてそろっています。

Django公式サイトはこちら：
🔗 https://www.djangoproject.com/

🐬 MySQLとは？

MySQLは、世界中で最も利用されているオープンソースのデータベースです。
WordPressやYouTubeなど、多くの有名サービスでも採用されています。

MySQL公式サイトはこちら：
🔗 https://www.mysql.com/jp/

⚙️ Djangoコンテナの作成

ここからは、DjangoとMySQLのコンテナをDocker Composeで構築していきます。
「compose.yaml」を作成して、DjangoとMySQLコンテナを作成します。

　今回はDocker Hub上に新しいDjangoイメージがなかったため、Pythonベースの独自イメージを作成します。

DjangoはPythonで動作するため、Pythonイメージをベースにして必要なライブラリを追加します👇

この2つを自動的に導入する オリジナルDockerイメージ を作成していきます。

🧹 作業前のクリーンアップ

古いコンテナや未使用のイメージが残っていると、思わぬトラブルの原因になります。
まずはDocker環境を整理して、スッキリした状態から始めましょう。

docker system prune -a --volumes

💬 ワンポイント

「思い切ってリセットしたいとき」に便利です。
ただし、必要なイメージも消える可能性があるので注意してくださいね。

実行結果

PS C:\Users\joeac> docker system prune -a --volumes
WARNING! This will remove:
  - all stopped containers
  - all networks not used by at least one container
  - all anonymous volumes not used by at least one container
  - all images without at least one container associated to them
  - all build cache

Are you sure you want to continue? [y/N] y

📁 作業用ディレクトリを作成しよう

Docker Composeを使うには、compose.yaml があるディレクトリで作業する必要があります。
まずはプロジェクト用フォルダを作って、そこに移動します。

cd desktop/docker
mkdir django2
cd django2

実行結果

PS C:\Users\joeac> cd desktop/docker
PS C:\Users\joeac\Desktop\docker> mkdir django2

    Directory: C:\Users\joeac\Desktop\docker

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----          2025/10/18    22:19                django2

PS C:\Users\joeac\Desktop\docker> cd django2
PS C:\Users\joeac\Desktop\docker\django2>

このディレクトリに、Dockerfile と compose.yaml を作成していきます。

🧱 Dockerfileの作成

VSCodeを開いて、新しく Dockerfile を作りましょう。

code Dockerfile

以下の内容を入力して保存します👇

FROM python:3.10
WORKDIR /code
ADD requirements.txt /code
RUN pip install -r requirements.txt
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

💬 ポイント

requirements.txt に必要なライブラリをまとめておくと、後で環境を再現しやすくなります。

📦 requirements.txt の作成

次に、Pythonで使うライブラリをまとめた requirements.txt を作成します。

code requirements.txt

内容は以下の通りです👇

Django==4.0.2
mysqlclient

⚙️ compose.yaml の作成

次に、DjangoとMySQLを一緒に動かすための compose.yaml を作ります。

ここでは、Docker Composeを使って Django＋MySQL の開発環境を構築します。
　特にコンテナ間の連携を安定させるために重要なhealthcheck、depends_on、command の3つの設定を詳しく解説します。

code compose.yaml

以下のように編集して保存します👇

version: "3.9"

services:
  mysql:
    image: mysql:8.0
    container_name: mysql_container
    environment:
      MYSQL_ROOT_PASSWORD: root-pass
      MYSQL_DATABASE: test-db
      MYSQL_USER: test-user
      MYSQL_PASSWORD: test-pass
    volumes:
      - db-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 5s
      timeout: 3s
      retries: 5
      start_period: 5s

  django:
    build: .
    container_name: django_container
    depends_on:
      mysql:
        condition: service_healthy
    ports:
      - "8000:8000"
    volumes:
      - ./:/code
    command: >
      python manage.py runserver 0.0.0.0:8000

volumes:   # 👈 services: と同じ階層に置く（ここが重要）
  db-data:

この設定では、
「MySQLコンテナ → Djangoコンテナ」の順で確実に起動し、
MySQLが正常に稼働したことを確認してからDjangoを起動するようになっています。
その鍵を握るのが healthcheck と depends_on の連携です。

🩺 healthcheck とは？

healthcheck は、コンテナの内部状態を自動的に確認するための機能です。
単にコンテナが“起動している”だけでなく、“アプリが実際に動作可能か”を監視します。

　DjangoとMySQLを連携させる際、MySQLの起動が完全に完了する前にDjangoが接続を試みると失敗します。
そのため、healthcheck によって「MySQLが応答可能な状態かどうか」を定期的にチェックします。

🧠 設定内容の詳細解説

healthcheck:
  test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
  interval: 5s
  timeout: 3s
  retries: 5
  start_period: 5s

💡 ポイント

　mysqladmin ping はMySQLサーバに軽い通信を行い、「mysqld is alive」という応答が返ってくれば正常です。
これが失敗した場合、Composeは「このコンテナはまだ健康状態ではない」と判断します。

🔗 depends_on とは？

depends_on は、コンテナの起動順序や依存関係を指定する設定です。
　DjangoがMySQLに依存しているため、MySQLが「起動してから」Djangoを起動させる必要があります。

Composeの旧仕様（v2以前）では、
「MySQLコンテナの起動完了＝Django起動OK」と判断されていましたが、
実際にはMySQLが応答可能（healthy）になるまで数秒かかることがあります。

この問題を解決するために、
depends_on に condition: service_healthy を追加します。

🧠 設定内容の詳細解説

depends_on:
  mysql:
    condition: service_healthy

💡 ポイント

service_healthy は healthcheck の結果と連動します。
MySQLがまだ「unhealthy」の場合、Djangoの起動は待機状態となります。
これにより、Djangoが「接続エラー」で落ちることを防ぎます。

🔁 動作の流れ

💬 command とは？

command は、コンテナ起動時に実行されるコマンドの上書き設定です。
　Dockerfile内で CMD を定義していても、Composeファイルの command に記述した内容が優先されます。

Djangoの場合、開発用サーバを起動するために以下を指定します。

command: >
  python manage.py runserver 0.0.0.0:8000

💡 補足

これを指定することで、ホスト（WindowsやMac）から
http://localhost:8000 にアクセスしてDjangoを確認できます。

🖥️ 動作の仕組み

コンテナが起動すると、次の流れで処理されます。

1. MySQLコンテナが healthcheck で監視される。
2. MySQLが healthy 状態になる。
3. Djangoコンテナが起動（depends_on により制御）
4. Djangoが python manage.py runserver 0.0.0.0:8000 を実行
5. ブラウザから localhost:8000 にアクセスするとDjangoのTOPページが表示

✅ 要約

これら3つを組み合わせることで、
MySQLが確実に起動→Djangoが安全に接続→Webサーバが正常動作
という安定した開発環境が構築できます。

✅ まとめ

ここまでで、以下の準備が完了しました👇

この続きは「開発環境コンテナ：Django＋MySQL②」で、
Djangoプロジェクトを実際に作成して、Djangoコンテナを作成して接続していきます。