1 准备环境
开发环境还是建议使用 Docker 来搭建，方便快捷。 不过 Django 的官方镜像已经弃用了，官方建议新版本使用 Python 官方提供的镜像来构建。
Docker
┗ Python == 3.9.12-buster
┗ Django == 3.2.13 LTS
┗ django-simpleui==2022.11.30
可以参考[https://github.com/Cuile/Docker-to-Python/tree/master/Django]，提供了 Dockerfil、yml 文件，还提供全套使用命令。
2 创建项目
# 创建项目
$ django-admin startproject mysite
$ cd mysite
# 生成项目
$ python manage.py startapp websrc
# 运行项目测试
$ python manage.py runserver 0.0.0.0:80
修改配置后，建议使用项目调试的方式启动，不要使用快捷命令，项目正常启动稳定运行后，再使用快捷命令。
# settings.py
# 任意地址都可以访问 Django
ALLOWED_HOSTS = ['*']
# 添加 simpleui 模板，和创建的项目
INSTALLED_APPS = [
'simpleui',
'websrc',
'......',
]
# 这个与多语种有关，在项目初始阶段不要修改，后续添加了多语种支持再修改，否则会导致无法启动。
# 具体参考(http://www.i18nguy.com/unicode/language-identifiers.html)，有个傻逼教程，上来就改成 zh-CN 果然导致项目无法正常启动。
# 正确的简体中文代码如下：
LANGUAGE_CODE = 'zh-Hans'
# 时区，上海就代表北京时间，这个不能写错，写错就启动不了
# 具体参考(https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)，这里是标准的，有个傻逼教程非给写成 Asia/Beijing 导致怎么都起不来，太TMD的二逼了。
# 正解的北京时间时区如下：
TIME_ZONE = 'Asia/Shanghai'
# 启动翻译，与上面的 LANGUAGE_CODE 设置相对应
USE_I18N = True
# 启动格式控制
USE_L10N = True
# 启动时区
USE_TZ = True
3 创建管理员账号
$ python manage.py createsuperuser
Username: admin
Email address: [email protected]
Password: **********
Password (again): *********
Superuser created successfully.
访问项目链接，比如"http://127.0.0.1:8000/admin/
4 创建数据模型
4.1 编辑 models.py 文件，改变模型
……
4.2 为模型的改变生成迁移文件
$ python manage.py makemigrations websrc
Migrations for 'websrc':
polls/migrations/0001_initial.py
- Create model Question
- Create model Choice
可以查看生成的SQL语句
$ python manage.py sqlmigrate websrc 0001
4.3 应用数据库迁移
$ python manage.py migrate
Operations to perform:
Apply all migrations: admin, auth, contenttypes, polls, sessions
Running migrations:
Rendering model states... DONE
Applying websrc.0001_initial... OK
5 向管理页面加入数据模型
# websrc/admin.py
from django.contrib import admin
from .models import Question
admin.site.register(Question)
6 Gunicorn 托管 Django
6.1 安装 Gunicorn
参考文档
6.2 收集静态文件
$ python manage.py collectstatic
# 如果报错
django.core.exceptions.ImproperlyConfigured: You're using the staticfiles app without having set the STATIC_ROOT setting to a filesystem path.
需要修改 settings.py ，添加 STATIC_ROOT
# <myproject>/settings.py
# STATICFILES_DIRS = [os.path.join(BASE_DIR, "static"), ]
STATIC_ROOT = os.path.join(BASE_DIR, "static")
如果你从 INSTALLED_APPS 中删除一个应用程序，最好使用 collectstatic –clear 选项来删除过时的静态文件。
参考文档
6.3 设置静态文件路由
# <myproject>/urls.py
...
urlpatterns = [
...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
参考文档
7 Supervisor 启动 Gunicorn
注意：使用 docker 时，要确保 nodaemon 选项为 true，否则 docker 不能正常启动
[supervisord]
nodaemon=true
参考文档