awesome-compose/django-postgres/README.md

Compose sample application

Django application with PostgreSQL support

Project structure:

.
├── docker-compose.yml
├── Dockerfile
├── requirements.txt
├── manage.py
├── django_app
    ├── settings.py
    ├── urls.py
    └── wsgi.py

docker-compose.yml

services:
  web:
    build: .
    ports:
      - 8000:8000
    depends_on:
      - db
  db:
    image: postgres:11
    ports:
      - 5432:5432

volumes:
  postgres_data:

Changes in Django project

To make your Django project work with PostgreSQL, you need to add the following lines to your settings.py file:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'postgres',
        'USER': 'postgres',
        'PASSWORD': 'postgres',
        'HOST': 'db',
        'PORT': 5432
    }
}

Deploy with docker-compose

$ docker-compose up -d
[+] Building 27.5s (10/10) FINISHED
 => [internal] load build definition from Dockerfile  
 => => transferring dockerfile: 340B
 ...
 ...
 [+] Running 4/4
 ⠿ Network django-postgres_default         Created                                                                                                     0.1s
 ⠿ Volume "django-postgres_postgres_data"  Created                                                                                                     0.0s
 ⠿ Container django-postgres-db-1          Started                                                                                                     2.9s
 ⠿ Container django-postgres-web-1         Started

Expected result

Listing containers must showtwo containers running and the port mapping as below:

$ docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS               NAMES
9a3b782b1b5a   django-postgres_web   "python /code/manage…"   12 minutes ago   Up 12 minutes   0.0.0.0:8000->8000/tcp   django-postgres-web-1
de27369602f3   postgres:11           "docker-entrypoint.s…"   12 minutes ago   Up 12 minutes   0.0.0.0:5432->5432/tcp   django-postgres-db-1

After the application starts, navigate to http://localhost:8000 in your web browser.

To stop and remove containers, run:

$ docker-compose down