Deploy Django projects on Google App Engine with ease
Project description
Appengine Toolkit pimps Django with some utilities that help deploying projects on Google App Engine with Google Cloud SQL as data backend.
Features
collects project dependencies symlinking needed modules and packages and configuring App Engine environment
configures DATABASE setting parsing connection strings similar to those on Heroku
provides a custom storage for Google Cloud Storage
Documentation
The full documentation is at http://django-appengine-toolkit.rtfd.org.
A tutorial was published on Google Developers Blog
AppEngine SDK version supported: 1.9.2
Quickstart
Install appengine-toolkit:
pip install django-appengine-toolkit
Add it to the installed apps:
INSTALLED_APPS = ( # ... 'appengine_toolkit', )
To automatically configure database settings by parsing connection string contained in DATABASE_URL enviroment var:
import appengine_toolkit DATABASES = { 'default': appengine_toolkit.config(), }
You can set DATABASE_URL directly in your app.yaml file:
env_variables: DJANGO_SETTINGS_MODULE: 'myapp.settings' DATABASE_URL: 'mysql://root@project_id:instance_id/database_name'
To collect project dependencies, first configure Appengine Toolkit in your settings file, specifying the full path to your app.yaml file:
APPENGINE_TOOLKIT = { 'APP_YAML': os.path.join(BASE_DIR, '../../', 'app.yaml'), }
…then run the command collectdeps specifying the requirement file containing the list of packages needed by your project to run:
python manage.py collectdeps -r my_requirements.txt
a folder named libs will be created on your application root (i.e. the same folder where the YAML file resides) containing symlinks needed by App Engine to include dependencies in the production runtime enviroment.
A file appengine_config.py will be created in the same folder and will contain code needed to configure the environment. If you need to customize the module appengine_config tell the command to not overwrite it - the command will then output the code you need to paste inside the module to complete the configuration process
Need to store your media files on Google Cloud Storage? Just add this to your settings:
APPENGINE_TOOLKIT = { # ..., 'BUCKET_NAME': 'your-bucket-name', } DEFAULT_FILE_STORAGE = 'appengine_toolkit.storage.GoogleCloudStorage'
History
0.2.0 (2014-01-09)
Fixed setup requirements for GCS library
App Engine SDK 1.9 compatibility
0.2.0 (2014-01-09)
Added support for Google Cloud Storage
0.1.2 (2013-12-04)
Fixed setup script
0.1.1 (2013-12-04)
Finished first draft of docs
0.1.0 (2013-11-30)
First release on PyPI.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-appengine-toolkit-0.2.1.tar.gz
.
File metadata
- Download URL: django-appengine-toolkit-0.2.1.tar.gz
- Upload date:
- Size: 10.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4cdd59c7499c7c7656b965062aa42c95f8297fa083909dcca60dbbf68b48cb79 |
|
MD5 | 29dba43d43aaac733ebad4548e2bd42b |
|
BLAKE2b-256 | d311c71cd1c4f77a528ff9904c7a1d2c6ac3127987ea51cd3009f86f65961d75 |