Added Docker support

Author: clintonb

.gitignore

@@ -3,5 +3,4 @@
 *.pyc
 .idea/
 
-{{ cookiecutter.project_slug }}/Pipfile.lock
 todo_project_name/

.travis.yml

@@ -1,10 +1,13 @@
+sudo: required
+
+services:
+  - docker
+
 language: python
 
 python:
     - 3.6
 
-sudo: false
-
 cache: pip
 
 env:
@@ -16,3 +19,5 @@ install:
 
 script:
     - make test
+    - make test-static
+    - make down

Makefile

@@ -1,23 +1,26 @@
 .DEFAULT_GOAL := test
 
-.PHONY: requirements test
+.PHONY: down requirements test test-static
 
-requirements:
+requirements:	## Install the requirements needed to run Cookiecutter
 	pip install -r requirements.txt
-	# TODO Restore once https://github.com/pypa/pipenv/issues/3224 is released
-	# pip install pipenv
-	pip install git+https://github.com/pypa/pipenv
 
-test:
+test:	## Ensure we can build and run a new project
 	# Remove any existing data
 	rm -rf todo_project_name
 
 	# Create a new project with the default values
 	cookiecutter . --no-input
 
 	# Execute the project's Make targets
-	cd todo_project_name && make production-requirements requirements
-	cd todo_project_name && SECRET_KEY=fake DATABASE_URL="sqlite://:memory:" pipenv run make detect_missing_migrations
-	cd todo_project_name && SECRET_KEY=fake DATABASE_URL="sqlite://:memory:" pipenv run make migrate
-	cd todo_project_name && pipenv run make validate
-	cd todo_project_name && pipenv run make static
+	cd todo_project_name && make docker.build
+	cd todo_project_name && make local.up
+	cd todo_project_name && docker exec -it todo_project_name.app make detect_missing_migrations
+	cd todo_project_name && docker exec -it todo_project_name.app make migrate
+	cd todo_project_name && docker exec -it todo_project_name.app make validate
+
+test-static:	## Confirm nginx is serving static files
+	curl -o /dev/null --fail --silent http://localhost:8080/static/admin/css/login.css
+
+down:	## Shutdown the containers
+	cd todo_project_name && make local.down

README.rst

@@ -13,6 +13,7 @@ Features
 * Support for Python 3.6+
 * `12-Factor <https://12factor.net/>`_ based settings via `django-environ <https://django-environ.readthedocs.io/en/latest/>`_
 * Custom user model
+* Docker support
 
 
 Usage

{{ cookiecutter.project_slug }}/Dockerfile

@@ -0,0 +1,43 @@
+FROM python:3.6-alpine
+
+WORKDIR /app/{{ cookiecutter.project_slug }}
+
+ENV DJANGO_SETTINGS_MODULE {{ cookiecutter.project_slug }}.settings
+ENV PIPENV_DONT_USE_PYENV 1
+
+RUN apk add --update \
+    coreutils \
+    gcc \
+    libffi-dev \
+    make \
+    musl-dev \
+    postgresql-dev \
+    python3-dev \
+  && pip install pipenv \
+  && rm -rf /var/cache/apk/*
+
+COPY Makefile /app/{{ cookiecutter.project_slug }}
+COPY Pipfile /app/{{ cookiecutter.project_slug }}
+COPY Pipfile.lock /app/{{ cookiecutter.project_slug }}
+
+# TODO Switch to environment variable when https://github.com/pypa/pipenv/issues/3278 is resolved.
+RUN pipenv install --dev --system
+
+COPY . /app/{{ cookiecutter.project_slug }}
+
+RUN mkdir -p /logs \
+    && touch /logs/app.log
+
+ENV PUBLIC_ROOT /public
+RUN make static
+
+EXPOSE 8000
+
+VOLUME /public/media
+VOLUME /public/static
+
+
+ENV LOG_FILE_PATH /logs
+ENV ENABLE_LOGGING_TO_FILE true
+ENV GUNICORN_CMD_ARGS "--workers=2 --worker-class=gevent --bind=0.0.0.0:8000"
+CMD ["gunicorn", "{{ cookiecutter.project_slug }}.wsgi"]

{{ cookiecutter.project_slug }}/Makefile

@@ -7,6 +7,23 @@ help: ## Display this help message
 	@echo "Please use \`make <target>\` where <target> is one of"
 	@perl -nle'print $& if m{^[\.a-zA-Z_-]+:.*?## .*$$}' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m  %-25s\033[0m %s\n", $$1, $$2}'
 
+docker.build: ## Build the Docker containers
+	docker-compose build
+
+docker.pull: ## Pull the Docker containers
+	docker-compose pull
+
+%.down: ## Stop the (local|production) Docker containers
+	docker-compose -f docker-compose.yml -f docker-compose.$*.yml down
+
+%.restart: ## Restart the (local|production) Docker containers
+	docker-compose -f docker-compose.yml -f docker-compose.$*.yml restart
+
+%.shell: ## Open a shell into the (local|production) app Docker container
+	docker-compose -f docker-compose.yml -f docker-compose.$*.yml exec app /bin/ash
+
+%.up: ## Start the (local|production) Docker containers
+	docker-compose -f docker-compose.yml -f docker-compose.$*.yml up -d
 
 clean: ## Delete generated byte code and coverage reports
 	find . -name '*.pyc' -delete