当前位置：首页 > article >正文

使用Docker容器化部署Django项目：从零开始的最佳实践指南

article 2025/1/24 22:35:51

在云计算和微服务架构大行其道的今天，容器化技术已经成为提升应用部署效率和可靠性的重要手段。Docker作为容器技术的领头羊，以其轻量级、快速启动和易于移植的特性，深受开发者喜爱。本文将带你从零开始，一步步了解如何使用Docker部署一个完整的Django项目，包括前端Vue.js、后端Django、Web服务器Nginx、应用服务器uWSGI以及数据库MySQL。

基础知识回顾

Docker的基本概念

Docker镜像：包含应用及其依赖环境的只读模板。
Docker容器：镜像的运行实例，提供应用运行环境。
Docker仓库：用于存放和管理Docker镜像。

Docker的工作流程

构建Docker镜像：通过Dockerfile定义应用的依赖和环境。
运行Docker容器：基于镜像启动容器实例。
管理Docker容器：对容器进行启动、停止、删除等操作。

需求分析

我们需要部署一个多容器的Django项目，包括以下组件：

前端：Vue.js
后端：Django
Web服务器：Nginx
应用服务器：uWSGI
数据库：MySQL

设计方案

构建Docker镜像

Django镜像：基于Python基础镜像，安装Django及相关依赖。
Vue镜像：基于Node.js基础镜像，构建Vue前端应用。
Nginx镜像：配置Nginx作为反向代理服务器。
uWSGI镜像：与Django镜像集成，提供应用服务。
MySQL镜像：使用官方MySQL镜像，配置数据库。

运行Docker容器

Django容器：运行Django应用。
Vue容器：运行Vue前端应用。
Nginx容器：处理HTTP请求，转发到Django容器。
uWSGI容器：与Django容器集成，处理应用请求。
MySQL容器：提供数据库服务。

实现步骤

拉取基础镜像

docker pull python:3.11
docker pull node:14
docker pull nginx:latest
docker pull mysql:5.7

编写Dockerfile

Django Dockerfile：

FROM python:3.11
WORKDIR /app
COPY requirements.txt /app/
RUN pip install -r requirements.txt
COPY . /app/
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

Vue Dockerfile：

FROM node:14
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install
COPY . ./
CMD ["npm", "run", "serve"]

Nginx配置文件：

server {
    listen 80;
    location / {
        proxy_pass http://django:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

构建镜像

docker build -t django_app -f Dockerfile.django .
docker build -t vue_app -f Dockerfile.vue .

编写docker-compose.yml

version: '3'
services:
  django:
    build:
      context: .
      dockerfile: Dockerfile.django
    ports:
      - "8000:8000"
    depends_on:
      - mysql
    environment:
      - MYSQL_HOST=mysql
      - MYSQL_USER=root
      - MYSQL_PASSWORD=root

  vue:
    build:
      context: .
      dockerfile: Dockerfile.vue
    ports:
      - "8080:8080"

  nginx:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - django
      - vue

  mysql:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=root
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data: