I had to get Docker Compose working for a Django project, primarily to make it easier for other developers to get a working development environment.
\nSome features of this project:
\nDockerfile used for the production deployment, but needed a separate one for the development environmentI ended up with this docker-compose.yml file in the root of the project:
version: \"3.1\"\n\nvolumes:\n postgresql-data:\nservices:\n database:\n image: postgis/postgis:13-3.1\n restart: always\n expose:\n - \"5432\"\n ports:\n - \"5432:5432\"\n volumes:\n - postgresql-data:/var/lib/postgresql/data\n environment:\n POSTGRES_USER: postgres\n POSTGRES_DB: mydb\n POSTGRES_PASSWORD: postgres\n web:\n container_name: myapp\n platform: linux/amd64\n build:\n context: .\n dockerfile: Dockerfile.dev\n command: python manage.py runserver 0.0.0.0:3000\n environment:\n DATABASE_URL: postgres://postgres:postgres@database:5432/mydb\n DEBUG: 1\n volumes:\n - .:/app\n ports:\n - \"3000:3000\"\n depends_on:\n - migrations\n - database\n migrations:\n platform: linux/amd64\n build:\n context: .\n dockerfile: Dockerfile.dev\n command: python manage.py migrate --noinput\n environment:\n DATABASE_URL: postgres://postgres:postgres@database:5432/mydb\n volumes:\n - .:/app\n depends_on:\n - databaseThe db container runs PostGIS. It uses a named volume to persist PostgreSQL data in between container restarts.
The web container runs the Django development server, built using the custom Dockerfile.dev Dockerfile.
The migrations container simply runs the apps migrations and then terminates - with depends_on used to ensure that migrations run after the hdatabase server starts and before the web server.
Both web and migrations include a platform: linux/amd64 property - this ensures they will work on M1 Macs even if the Python dependencies are not yet easily compiled for that architecture, see Running Docker on an M1 Mac.
The container_name: myapp field on the web container is a convenience which means you can later run commands like this:
docker exec -it myapp ./manage.py collectstatic\nHere's Dockerfile.dev:
FROM python:3.9-slim\n\nENV APP_HOME /app\nWORKDIR $APP_HOME\n\nENV PYTHONUNBUFFERED 1\n\n# gdal for GeoDjango\nRUN apt-get update && apt-get install -y \\\n binutils \\\n gdal-bin \\\n libproj-dev \\\n git \\\n && rm -rf /var/lib/apt/lists/*\n\nCOPY requirements.txt .\nRUN pip install --no-cache-dir -r requirements.txt\n\nWORKDIR $APP_HOME/myapp\n\nRUN ./manage.py collectstatic --no-input\n\nCMD python manage.py runserver 0.0.0.0:3000