telling / docker-django

Dockerfile for Django base image

Django base image

hub.docker.com/r/telling/django

Based on the official python images.

Simplifying developing django applications by providing a few shorthands for manage.py:

• runserver host:port
  • Waits for the database to be ready, then runs migrate, collectstatic and lastly runserver.
• nomigrate host:port
  • Waits for the database to be ready, then runs collectstatic followed by runserver.
• makemigrations and loadtestdata
  • Waits for the database to be ready, then runs makemigrations or loadtestdata.

If environment variables DJANGO_SUPERUSER_* are set, runserver and nomigrate will attempt to create the superuser. Likewise, if the DJANGO_DB_* variables are set, it will wait for the database upon starting the container, the image uses dockerize to wait for the database. Other then that it behaves like the official python images, with the environment variable PYTHONUNBUFFERED set, django and a few extra packages installed.

Environment variables

• DJANGO_DB_HOST
• DJANGO_DB_PORT
• DJANGO_SUPERUSER_NAME
• DJANGO_SUPERUSER_MAIL
• DJANGO_SUPERUSER_PASS
• PYTHONUNBUFFERED
• DOCKERIZE_VERSION
• DJANGO_VERSION

Usage

To start a new project and create a new app:

docker run --rm --log-driver none -v $(pwd):/code telling/django:1.9.7-py3 django-admin startproject mysite

docker run --rm --log-driver none -v $(pwd)/mysite:/code telling/django:1.9.7-py3 python manage.py startapp polls

docker-compose

I've recently used this to get a local development environment for the bornhack website.

I created a very simple dockerfile, which copies the requirements files and installs said requirements, Dockerfile:

FROM telling/django:1.9.7-py2

COPY requirements/base.txt base.txt
COPY requirements/development.txt development.txt
RUN pip install -r development.txt

CMD ["runserver", "0.0.0.0:8000"]

Then using the dockerfile in docker-compose.yml:

version: "2"

services:
  postgres:
    image: postgres:9.5
    container_name: bornhack-postgres
    environment:
      - POSTGRES_PASSWORD=bornhack
      - POSTGRES_USER=bornhack
      - POSTGRES_DB=bornhack_dev

  django:
    build: .
    volumes:
      - .:/code
    container_name: bornhack-django
    ports:
      - "8000:8000"
    environment:
      - DJANGO_DB_HOST=postgres
      - DJANGO_DB_PORT=5432
      - DJANGO_SUPERUSER_NAME=bornhack
      - DJANGO_SUPERUSER_PASS=bornhack
      - [email protected]
      - DJANGO_SETTINGS_MODULE=bornhack.settings.development

Change the settings file bornhack/settings/development.py and replace 'HOST': 'localhost', with 'HOST': 'postgres',. Now copy the environment file: cp bornhack/settings/env.dist bornhack/settings/.env

We end with a tree structure like:

.
├── Dockerfile
├── Makefile
├── README.md
├── bornhack
├── camps
├── docker-compose.yml
├── graphics
├── manage.py
├── news
├── profiles
├── requirements
├── shop
├── utils
├── vendor
└── villages

Then we can start hacking on the bornhack website by simply doing:

• docker-compose up -d --build

Go to localhost:8000 and see the bornhack website in all its beauty.