DjangoAppEngine 开源项目快速入门指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00429/article/details/142085796

DjangoAppEngine 开源项目快速入门指南

djangoappengineDjango backends for App Engine (datastore, mail, ...)项目地址:https://gitcode.com/gh_mirrors/dj/djangoappengine

本指南旨在帮助您了解和快速上手 DjangoAppEngine 这一开源项目，它使Django能够运行在Google App Engine之上。我们将通过分析其核心结构、关键文件以及基本配置来引导您步入这个混合世界。

1. 项目的目录结构及介绍

DjangoAppEngine项目通常遵循标准的Django应用结构，但在结合App Engine特性时可能会有所调整。下面是一个典型的项目目录结构示例：

djangoappengine/
├── app.yaml            # App Engine配置文件，定义服务属性和服务端点。
├── requirements.txt    # 依赖库列表，列出项目运行所需的Python包。
├── manage.py           # Django项目的管理脚本，用于数据库迁移、运行服务器等任务。
├── your_django_project/ # 您的Django项目目录
│   ├── settings.py     # 主配置文件，包括数据库设置、中间件、应用程序安装等。
│   ├── urls.py         # URL配置，映射HTTP请求到视图函数。
│   ├── wsgi.py         # WSGI兼容的应用程序接口文件，用于部署时的服务请求。
│   └── ...             # 其他Django应用的模块和资源
├── static/             # 静态文件目录（如CSS, JS），虽然对于App Engine，静态文件可能存放在Cloud Storage。
└── templates/          # HTML模板文件夹，存放所有视图使用的模板。

2. 项目的启动文件介绍

`manage.py`

manage.py 是Django提供的命令行工具入口。通过它，您可以执行多种管理任务，如数据库迁移 (makemigrations, migrate)、创建超级用户 (createsuperuser)、运行开发服务器 (runserver) 等。在与DjangoAppEngine结合使用时，它也可能是启动自定义管理命令或进行特定于App Engine的准备工作的起点。

python manage.py runserver_plus

注意，由于App Engine环境的特殊性，您在本地测试时可能会使用不同的命令或工具，例如模拟App Engine环境的命令。

3. 项目的配置文件介绍

`settings.py`

settings.py 中包含了项目的核心配置。对于DjangoAppEngine，您的配置需要特别适应App Engine，这涉及到几项关键更改：

数据库配置: 使用App Engine支持的数据存储，比如使用CloudSQL作为后端，并相应地配置DATABASES变量。

DATABASES = {
    'default': {
        'ENGINE': 'djangoappengine.db.ndb',
        # 对于CloudSQL, 配置应有所不同
        # 'ENGINE': 'django.db.backends.mysql',
        # 'NAME': 'your_db_name', 
        # 'USER': 'your_db_user', 
        # 'PASSWORD': 'your_db_password',
        # 'HOST': '/cloudsql/your-instance-name'
    }
}

DEBUG模式: 在生产环境中务必设为False，以提高安全性。
```
DEBUG = False
```
中间件调整: 可能需要调整以适配App Engine的需求，比如处理session和CSRF。
静态文件服务: 在开发过程中，您可能通过Django服务器直接访问静态文件，但实际部署时应指向Cloud Storage路径。