cookiecutter-django-docker

A Cookiecutter template for a Django project using Docker. Continuation of evozon/django-docker.

What is included?

• Packages for Django project and an app
• Setup for Celery or RQ, Apache, debug-toolbar etc
• LetsEncrypt setup with Nginx and uWSGI.
• Setup for testing using Pytest.
• Reloader (container that restarts other containers when files change, for development).
• Ansible deployment playbooks (that install Docker on the target machines and run your project with Compose).

Generating the project

Install cookiecutter and run:

cookiecutter gh:ionelmc/cookiecutter-django-docker

You will be asked for these fields:

Template variable	Default	Description
name	"Nameless"	Project name, used in headings (readme, etc).
repo_name	"python-nameless"	The project's root directory name.
django_project_name	"nameless_project"	Django project name (a package that contains settings and root urls).
compose_project_name	"nmls"	Docker Compose project name (used for the COMPOSE_PROJECT_NAME setting). A short name is suggested to avoid typing a lot when using Docker directly (eg: docker exec nmls_web_1 ...)
django_app_name	"nameless"	Django app name.
short_description	"An example package [...]"	One line description of the project (used in README.rst).

Regenerating the project

If you made some wrong choices during generation you can regenerate it. There are two options:

• Force Cookiecutter to override the files:

  cookiecutter --overwrite-if-exists --config-file=directory-of-project/.cookiecutterrc gh:ionelmc/cookiecutter-django-docker

• After installing cookiepatcher run:

  cookiepatcher gh:ionelmc/cookiecutter-django-docker directory-of-project

Using the project

To build the project:

docker compose build --pull

This template previously had a base image but it's just too much of a hassle and layer caching work well enough to have individual images.

To start the project run:

docker compose up

The project will provide a small shim for running tests, try:

./test.sh --help

Working with the project is the usual docker compose up and such, nothing special or unexpected.