mecodia/python-base

mecodia GmbH Django 项目 Docker 基础镜像

镜像概述和主要用途

本镜像为 mecodia GmbH 内部 Django 项目提供标准化的容器化基础运行环境，旨在简化开发、测试及生产环境的部署流程，确保各环境间的一致性。镜像基于官方 Python 镜像构建，预集成 Django 运行所需的核心依赖、系统工具及最佳实践配置，可直接作为项目镜像的基础层使用。

核心功能和特性

• 标准化运行环境：内置指定版本的 Python（如 Python 3.9/3.10）及 Django 依赖（如 django、djangorestframework 等），避免版本冲突。
• 系统依赖预安装：包含 Django 项目常用系统库（如 libpq-dev 用于 PostgreSQL 连接、zlib1g-dev 用于压缩处理等），减少构建阶段依赖安装步骤。
• 安全与性能优化：默认启用非 root 用户运行应用，强化容器安全性；优化 Python 解释器配置（如 PYTHONDONTWRITEBYTECODE 禁用 .pyc 文件生成）以提升性能。
• 开发友好工具：集成 pip、pip-tools 用于依赖管理，gunicorn/uWSGI 作为 WSGI 服务器，支持生产环境部署。
• 版本控制：通过标签（如 main、3.9-slim）明确标识 Python 版本及镜像迭代，便于版本追溯和项目兼容性管理。

使用场景和适用范围

• 内部开发环境：供开发团队本地开发时快速搭建一致的运行环境，无需手动配置依赖。
• CI/CD 流程：作为自动化测试、构建流水线的基础镜像，确保测试环境与生产环境一致。
• 生产环境部署：直接用于生产环境，配合 Docker Compose 或 Kubernetes 实现容器编排，支持高可用部署。
• 项目模板基础：作为新项目初始化的基础镜像，减少重复配置工作。

使用方法和配置说明

镜像拉取

从 Docker Hub 拉取最新版本镜像：

bash
docker pull mecodia/python-base:main

如需指定版本（如 Python 3.10 slim 版本）：

bash
docker pull mecodia/python-base:3.10-slim

基础使用示例

1. 快速启动容器（开发环境）

bash
docker run -it --rm \
  -v $(pwd):/app \  # 挂载本地项目代码到容器内 /app 目录
  -p 8000:8000 \     # 映射容器 8000 端口到本地（Django 开发服务器默认端口）
  -e DJANGO_SETTINGS_MODULE=myproject.settings.dev \  # 指定 Django 配置文件
  mecodia/python-base:main \
  python manage.py runserver 0.0.0.0:8000  # 启动 Django 开发服务器

2. Docker Compose 配置示例（生产环境）

创建 docker-compose.yml 文件，集成数据库、静态文件服务等依赖：

yaml
version: '3.8'

services:
  django-app:
    image: mecodia/python-base:main
    restart: always
    volumes:
      - ./app:/app  # 项目代码目录
      - static_volume:/app/static  # 静态文件持久化
      - media_volume:/app/media    # 媒体文件持久化
    environment:
      - DJANGO_SETTINGS_MODULE=myproject.settings.prod
      - DATABASE_URL=postgres://user:password@db:5432/mydb
      - SECRET_KEY=${SECRET_KEY}  # 从环境变量注入敏感配置
      - DEBUG=False
    depends_on:
      - db
    ports:
      - "8000:8000"  # 暴露 WSGI 服务端口

  db:
    image: postgres:14
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=mydb

volumes:
  postgres_data:
  static_volume:
  media_volume:

环境变量配置

镜像支持通过环境变量自定义运行参数，常用配置如下：

自定义镜像构建

如需在基础镜像上添加项目特定依赖，可创建 Dockerfile 如下：

dockerfile
# 基于 mecodia 基础镜像构建
FROM mecodia/python-base:main

# 设置工作目录
WORKDIR /app

# 复制项目依赖文件并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制项目代码
COPY . .

# 运行启动脚本（如收集静态文件、数据库迁移）
CMD ["./scripts/start.sh"]

注意事项

• 生产环境中需确保 SECRET_KEY 等敏感配置通过安全方式注入（如 Docker Secrets、Kubernetes Secrets），避免硬编码。
• 镜像版本标签（如 3.10-slim）对应特定 Python 版本，使用前请确认项目兼容的 Python 版本。
• 更多高级配置（如健康检查、资源限制）可参考 Docker 官方文档或 mecodia 内部部署规范。

参考链接

• https://hub.docker.com/r/mecodia/python-base
• mecodia GmbH 内部项目文档（需权限访问）