以前までは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に記述します。
Django>=3.2,<3.3
psycopg2-binary>=2.8
インストールするDjangoとPostgreSQLをDjango使うために必要なパッケージを記述します。
メジャーバージョンだけ上がらないようにしており、かなりバージョンが雑に指定しているので、Django>=3.2,<3.3とか絞ったほうが本来はいいと思います。
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につなげるからデータ保存などできる。
...
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'postgres',
'USER': 'postgres',
'PASSWORD': 'postgres',
'HOST': 'db',
'PORT': 5432,
}
}
...
docker-compose up でDjango起動
では、起動コマンド。
docker-compose up
これでエラーが出なければこんなふうに起動すると思います。
はい、ちゃんと起動しました！！
その他の設定
以降は必須でないです。すでにDocker + Docker + PostgreSQLは使えます。
チャレンジしてもいいと思います。
Djangoの設定いじる
日本時間の方が都合がいいと思うのでいじります。
LANGUAGE_CODE = 'ja'
TIME_ZONE = 'Asia/Tokyo'
日本語なりました。管理画面や、時間を扱うとき地味に重要です。
DBのデータをpushするのはよくない
現状だとDBのデータや設定が書いてある大量のファイルがpushされます。差分が大量にあるのも良くないし、見せてはいけないデータあったら大変なのでgithubにpushされないようにします。
.gitignoreを作って、/dataを追加してください。差分が激減します。
ついでに、Python関係で一般的にpushされるとやばいファイルについても追加したものがソースコードにありますので、必要な方はコピペしてください。
data/
docker-composeで環境変数を設定
まあ、必要ないけどデプロイのとき環境変数の使い方知ってるとよいので設定しておきます。
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')),
}
}
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で手に入ります。
最初は少し時間かかるかも。
終わったら、こんな感じでちゃんとコマンド使えます。
ソースコード
この章のコードは以下です。確認やコピペでどうぞ