＜Python＞DjangoをDocker環境で構築する

下準備
Djangoプロジェクト

下準備

まずはローカル環境のお好きなフォルダに以下の3つのファイルを作成してください。

Dockerfile

FROM python:3.9
ENV PYTHONUNBUFFERED=1
WORKDIR /webapp
COPY requirements.txt /webapp/
RUN pip install --upgrade pip
RUN pip install -r requirements.txt
COPY . /webapp/

この Dockerfile ファイルは、Python 3.9 環境で動作するウェブアプリケーションの Docker イメージを作成するための設定ファイルです。以下に各行の説明を示します。

FROM python:3.9:
この行は、ベースイメージとして Python 3.9 を使用することを指定しています。これにより、Python 3.9 がインストールされた状態のコンテナが作成されます。
ENV PYTHONUNBUFFERED=1:
この環境変数設定は、Python の標準出力と標準エラーのバッファリングを無効にします。これにより、ログがリアルタイムで出力されるようになります。
WORKDIR /webapp:
この行は、コンテナ内の作業ディレクトリを /webapp に設定します。以降のコマンドはこのディレクトリ内で実行されます。
COPY [requirements.txt](http://_vscodecontentref_/1) /webapp/:
ローカルの requirements.txt ファイルをコンテナ内の /webapp/ ディレクトリにコピーします。このファイルには、プロジェクトで必要な Python パッケージがリストされています。
RUN pip install --upgrade pip && pip install -r requirements.txt:
まず、pip を最新バージョンにアップグレードし、その後 requirements.txt に記載されたパッケージをインストールします。このコマンドにより、プロジェクトに必要な依存関係がすべてインストールされます。
COPY . /webapp/:
ローカルのプロジェクトディレクトリ全体をコンテナ内の /webapp/ ディレクトリにコピーします。これにより、プロジェクトのソースコードやその他のファイルがコンテナ内に配置されます。

この Dockerfile により、Python 3.9 環境で必要な依存関係がインストールされた状態のコンテナを簡単に構築することができます。

requirements.txt

Django>=4.0,<5.0

この requirements.txt ファイルは、Python プロジェクトで必要なパッケージとそのバージョンを指定するためのファイルです。このファイルを使用することで、プロジェクトの依存関係を簡単に管理し、他の開発者が同じ環境を再現できるようにします。

プロジェクトが Django バージョン 4.0 以上、5.0 未満のバージョンを必要としていることを示しています。つまり、Django 4.x 系のバージョンがインストールされることを期待しています。このようにバージョン範囲を指定することで、互換性のあるバージョンを柔軟に使用できるようにしつつ、将来的なメジャーバージョンアップによる互換性の問題を避けることができます。

この設定により、pip install -r requirements.txt コマンドを実行すると、適切なバージョンの Django がインストールされ、プロジェクトが正常に動作するようになります。

docker-compose.yml

services:
  web:
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/webapp
    ports:
      - "8000:8000"

この docker-compose.yml ファイルは、Docker Compose を使用して複数のコンテナを定義および管理するための設定ファイルです。ここでは、Python ベースのWEBアプリケーションを実行するための設定が記述されています。以下に各行の説明を示します。

services::
このセクションでは、複数のサービス（コンテナ）を定義します。ここでは web という名前のサービスが定義されています。
web::
web サービスは、WEBアプリケーションを実行するためのコンテナを定義しています。
build: .:
この行は、現在のディレクトリ（.）にある Dockerfile を使用してイメージをビルドすることを指定しています。
command: python [manage.py](http://_vscodecontentref_/2) runserver 0.0.0.0:8000:
この行は、コンテナが起動したときに実行されるコマンドを指定しています。ここでは、Django の開発サーバーをホストの全ての IP アドレス（0.0.0.0）でポート 8000 で起動するように指示しています。
volumes::
このセクションでは、ホストとコンテナ間で共有されるディレクトリを指定します。
- .:/webapp は、ホストの現在のディレクトリ（.）をコンテナ内の /webapp ディレクトリにマウントします。これにより、ホスト側のファイル変更がコンテナ内に反映されます。
ports::
このセクションでは、ホストとコンテナ間で公開されるポートを指定します。- "8000:8000" は、ホストのポート 8000 をコンテナのポート 8000 にマッピングします。これにより、ホストのポート 8000 でウェブアプリケーションにアクセスできるようになります。

この docker-compose.yml ファイルにより、Django ウェブアプリケーションを簡単にコンテナ化し、開発環境で実行することができます。

Djangoプロジェクト

Djangoプロジェクトの作成

docker-compose run web django-admin startproject youre-container-name .

このコマンドは、Docker Compose を使用して Django プロジェクトを新規作成するためのものです。以下に各部分の説明を示します。

docker-compose run web:
Docker Compose を使用して、web サービスを実行します。web サービスは、docker-compose.yml ファイルで定義されています。
django-admin startproject youre-container-name .:
django-admin コマンドを使用して、新しい Django プロジェクトを作成します。startproject は新しいプロジェクトを開始するためのサブコマンドです。youre-container-name はプロジェクトの名前で、. は現在のディレクトリにプロジェクトを作成することを示しています。