Let’s look at how to bootstrap a Django Project pre-loaded with the basic requirements needed in order to quickly get a project up and running. Further, beyond the project structure, most bootstrapped projects also take care of setting up the development and production environment settings, without troubling the user much - so we’ll look at that as well.
- 10/04/2016: Updated to the latest versions of cookiecutter (v1.4.0), cookiecutter-django, Django (v1.10.1), Docker (v1.12.1), Docker Compose (v1.8.1), and Docker Machine (v0.8.2).
Start by installing cookiecutter globally:
$ pip install cookiecutter==1.4.0
Now execute the following command to generate a bootstrapped django project:
$ cookiecutter https://github.com/pydanny/cookiecutter-django.git
This command runs cookiecutter with the cookiecutter-django repo, allowing us to enter project-specific details:
Cloning into 'cookiecutter-django'... remote: Counting objects: 8078, done. remote: Compressing objects: 100% (60/60), done. remote: Total 8078 (delta 27), reused 0 (delta 0), pack-reused 8018 Receiving objects: 100% (8078/8078), 2.88 MiB | 1.33 MiB/s, done. Resolving deltas: 100% (5214/5214), done. Checking connectivity... done. project_name [Project Name]: django_cookiecutter_docker project_slug [django_cookiecutter_docker]: django_cookiecutter_docker author_name [Daniel Roy Greenfeld]: Michael Herman email [firstname.lastname@example.org]: email@example.com description [A short description of the project.]: Tutorial on bootstrapping django projects domain_name [example.com]: example.com version [0.1.0]: 0.1.0 timezone [UTC]: UTC use_whitenoise [y]: y use_celery [n]: n use_mailhog [n]: n use_sentry_for_error_reporting [y]: y use_opbeat [n]: n use_pycharm [n]: n windows [n]: n use_python3 [y]: y use_docker [y]: y use_heroku [n]: n use_elasticbeanstalk_experimental [n]: n use_compressor [n]: n Select postgresql_version: 1 - 9.5 2 - 9.4 3 - 9.3 4 - 9.2 Choose from 1, 2, 3, 4 : 1 Select js_task_runner: 1 - Gulp 2 - Grunt 3 - None Choose from 1, 2, 3 : 1 use_lets_encrypt [n]: n Select open_source_license: 1 - MIT 2 - BSD 3 - GPLv3 4 - Apache Software License 2.0 5 - Not open source Choose from 1, 2, 3, 4, 5 : 1
Take a quick look at the generated project structure, taking specific note of the following directories:
- “config” includes all the settings for our local and production environments.
- “requirements” contains all the requirement files - base.txt, local.txt, production.txt, test.txt - which you can make changes to and then install via
pip install -r file_name.
- “django_cookiecutter_docker” is the main project directory which consists of the “static”, “contrib” and “templates” directories along with the
usersapp containing the models and boilerplate code associated with user authentication.
Some of the services may require environment variables. Rename the sample file env.example to .env and add the required variables.
Follow the instructions to install the Docker Engine and the required Docker components - Engine, Machine, and Compose.
Check the versions:
$ docker --version Docker version 1.12.1, build 6f9534c $ docker-compose --version docker-compose version 1.8.0, build f3628c7 $ docker-machine --version docker-machine version 0.8.1, build 41b3b25
Once installed, create a new Docker host within the root of the newly created Django Project:
$ docker-machine create --driver virtualbox dev $ eval $(docker-machine env dev)
devcan be named anything you want. For example, if you have more than one development environment, you could name them
djangodev2, and so forth.
To view all Machines, run:
$ docker-machine ls
You can also view the IP of the
dev Machine by running:
$ docker-machine ip dev
Finally, let’s create a “/data” partition within the VM itself so that changes are persistent:
$ docker-machine ssh dev $ sudo su $ echo 'ln -sfn /mnt/sda1/data /data' >> /var/lib/boot2docker/bootlocal.sh
Now we can fire everything up - e.g., Django and Postgres - via Docker Compose:
$ docker-compose -f dev.yml build $ docker-compose -f dev.yml up -d
Running Windows? Hit this error -
Interactive mode is not yet supported on Windows? See this comment.
The first build will take a while. Due to caching, subsequent builds will run much faster.
Now we can test our Django Project by applying the migrations and then running the server:
$ docker-compose -f dev.yml run django python manage.py makemigrations $ docker-compose -f dev.yml run django python manage.py migrate $ docker-compose -f dev.yml run django python manage.py createsuperuser
Navigate to the
dev IP (port 8000) in your browser to view the Project quick start page with debugging mode on and many more development environment oriented features installed and running.
Stop the containers (
docker-compose stop), initialize a new git repo, commit, and PUSH to GitHub.
So, we have successfully set up our Django Project locally using cookiecutter-django and served it up using the traditional manage.py command line utility via Docker.
In this section, we move on to the deployment part, where the role of a web server comes into play. We will be setting up a Docker Machine on a Digital Ocean droplet, with Postgres as our database and Nginx as our web server.
Along with this, we will be making use of gunicorn instead of Django’s single-threaded development server to run the server process.
Apart from being a high-performance HTTP server, which almost every good web server out in the market is, Nginx has some really good features that make it stand out from the rest - namely that it:
- Can couple as a reverse proxy server.
- Can host more than one site.
- Has an asynchronous way of handling web requests, which means that since it doesn’t rely on threads to handle web requests, it has a higher performance while handling multiple requests.
Gunicorn is a Python WSGI HTTP server that can be easily customized and provides better performance in terms of reliability than Django’s single-threaded development server within production environments.
Digital Ocean Setup
$ docker-machine create \ -d digitalocean \ --digitalocean-access-token=ADD_YOUR_TOKEN_HERE \ prod
This should only take few minutes to provision the Digital Ocean droplet and set up a new Docker Machine called
prod. While you wait, navigate to the Digital Ocean Control Panel; you should see a new droplet being created, again, called
Once done, there should now be two machines running, one locally (
dev) and one on Digital Ocean (
docker-machine ls to confirm:
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS dev * virtualbox Running tcp://192.168.99.100:2376 v1.12.1 prod - digitalocean Running tcp://126.96.36.199:2376 v1.12.1
prod as the active machine and then load the Docker environment into the shell:
$ eval $(docker-machine env prod)
Docker Compose (take 2)
Within .env update the
DJANGO_ALLOWED_HOSTS variable to match the Digital Ocean IP address - i.e.,
Now we can create the build and then fire up the services in the cloud:
$ docker-compose build $ docker-compose up -d
Sanity Check (take 2)
Apply all the migrations:
$ docker-compose run django python manage.py makemigrations $ docker-compose run django python manage.py migrate
Now just visit your server’s IP address, associated with the Digital Ocean droplet, and view it in the browser.
You should be good to go.
For further reference just grab the code from the repository. Thanks a lot for reading! Looking forward to your questions.