logicify/django repository overview

⁠Base image for django deployments

This image is useful if you want to create production setup for your django application. Essentially it runs 2 processes:

• gunicorn⁠ which actually hosts your django aplication
• Nginx⁠ which serves static files and proxies the rest of requests to gunicorn

⁠Requirements

1. You should put you django application code into the following folder of the image: /srv/application
2. Static files should be located under /srv/static
3. You need to point your application to put media into /srv/media.
4. It is required to pass env variable APP_MODULE which contains the name of the module to be used as wsgi entry point. E.g. your_app.wsgi

Ensure you updated your django settings accordingly (especially MEDIA_ROOT and STATIC_ROOT).

⁠Examples

Here is an example of the Dockerfile which creates an image from the source code (it might be run on CI server as a part of build process):

FROM logicify/django:1.1

COPY build/code /srv/application
COPY build/static /srv/static

RUN source /srv/virtenv/bin/activate && \
    LANG=en_US.utf8 pip install -r requirements.txt

ENV APP_MODULE "our_app.wsgi"
ENV APP_PROCESS_NAME "our-app-name"

So basically what it does is copying files from the build folder into valid locations, setting up all dependencies an required variables. As result you have ready to deploy image.

⁠Supported Variables

• PROXY_TIMEOUT - timeout in seconds for nginx proxy (default 90)
• STATIC_URL - url path for static files hosting (default /static)
• STATIC_PATH - location on the file system where nginx should find static files (/srv/static)
• MEDIA_PATH - location on the file system where nginx should find media files (/srv/media)