first version

Author: malcata

Dockerfile

@@ -0,0 +1,32 @@
+# Dev decision to use latest. Could instead lock a python version e.g. :3.6, :2.7
+FROM python:latest
+
+MAINTAINER Malcata https://github.com/malcata
+
+## Install Django
+RUN pip install --no-cache-dir Django psycopg2 mysqlclient
+
+## Install all db options, minimal footprint
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        gcc \
+        gettext \
+        mysql-client libmysqlclient-dev \
+        postgresql-client libpq-dev \
+        sqlite3 \
+    && rm -rf /var/lib/apt/lists/*
+        
+
+### Eventual TEST Environment
+## At build time copy everything directly from the continuous integration
+#RUN mkdir -p /usr/src/app
+#WORKDIR /usr/src/app
+#COPY requirements.txt ./
+#RUN pip install --no-cache-dir -r requirements.txt
+#COPY . .
+
+### DEV ENVIRONMENT
+## At run time mount the code folder
+
+EXPOSE 8000
+CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

Makefile

@@ -0,0 +1,24 @@
+export IMAGE_NAME?=malcata/django
+export CONTAINER_NAME?=django
+export SOURCE_DIR?=~/source/project
+export WORK_DIR?=/usr/src/app
+
+build:
+	docker build -t ${IMAGE_NAME} -f Dockerfile .
+
+run:
+	docker run --name ${CONTAINER_NAME} \
+	--volume ${SOURCE_DIR}:${WORK_DIR} \
+	--workdir ${WORK_DIR} \
+	--publish 8000:8000 \
+	--detach ${IMAGE_NAME} 
+
+rmi:
+	docker rmi -f $(IMAGE_NAME)
+
+clean:
+	-docker rm -v $$(docker ps -a -q -f status=exited)
+	-docker rmi $$(docker images -q -f dangling=true)
+	-docker rmi $(IMAGE_NAME)
+	-docker rmi python
+

README.md

@@ -1,2 +1,46 @@
 # docker-django
 A dockerfile to run django
+
+## Why
+The [official docker image for django](https://hub.docker.com/_/django/) is deprecated since 31 Dec 2016. Even those did not seem development friendly since generated images with a copied version of the project instead of a mounted project.
+
+## How to install
+
+1. Install docker ;-)
+2. Clone repository:
+```shell
+https://github.com/malcata/docker-django.git
+```
+3. Configure required environment variables, eventually on a bash_profile file:
+```shell
+$ export SOURCE_DIR="<project source folder>"
+```
+4. Edit settings.py with your IP:
+````shell
+ALLOWED_HOSTS = ['x.x.x.x']
+```
+
+## Usage
+
+1. Generate the docker image
+```shell
+$ make build
+```
+2. Run the container
+```shell
+$ make run
+```
+3. Use browser to access django http://container-ip:8000
+
+Check the [Makefile](Makefile) for further details.
+
+
+## Contributing
+
+Please follow the Github flow process (branch, commits and pull request)...
+
+
+## License
+
+The code in this repository, unless otherwise noted, is MIT licensed. See the `LICENSE` file in this repository.
+