portail/base

Celery-Django基础构建镜像技术文档

概述

本镜像为Celery和Django应用提供基础构建环境，通过预配置关键依赖和优化构建流程，显著减少应用镜像的构建时间，适用于开发和部署场景中的构建阶段。

核心功能与特性

• 预配置环境：内置Python运行时、Celery和Django核心依赖，无需重复安装
• 构建加速：优化依赖缓存机制，减少重复下载和编译步骤
• 兼容性：支持主流Celery和Django版本，兼容常见项目结构
• 轻量级设计：基于精简基础镜像，平衡功能与镜像大小

使用场景

• Django+Celery应用的Docker镜像构建过程
• CI/CD流水线中的自动化构建环节
• 本地开发环境中的依赖管理与构建测试
• 需要频繁构建Django-Celery项目的团队协作场景

使用方法

基本构建流程

在项目Dockerfile中作为基础构建阶段使用：

dockerfile
# 构建阶段使用本镜像
FROM celery-django-build-base AS builder

# 设置工作目录
WORKDIR /app

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

# 复制项目代码
COPY . .

# 执行构建命令（如收集静态文件）
RUN python manage.py collectstatic --noinput

# 生产阶段使用运行时镜像
FROM python:slim
COPY --from=builder /app /app
COPY --from=builder /usr/local/lib/python*/site-packages /usr/local/lib/python*/site-packages
# ... 后续运行时配置

直接运行构建命令

通过挂载项目目录执行构建操作：

bash
docker run --rm -v $(pwd):/app celery-django-build-base \
  sh -c "pip install -r requirements.txt && python manage.py collectstatic --noinput"

Docker Compose集成

在docker-compose.yml中配置构建服务：

yaml
version: '3'
services:
  builder:
    image: celery-django-build-base
    volumes:
      - ./:/app
    command: sh -c "pip install -r requirements.txt && python manage.py collectstatic --noinput"
  # ... 其他服务配置

配置说明

目前本镜像未提供额外环境变量配置，所有构建行为通过项目自身的requirements.txt和构建脚本控制，确保与标准Django-Celery项目结构兼容。