以前まではwindows 10 ProでないとDocker使えませんでしたが、Windows 10 Home でもDockerが簡単に使えるようになっています。MacとかWindows 10 Proの導入はたくさんあるけど、長年Homeで使えなかったので今回記事にします。
Django(Python)の記事をよく書いていますのでwindows homeで環境を構築しようと思います

すでにDocker使ってて、Docker + Django + PostgreSQLの環境構築したい人はDockerでDjangoを動かすから見れば構築できると思います。

環境

Windows 10 Home 21H1
Docker Desktop for Windows 4.0.0

まあ、最近のwindowsのアップデートちゃんとやってれば使えると思います

Dockerで構築するDjango環境

ローカルで開発するときに使えるDjango構築していきます。

Django 3.2
PostgreSQL

こちらは、慣れてきたら変更可能なので適時変更してください。

ついでに、Django関係で初心者向け記事も書いてますのでよろしければ。

【Python Django】初心者プログラマーのWebアプリ

【丁寧解説】秒速でもDjango 3アプリをAWS EC2で公開【Nginx, gunicorn, postgresqlデプロイ】

ソースコード

この章の完成時コードは以下です。確認やコピペでどうぞ

ダウンロードとインストール

Docker Desktop Installer.exeをダウンロードしてください。

実行する。

結構時間かかるかも。ポチポチ進めていけばOK

Close and restartとかCloseとか出るので押してください。

これでOKかと思ったらWSL2のインストール必要みたいです。
まあ面倒なのがここだけですので頑張りましょう。

ダウンロード先

x64 マシン用 WSL2 Linux カーネル更新プログラムパッケージ
みたいなリンクあるのでダウンロードしてください。

ダウンロードできたら実行。

Next押して行ってFinish押せば完了しました。
再起動したらインストール作業は完了です。

Dockerを起動して右下のクジラが白いのが正常です。

windows 10 homeでDocker使いたいだけの人ならこれで終了です。

DockerでDjangoを動かす

これ以降はDjango環境をローカルに構築します。
最初に起動したらDockerのチュートリアルも表示されたと思いますが、今回はDjangoの環境を構築してみましょう。

フォルダ作って`Dockerfile`を作成

好きなところにフォルダ作ってその中にDockerfileを作成します。
Dockerfileがよくわからない方は環境の作る手順書かれたファイルみたいに思っておけばいいかと。

# syntax=docker/dockerfile:1
FROM python:3
ENV PYTHONUNBUFFERED=1
WORKDIR /app
COPY requirements.txt /app/
RUN pip install -r requirements.txt
COPY . /app/

細かく内容説明

使いたいだけなら次にいってOK

FROM python:3: Python 3 の最新イメージを使用
ENV PYTHONUNBUFFERED=1: 「ENV」は環境変数の設定。Python使うときの環境変数
WORKDIR /app: これ以降どこのディレクトリで作業するか
COPY requirements.txt /app/: ファイルコピーrequirements.txtを作りましたよね。- - /appにディレクトリにコピーしてる。仮想環境なのでコンテナの中には今のところファイル存在ないのでコピー必要
RUN pip install -r requirements.txt: RUNがコマンド実行ということ。pip installして必要パッケージをテキストで記述してまとめてインストールするために使う
COPY . /app/: この時点でrequirements.txtしかファイル存在してない。これではアプリ動きようがないのでDjangoアプリのファイル全部コピーしてる

requirements.txt作成してインストールするパッケージを記述

先ほどDockerfileでも触れましたがDokcerの環境で使用するパッケージをまとめてインストールしてもらうためにrequirements.txtに記述します。

requirements.txt

Django>=3.2,<3.3
psycopg2-binary>=2.8

インストールするDjangoとPostgreSQLをDjango使うために必要なパッケージを記述します。

メジャーバージョンだけ上がらないようにしており、かなりバージョンが雑に指定しているので、Django>=3.2,<3.3とか絞ったほうが本来はいいと思います。

`docker-compose.yml`作成

とりあえず動けばいいかくらいの設定です。

docker-compose.yml

version: "3.9"

services:
  db:
    image: postgres
    volumes:
      - ./data/db:/var/lib/postgresql/data
      environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
  web:
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/app
    ports:
      - "8000:8000"
    depends_on:
      - db

細かく内容説明

使いたいだけなら次にいってOK

version: Docker-composeのバージョン「3」とかでもいいです。
services: 今回使うのはPostgreSQL、Djangoアプリなのでそれぞれ「db」「web」という名前つけてます。
- db: イメージは取得してきたpostgresを使用します。既製品という感じ？
  - volumes: コンテナってデータ保持能力ないんです。動いてるときはいいけど、毎回消えます。それだとDBの意味ないですよね。ということでローカルの./data/dbに保存したというか、共有したというか思っておけばとりあえずいいと思います。
  - environment: コンテナ内だけで使う環境変数設定できるので設定。
- web: Djangoアプリ用。Linux環境にPython入ってる環境を改造して色々入れてる感じ。
  - build: . つまりdocker-composeにあるディレクトリでビルドしてる。dockerfileのディレクトリ注意
  - command:　コマンド実行してるサーバー立ち上げてる。ついでに起動した開発サーバー止まるとコンテナ止まる。
  - ports:　ポートフォワード。ホスト側8000番→コンテナ8000番に通してる。だからブラウザにlocalhost:8000で繋げることができてる。
  - environment: settings.pyで使う環境変数なので重要
  - depends_on: DB起動してからでないとDjango使えないというか、エラー出るので上で決めた「db」が起動してから「web」起動してねってこと

