Continuous Delivery for Django on DigitalOcean with GitHub Actions & Docker

TL;DR: In this guide, you’ll learn how to build a production-grade Continuous Delivery (CD) pipeline for your Django app using GitHub Actions, Docker, and a DigitalOcean Ubuntu VM. We’ll automate everything from testing to deployment—so your app updates with every push to main.

💡 What is Continuous Delivery?

Continuous Delivery is a software practice where code is always in a deployable state. It allows teams to:

  • ✅ Ship faster
  • 🔄 Automate deployments
  • 🔐 Reduce human error
  • 🚀 Release confidently

We’ll implement a pipeline that looks like this:

Related Posts

🔄 CD Pipeline Workflow

graph TD
  A[Push code to GitHub] --> B[GitHub Actions CI/CD triggered]
  B --> C[Checkout code]
  C --> D[SSH to DigitalOcean VM]
  D --> E[Pull latest code from Git]
  E --> F[Rebuild Docker containers]
  F --> G[Restart Django app via Docker Compose]
  G --> H[Live site is updated automatically]

🔍 Step-by-Step Summary

Step Description
A Developer pushes code to main
B GitHub Actions starts the CI/CD workflow
C Code is checked out in the GitHub runner
D GitHub connects to your DigitalOcean VM via SSH
E Latest code is pulled into your server
F Docker containers are rebuilt
G Docker Compose restarts the app
H Nginx serves the latest version to users

🛠️ Tools We’ll Use

Role Tool
CI/CD GitHub Actions
Deployment DigitalOcean (Ubuntu VM)
Containerization Docker + Docker Compose
Web Server Nginx
Secure Access SSH with GitHub Secrets

📦 Step 1: Dockerize Your Django App

Dockerfile

FROM python:3.11-slim

ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1

WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .
CMD ["gunicorn", "myproject.wsgi:application", "--bind", "0.0.0.0:8000"]

🐳 Step 2: Docker Compose for Production

docker-compose.prod.yml

version: '3.9'
services:
  web:
    build: .
    env_file: .env
    volumes:
      - .:/app
    expose:
      - 8000

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - web

🌐 Step 3: Nginx Configuration

nginx.conf

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://web:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

🔐 Step 4: SSH Setup for GitHub

  1. On your local machine:
ssh-keygen -t ed25519 -C "your_email@example.com"
  1. Copy the public key to your server’s ~/.ssh/authorized_keys
  2. Add the private key to your GitHub repo secrets:
    → DO_SSH_PRIVATE_KEY

🤖 Step 5: GitHub Actions Workflow

.github/workflows/deploy.yml

name: Django CD to DigitalOcean

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v3

    - name: Setup SSH
      run: |
        mkdir -p ~/.ssh
        echo "${{ secrets.DO_SSH_PRIVATE_KEY }}" > ~/.ssh/id_ed25519
        chmod 600 ~/.ssh/id_ed25519
        ssh-keyscan your.server.ip >> ~/.ssh/known_hosts

    - name: Deploy via SSH
      run: |
        ssh -i ~/.ssh/id_ed25519 deploy@your.server.ip << 'EOF'
          cd /home/deploy/myproject/
          git pull origin main
          docker compose -f docker-compose.prod.yml down
          docker compose -f docker-compose.prod.yml up -d --build
        EOF

Replace:

Related Services

  • your.server.ip with your actual VM IP
  • deploy with your username

🔧 Step 6: Production .env Example

DJANGO_SECRET_KEY=supersecret
DEBUG=False
ALLOWED_HOSTS=yourdomain.com

📁 Folder Structure on the Server

/home/deploy/myproject/
├── manage.py
├── myproject/
├── Dockerfile
├── docker-compose.prod.yml
├── .env
├── nginx.conf

✅ Final Result

Every time you push to main, your app is:

  • Pulled to your server
  • Rebuilt with Docker
  • Restarted with zero manual steps

🌟 Bonus Ideas

  • Add Sentry for error monitoring
  • Auto-restart using systemd
  • Setup Let’s Encrypt for HTTPS

🧠 Conclusion

You’ve now built a real Continuous Delivery pipeline for Django on a live Ubuntu VM. It’s reliable, repeatable, and scales with your app.

Get in Touch with us

Email to Us

hello@simplico.net
LINE QR
Chat with Us on LINE

iiitum1984

Speak to Us or Whatsapp

(+66) 83001 0222

Related Posts

Our Products

Simplify Gym Management with SimpliGym
SimpliShop, All-in-One E-Commerce Platform with AI-Driven Features
รับออกแบบและพัฒนา Responsive Website / Web application
สอนพัฒนา website ด้วย Wordpress 5
สอนเขียน Ionic Framework: Cross-Platform Mobile App Development
สอนเขียน Python / Django Web Framework
SimpliLearn ระบบเรียน online ที่มาพร้อมกับ AI
SimpliRun, แอปสำหรับ virtual run และขายของ online
Mobile application สำหรับธุรกิจกีฬาที่ครบวงจร
ระบบแนะนำสินค้าสำหรับขายของ Online
simpliRec , ระบบแนะนำหนังสือที่ชาญฉลาด
Integrated Measurement Communication System ( IMCS )
SimpliFactory ชุดเทคโนโลยีสำหรับโรงงานอุตสาหกรรม , Software/Hardware