AWS S3/CloudFront
You can launch the deploy server for this sample by manage.py runserver --settings staticsites.tests.samples.03_aws.settings
command. The --settings staticsites.tests.samples.03_aws.settings is necessary only if you want to use
staticsites sample, if you develop on new project is sufficent to use the manage.py runserver command.
In order to launch the sample, you must install django-storages
(pip install django-storages).
This sample deploy four simple files using the Django template system and static files on AWS S3 bucket:
deploy/dev
├── index.html
├── static.html
├── django.png
└── js
└── test.js
To do this, you must to add a setting in your Hello world (with static)
setting.py:
S3BotoStorage configuration
AWS_ACCESS_KEY_ID = 'YOUR_AWS_ACCESS_KEY_ID'
AWS_SECRET_ACCESS_KEY = 'YOUR_AWS_SECRET_ACCESS_KEY'
AWS_STORAGE_BUCKET_NAME = 'YOUR_S3_BUCKET_NAME'
This lines are need for configure the S3BotoStorage. The django-storages library automatically retrieve this
settings, so we can't use the conf_dict.
Deploy root
from staticsites.conf_dict import DeployTypes
STATICSITE_DEPLOY_ROOT = DeployTypes({
'dev': 'deploy/%(deploy_type)s',
'': 'deploy/%(deploy_type)s/%(asctime)s',
'test': '/',
})
In order to deploy on the S3 bucket root, we need to set the the 'test': '/' in the STATICSITE_DEPLOY_ROOT
DeployTypes dictionary. The DeployTypes dictionary are used to tell django-static-sites to use different
configuration for different deploy type.
Default storage
from django.core.files.storage import FileSystemStorage
from storages.backends.s3boto import S3BotoStorage
STATICSITE_DEFAULT_FILE_STORAGE = DeployTypes({
'': FileSystemStorage,
'test': (S3BotoStorage, {'headers': {'Content-Encoding': 'gzip'}}),
})
Now, we tell django-static-sites to use S3BotoStorage for test deploy. Using a tuple instead a Storage class,
allows us to pass the Content-Encoding header to S3BotoStorage constructor.
CloudFront invalidation
AWS_DISTRIBUTION_ID = 'YOUR_CLOUDFRONT_DISTRIBUTION_ID'
from staticsites.utilities import invalidate_paths
STATICSITE_AFTER_DEPLOY = DeployTypes({'': None, 'test': invalidate_paths})
Lastly, if you use CloudFront, you must to set the CloudFront distibution ID
(AWS_DISTRIBUTION_ID = 'YOUR_CLOUDFRONT_DISTRIBUTION_ID') and function invalidate_paths as STATICSITE_AFTER_DEPLOY
callback (STATICSITE_AFTER_DEPLOY = DeployTypes({'': None, 'test': invalidate_paths})).