frappe/build Docker Image

Frappe框架构建依赖镜像

镜像概述

本镜像为Frappe框架应用提供预配置的构建依赖环境，集成Frappe应用开发、编译及打包所需的系统级依赖、Python库和工具链，旨在解决Frappe应用开发部署中依赖安装复杂、环境不一致的问题，简化配置流程并提高开发部署效率。

核心功能与特性

• 预集成构建依赖：包含Frappe框架构建必需的系统包（如gcc、libmysqlclient-dev、python3-dev等）、Python依赖（如setuptools、wheel、pip等）及构建工具，满足编译、打包需求。
• 环境一致性保障：统一依赖版本和配置，避免因开发环境差异导致的构建错误，确保跨环境构建结果一致。
• 简化开发流程：无需手动安装和配置依赖，直接基于镜像启动容器即可开展Frappe应用构建工作。
• 版本兼容性：适配主流Frappe版本，支持ERPNext等Frappe衍生应用的构建依赖需求。

使用场景与适用范围

• 开发环境快速搭建：供开发人员快速获取具备完整构建依赖的环境，减少环境配置时间，专注于代码开发。
• CI/CD构建环节：作为持续集成/部署流程中的基础镜像，用于自动化构建阶段，确保构建过程稳定可靠。
• 生产前置依赖准备：在生产部署前，利用本镜像预构建应用依赖，降低生产环境构建资源消耗和时间成本。

使用方法与配置说明

基础使用

通过以下命令启动容器，进入包含Frappe构建依赖的环境：

bash
docker run -it --rm docker.xuanyuan.run/frappe/build-deps:latest /bin/bash

集成到应用构建流程

在Dockerfile中使用本镜像作为构建阶段基础，示例如下：

dockerfile
# 构建阶段：使用构建依赖镜像
FROM docker.xuanyuan.run/frappe/build-deps:latest AS builder

# 复制应用代码
COPY . /app

# 安装应用特定依赖（如requirements.txt中定义的依赖）
RUN pip install --no-cache-dir -r /app/requirements.txt

# 执行Frappe应用构建操作（如编译静态文件）
RUN cd /app && bench build

# 生产阶段：使用轻量级运行时镜像
FROM docker.xuanyuan.run/python:3.10-slim
WORKDIR /app

# 从构建阶段复制构建产物
COPY --from=builder /app /app
COPY --from=builder /usr/local/lib/python3.10/site-packages /usr/local/lib/python3.10/site-packages

# 配置运行时环境
CMD ["gunicorn", "frappe.app:application"]

版本选择

可通过指定标签使用对应Frappe版本的构建依赖，标签通常与Frappe主版本匹配，例如：

bash
# 使用适配Frappe v14的构建依赖镜像
docker run -it --rm docker.xuanyuan.run/frappe/build-deps:v14 /bin/bash

（具体标签需参考镜像仓库实际版本列表）

注意事项

• 本镜像仅包含构建依赖，不含Frappe运行时环境，建议构建完成后将产物复制到专用运行时镜像（如python-slim）中部署。
• 如需添加额外依赖，可在容器启动后通过apt-get或pip手动安装，或在基于本镜像的Dockerfile中通过RUN指令扩展配置。