django-docker-bootstrap

Concept

A cookiecutter template for Django/Nodejs(React)/Nginx/Postgres. The main idea behind this project to create an easily configurable and easy to use django development/production environment for any project.

Installation

• Docker requires a 64-bit OS.
• Install the docker(1.10.2),docker-compose(1.6.2) - https://docs.docker.com/engine/installation/
• Requirements for cookiecutter: apt-get install python-dev
• Then get cookiecutter: pip install Markdown cookiecutter
• Finally enter the directory where you want to store your project and enter the following: * cookiecutter https://github.com/legios89/django-docker-bootstrap.git

Cookiecutter params

• project_name: The name of the project.
• repo_name: The directory name(automtically generated from the project_name).
• db_password: The postgres user password for the database.
• use_translation: Translation integration(Rosetta, ModelTransalation, admin integration).
• use_react: React, NodeJS, React-Router to replace the django frontend.
• admin_name: The name of the admin user who will receive the error messages.
• admin_email: The email address of the admin user who will receive the error messages.
• email_host_user: The gmail email address what the system can use to send emails.
• email_host_password: The gmail email address password what the system can use to send emails.

Usage

• Build the images: bash buildall.sh
• Start the project: docker-compose up
• You can set every secret variable in the env.txt in the root
• If you want to run the project in production mode you need to set the following environment variable:
  • COMPOSE_FILE="production-docker-compose.yml"
  • https://docs.docker.com/compose/reference/overview/#compose-file

Tips & Tricks

• Every image has a container_shared directory linked as a volume, so if you want to put something inside the container, or you want to get something from inside the containers like a backup file you just need to copy everything to this directory.
• Create a bash alias for for the docker-compose by edit the .bash_aliases file alias dc='docker-compose'
• Enter the container as root: dc run --rm proxy shell root
• You can use vim in every container.
• https://www.digitalocean.com/community/tutorials/how-to-add-swap-on-ubuntu-14-04
• better prompt: https://github.com/vertisfinance/gitprompt

Images

1. base

• Contains every data(db, files, logs) and connected to every other container as a volume (/data/).
• If you delete the base container you will lose everything (be cautious)

2. postgres

• postgresql-9.4
• The 5433 port is open by default if you want to connect the db with a client
• Commands:
  • shell - start a bash shell dc run --rm postgres shell
  • backup - create a backup (/data/backup/<backup_name>) dc run --rm postgres backup
  • restore - restore from a backup (/data/backup/<backup_name>) dc run --rm postgres restore

3. django-python3

• The projects can be found under the /src/ directory
• Installed Apps:
  • Django: 1.9.4
  • uWSGI: 2.0.12
  • psycopg2: 2.6.1
  • django-debug-toolbar: 1.4
  • djangorestframework: 3.3.3 + optional packages
  • django-cleanup: 0.4.2
  • django-extensions: 1.6.1
  • django-compressor: 2.0
  • django-rosetta: 0.7.10 [optional]
  • django-modeltranslation: 0.11rc2 [optional]
• Commands:
  • shell -start a bash shell dc run --rm django shell

4. nginx

• Commands:
  • shell -start a bash shell dc run --rm nginx shell
• Installed Apps:
  • Nginx: 1.8.1

5. nodejs [optional]

• Commands:
  • shell -start a bash shell dc run --rm nodejs shell
  • start_build -start the react build process than exit dc run --rm nodejs start_build
  • Installed Apps:
    • nodejs: 4.x.x
    • npm: 2.x.x
  • Installed Packages: [automatically installed]
    • react: 0.14.7,
    • react-dom: 0.14.7,
    • babelify: 7.2.0,
    • babel-preset-react: 6.5.0,
    • browserify: 13.0.0,
    • watchify: 3.7.0,
    • react-router: 2.0.1