### 使用 Docker 将 Python Django 后端项目容器化的最佳实践 #### 1. 准备工作 在开始之前，确保已安装必要的工具和软件版本。推荐使用的版本如下： - **Python**: 3.8.x 或更高版本[^2] - **Django**: 3.2.x 或更高版本 - **Docker**: 20.10.x 或更高版本 #### 2. 创建 `requirements.txt` 文件 为了使项目的依赖项清晰明了，在根目录下创建一个 `requirements.txt` 文件，列出所有必需的库及其版本号。 ```plaintext Django==3.2.3 mysqlclient==2.1.0 ``` 此文件将在后续的 Dockerfile 中被用来安装依赖项。 #### 3. 编写 Dockerfile 以下是适用于 Django 后端项目的典型 `Dockerfile`： ```dockerfile # 使用官方的基础镜像 FROM python:3.8-slim-buster # 设置工作目录 WORKDIR /app # 复制需求文件到容器中 COPY requirements.txt . # 安装依赖 RUN pip install --no-cache-dir -r requirements.txt # 复制应用程序代码到容器中 COPY . . # 运行迁移命令 RUN python manage.py migrate # 暴露端口 EXPOSE 8000 # 启动 Django 开发服务器（生产环境中应替换为 uWSGI 或 Gunicorn） CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"] ``` 上述配置说明： - 基于官方的 Python 镜像构建环境。 - 利用多阶段构建减少最终镜像大小。 - 自动执行数据库迁移脚本[^1]。 #### 4. 构建 Docker 镜像 在终端中运行以下命令来构建 Docker 镜像： ```bash docker build -t my_django_app . ``` 这会根据当前目录下的 `Dockerfile` 构建名为 `my_django_app` 的镜像。 #### 5. 测试本地容器 启动容器以验证一切正常运作： ```bash docker run -p 8000:8000 my_django_app ``` 访问浏览器中的 `http://localhost:8000` 来确认应用是否成功运行。 #### 6. 数据持久化与环境变量管理 对于生产环境，建议使用外部卷存储数据，并通过 `.env` 文件传递敏感信息。可以借助 `docker-compose.yml` 实现更复杂的编排。 示例 `docker-compose.yml` 文件： ```yaml version: '3' services: web: build: . ports: - "8000:8000" volumes: - ./src:/app/src environment: - DATABASE_URL=mysql://user:password@db:3306/dbname db: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: password MYSQL_DATABASE: dbname ``` 该设置允许 Web 和 DB 服务协同工作。 --- ### 总结 以上方法展示了如何利用 Docker 技术高效地将 Django 应用程序容器化并打包成可移植的镜像。遵循这些步骤能够显著简化开发、测试及部署过程。