If you just want to get started on a fresh Django project, take a look at djangae-scaffold
Alternatively, you can also follow this guide:
- Create a Django project, add app.yaml to the root. Make sure Django 1.8+ is in your project and importable.
- Install Djangae into your project, make sure it's importable (you'll likely need to manipulate the path in manage.py and wsgi.py).
INSTALLED_APPS. This must come before any
- We also recommend that you:
INSTALLED_APPS. This must come after
'django.contrib.contenttypes'. (Please note that this is only really required if you are using the Datastore.)
- At the top of your
settings.py, insert the following line to setup some default settings:
from djangae.settings_base import *
app.yaml add the following handlers:
* url: /_ah/(mapreduce|queue|warmup).* script: YOUR_DJANGO_APP.wsgi.application login: admin * url: /.* script: YOUR_DJANGO_APP.wsgi.application
manage.py look something like this:
if __name__ == "__main__": os.environ.setdefault("DJANGO_SETTINGS_MODULE", "myapp.settings") from djangae.core.management import execute_from_command_line, test_execute_from_command_line if "test" in sys.argv: # This prevents the local sandbox initializing when running tests test_execute_from_command_line(sys.argv) else: execute_from_command_line(sys.argv)
Use the Djangae WSGI handler in your wsgi.py, something like
from django.core.wsgi import get_wsgi_application from djangae.wsgi import DjangaeApplication application = DjangaeApplication(get_wsgi_application())
Add the following to your URL handler:
It is recommended that for improved security you add
djangae.contrib.security.middleware.AppEngineSecurityMiddleware as the first of your middleware classes. This middleware patches a number of insecure parts of the Python and App Engine libraries and warns if your Django settings aren't as secure as they could be.
If you wish to use the App Engine's Google Accounts-based authentication to authenticate your users, and/or you wish to use Django's permissions system with the Datastore as you DB, then see the section on Authentication.
It is highly recommended that you read the section on Unique Constraints
Create a Google App Engine project.
app.yaml and change
$ appcfg.py update ./
If you are using multiple modules in your app. Just set the following setting in your Django settings:
DJANGAE_ADDITIONAL_MODULES = [ "path/to/module.yaml", "path/to/other_module.yaml" ]
These modules will then be launched by the runserver command automatically and be given sequential ports after the default module (e.g. 8000, 8001, 8002 etc.)