- Python 仮想環境の作成
- Django のインストール
- Django プロジェクトの作成
- Django アプリケーションの作成
- アプリケーションをプロジェクトに登録
- 動作確認
- 初期マイグレーション
- 管理ユーザーの作成
1. Python 仮想環境の作成
仮想環境を作成したいディレクトリへ行き、下記のコマンドを実行します。例として「sample_venv」という仮想環境を作ります。
python3 -m venv sample_venv
すると下記の様に Python の実行に必要なファイルやフォルダが一式作成されます。
これで仮想環境の作成は完了です。実際に仮想環境「sample_venv」を起動するには下記を実行します。
% cd sample_venv % source bin/activate
下記の様にカッコの中に仮想環境の名前が表示されると思います。
(sample_venv) %
仮想環境から出たい場合は「deactivate」を実行します。
(sample_venv) % deactivate %
2. Django のインストール
仮想環境で Django をインストールするには、仮想環境を activate した状態で下記を実行します。
(sample_venv) % pip install django
下記のようなログが表示されて最後の方に「Successfully installed」と出ていれば成功です。
(sample_venv) % pip install django
Collecting django
Downloading https://files.pythonhosted.org/packages/b8/6f/9a4415cc4fe9228e26ea53cf2005961799b2abb8da0411e519fdb74754fa/Django-3.1.7-py3-none-any.whl (7.8MB)
|████████████████████████████████| 7.8MB 337kB/s
Collecting asgiref<4,>=3.2.10 (from django)
Downloading https://files.pythonhosted.org/packages/89/49/5531992efc62f9c6d08a7199dc31176c8c60f7b2548c6ef245f96f29d0d9/asgiref-3.3.1-py3-none-any.whl
Collecting sqlparse>=0.2.2 (from django)
Downloading https://files.pythonhosted.org/packages/14/05/6e8eb62ca685b10e34051a80d7ea94b7137369d8c0be5c3b9d9b6e3f5dae/sqlparse-0.4.1-py3-none-any.whl (42kB)
|████████████████████████████████| 51kB 9.6MB/s
Collecting pytz (from django)
Downloading https://files.pythonhosted.org/packages/70/94/784178ca5dd892a98f113cdd923372024dc04b8d40abe77ca76b5fb90ca6/pytz-2021.1-py2.py3-none-any.whl (510kB)
|████████████████████████████████| 512kB 8.1MB/s
Installing collected packages: asgiref, sqlparse, pytz, django
Successfully installed asgiref-3.3.1 django-3.1.7 pytz-2021.1 sqlparse-0.4.1
WARNING: You are using pip version 19.2.3, however version 21.0.1 is available.
You should consider upgrading via the 'pip install --upgrade pip' command.
(sample_virtual_environment) %
これで Python の仮想環境に Django がインストールされたので、この後 Django のプロジェクト、アプリケーションを作っていきます。
3. Django プロジェクトの作成
仮想環境に入った状態で下記を実行します。今回は例として仮想環境内に「Django_Project」フォルダを作り、その中に「sample_django_project」という名前の Django プロジェクトを作成します。
(sample_venv) % mkdir Django_Project (sample_venv) % cd Django_Project (sample_venv) Django_Project % django-admin startproject sample_django_project
すると下記の様に「Django_Project」フォルダの配下に「sample_django_project」フォルダとファイルが一式作成されます。
4. Django アプリケーションの作成
上の画像「manage.py」がある階層へ移動します。
(sample_venv) % cd sample_django_project
そして下記を実行して「sample_django_app」という名前で Django アプリケーションを作成します。
(sample_venv) sample_django_project % python manage.py startapp sample_django_app
すると、「sample_django_project」というプロジェクトの配下に「sample_django_app」が作成されました。
5. アプリケーションをプロジェクトに登録
アプリケーションフォルダの apps.py を開くと下記の通り「SampleDjangoAppConfig」というクラスがあるので、このクラス名をプロジェクトの settings.py に登録します。
# apps.py
from django.apps import AppConfig
class SampleDjangoAppConfig(AppConfig):
name = 'sample_django_app'
settings.py の INSTALLED_APPS のリストに下記の通り「アプリケーション名.apps.クラス名」の形で追記します。
# settings.py
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'sample_django_app.apps.SampleDjangoAppConfig'
]
これで Django プロジェクトと Django アプリケーションの作成は完了です。
6. 動作確認
ターミナルでコマンド「python manage.py runserver」を実行し、動作確認をします。
% python manage.py runserver Watching for file changes with StatReloader Performing system checks... System check identified no issues (0 silenced). You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions. Run 'python manage.py migrate' to apply them. April 23, 2021 - 21:27:24 Django version 3.2, using settings 'sample_django_project.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.
特に問題がなければ上記の様なログが表示されるはずです。
そしてブラウザの URL バーに「http://127.0.0.1:8000/」と入力して下記の画面が表示されたら OK です。
停止したい場合は CONTROL-C を押下します。
7. 初期マイグレーション
Django の設定内容やモデルの構造をデータベースへ反映することをマイグレーションと呼びます。
Django ではデフォルトのデータベースとして SQLite が設定されているので他のデータベースを使用する場合は先にデータベースの変更をしてください。例として PostgreSQL を使用する場合の例を下記に貼っておきます。
Django プロジェクトで PostgreSQL のデータベースを利用する（仮想環境内）
Django プロジェクト・アプリケーションの作成時点ではマイグレーションされていない設定内容がいくつかありますのでコマンド「python manage.py migrate」を実行してマイグレーションをおこないます。
% python manage.py migrate Operations to perform: Apply all migrations: admin, auth, contenttypes, sessions Running migrations: Applying contenttypes.0001_initial... OK Applying auth.0001_initial... OK Applying admin.0001_initial... OK Applying admin.0002_logentry_remove_auto_add... OK Applying admin.0003_logentry_add_action_flag_choices... OK Applying contenttypes.0002_remove_content_type_name... OK Applying auth.0002_alter_permission_name_max_length... OK Applying auth.0003_alter_user_email_max_length... OK Applying auth.0004_alter_user_username_opts... OK Applying auth.0005_alter_user_last_login_null... OK Applying auth.0006_require_contenttypes_0002... OK Applying auth.0007_alter_validators_add_error_messages... OK Applying auth.0008_alter_user_username_max_length... OK Applying auth.0009_alter_user_last_name_max_length... OK Applying auth.0010_alter_group_name_max_length... OK Applying auth.0011_update_proxy_permissions... OK Applying auth.0012_alter_user_first_name_max_length... OK Applying sessions.0001_initial... OK
8. 管理ユーザーの作成
仮想環境内、「manage.py」のある階層でコマンド「python manage.py createsuperuser」を実行します。
% python manage.py createsuperuser
するとユーザー名、メールアドレスをパスワードを設定する様促されるので設定を行います。
Username : adminuser #任意のユーザー名 Email address: xxxxxxxx@gmail.com Password: Password (again): Superuser created successfully.
% python manage.py runserver
ブラウザで「http://127.0.0.1:8000/admin/」にアクセスすると、管理ユーザーのログイン画面が表示されます。
ログインすると下記の通り管理ユーザー用画面が表示されます。