Djangoのプロジェクト作成

コマンドラインにて以下を実行。今回はプロジェクト名はappで作ります。

docker-compose run web django-admin startproject app .

docker-compose runが単体で起動。webと定義したもので、django-admin startproject app .を実行してください、ということ。

Django使ったことある人ならわかると思うけど、Djangoで最初にプロジェクト始めるためのコマンド。

初めて実行すると構築に必要なイメージを勝手に取得してくれますのでしばらくかかります。

 => [2/5] WORKDIR /app                                                                                                                                                    36.1s 
 => [3/5] COPY requirements.txt /app/                                                                                                                                      0.2s 
 => [4/5] RUN pip install -r requirements.txt                                                                                                                             10.4s 
 => [5/5] COPY . /app/                                                                                                                                                     1.7s 
 => exporting to image                                                                                                                                                     1.2s 
 => => exporting layers                                                                                                                                                    1.2s 
 => => writing image sha256:394255b3848438c6533f150499a35141a7c2a886a143aa4e34b4c57adb5z59ac                                                                               0.0s 
 => => naming to docker.io/library/django_docker_web                                                                                                                       0.0s 

Use 'docker scan' to run Snyk tests against images to find vulnerabilities and learn how to fix them

こんな感じの表示出たらOK

volumeにDBの記載したからDB関係のファイル大量にできるはず。pushするとかで気になる人は後で記述する.gitignoreで除外するようにしてください。

settings.pyにDBの設定を追加

DB起動できないので設定を変更。とりあえず、これでDBにつなげるからデータ保存などできる。

django_docker/app/settings.py

...

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'postgres',
        'USER': 'postgres',
        'PASSWORD': 'postgres',
        'HOST': 'db',
        'PORT': 5432,
    }
}

...

docker-compose up でDjango起動

では、起動コマンド。

docker-compose up

これでエラーが出なければこんなふうに起動すると思います。

http://localhost:8000/

はい、ちゃんと起動しました！！

その他の設定

以降は必須でないです。すでにDocker + Docker + PostgreSQLは使えます。
チャレンジしてもいいと思います。

Djangoの設定いじる

日本時間の方が都合がいいと思うのでいじります。

django_docker/app/settings.py

LANGUAGE_CODE = 'ja'

TIME_ZONE = 'Asia/Tokyo'

日本語なりました。管理画面や、時間を扱うとき地味に重要です。

DBのデータをpushするのはよくない

現状だとDBのデータや設定が書いてある大量のファイルがpushされます。差分が大量にあるのも良くないし、見せてはいけないデータあったら大変なのでgithubにpushされないようにします。

.gitignoreを作って、/dataを追加してください。差分が激減します。
ついでに、Python関係で一般的にpushされるとやばいファイルについても追加したものがソースコードにありますので、必要な方はコピペしてください。

.gitignore

data/

docker-composeで環境変数を設定

まあ、必要ないけどデプロイのとき環境変数の使い方知ってるとよいので設定しておきます。

django_docker/app/settings.py

import os
...

SECRET_KEY = os.environ.get('SECRET_KEY')

...

DEBUG = bool(int(os.environ.get('DEBUG', 0)))

...

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': os.environ.get('DB_NAME'),
        'USER': os.environ.get('DB_USER'),
        'PASSWORD': os.environ.get('DB_PASSWORD'),
        'HOST': os.environ.get('DB_HOST'),
        'PORT': int(os.environ.get('DB_PORT')),
    }
}

django_docker/docker-compose.yml

services:
  db:
    image: postgres
    volumes:
      - ./data/db:/var/lib/postgresql/data
    environment:
      - DB_NAME=postgres
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - DB_HOST=db
      - DB_PORT=5432
      - DEBUG=1
      - SECRET_KEY=devsecretkey
    depends_on:
      - db

ついでに、起動するときに--buildつけるとビルドして起動してくれるから便利。

docker-compose up --build

問題なく起動するか確認してくださいね。

VS Codeの拡張機能でWindows使いながらLinux使う

補足情報です。やりたい人だけで構いません。

Windowsだとコマンドプロンプト使わないといけなかったり、色々面倒なことあります。
Windows使ってるけど、Linux使いたいなーという人に役立つ機能。

VS codeの拡張機能追加でRemote Developmentと検索して追加。

左下の緑のボタン押してやると選択項目出るのでOpen Folder in Container
私の場合はdjango_dockerを指定。

From Dockerfile選ぶと今回構築に使用したPythonイメージ、つまりLinux開発環境がWindowsで手に入ります。
最初は少し時間かかるかも。

終わったら、こんな感じでちゃんとコマンド使えます。

ソースコード

この章のコードは以下です。確認やコピペでどうぞ

Windows 10 HomeへDockerをインストールしてDjango + PostgreSQL環境作る

環境

Dockerで構築するDjango環境

ソースコード

ダウンロードとインストール

DockerでDjangoを動かす

フォルダ作ってDockerfileを作成

細かく内容説明

requirements.txt作成してインストールするパッケージを記述

docker-compose.yml作成

細かく内容説明

Djangoのプロジェクト作成

settings.pyにDBの設定を追加

docker-compose up でDjango起動

その他の設定

Djangoの設定いじる

DBのデータをpushするのはよくない

docker-composeで環境変数を設定

VS Codeの拡張機能でWindows使いながらLinux使う

ソースコード

フォルダ作って`Dockerfile`を作成

`docker-compose.yml`作成