django-base 镜像文档

镜像概述

该镜像为Django应用提供基础运行环境，旨在简化Django项目的Docker化配置流程。作为基础镜像，它预配置了Django开发和运行的核心依赖，减少项目Dockerfile的构建命令复杂度。

核心功能与特性

• 内置依赖管理工具：包含pipenv，支持Python项目的依赖声明、安装与管理。
• mysqlclient支持：预装使用mysqlclient所需的必要系统包，解决Django连接MySQL数据库时的依赖问题。
• ONBUILD指令优化：通过内置ONBUILD指令自动执行基础构建步骤，使产品Dockerfile几乎无需添加额外构建命令。

使用场景

• 适用于需要快速Docker化的Django项目，尤其是使用MySQL作为数据库的Django应用。
• 适合作为开发环境和生产环境的基础镜像，统一项目的运行环境配置。

使用方法与配置说明

基本使用步骤

1. 创建项目Dockerfile：在Django项目根目录下创建Dockerfile，仅需声明基于该镜像即可，无需编写大量基础构建命令。

   dockerfile
   From pennlabs/django-base
   

2. 构建镜像：执行常规Docker构建命令，ONBUILD指令将自动处理基础依赖安装等步骤。

关键配置说明

• 基础镜像引用：直接通过FROM pennlabs/django-base继承所有预配置环境，无需手动安装pipenv或mysqlclient依赖。
• 依赖管理：项目可通过pipenv的Pipfile和Pipfile.lock管理Python依赖，镜像会自动识别并处理。

注意事项

• 确保项目中已正确配置Django数据库连接（若使用MySQL），镜像已解决mysqlclient的系统依赖问题。
• 如需自定义构建步骤，可在项目Dockerfile中添加额外指令，ONBUILD指令不会覆盖用户自定义命令。