frappe/base Docker Image

Frappe框架基础依赖镜像

镜像概述

该镜像专为Frappe框架应用设计，提供运行所需的基础依赖环境。Frappe框架是一款开源低代码开发框架，广泛用于构建企业级业务应用（如ERPNext）。本镜像预先集成运行Frappe应用必需的系统依赖、编程语言环境及工具链，旨在简化应用部署流程并确保环境一致性。

核心功能与特性

• 基础依赖预打包：包含Python（匹配Frappe支持版本）、Node.js（前端资源构建）、数据库客户端（MySQL/MariaDB）、系统库（libmysqlclient、libssl等）及构建工具（gcc、make）等核心依赖。
• 环境标准化：统一依赖版本，避免因环境差异导致的"在我电脑上能运行"问题，确保开发、测试、生产环境行为一致。
• 部署效率优化：预安装依赖减少应用部署阶段的依赖安装耗时，缩短应用启动就绪时间。
• 框架兼容性：兼容主流Frappe框架版本，支持基于Frappe开发的各类应用（如ERPNext、自定义业务系统）。

使用场景

• Frappe应用开发：作为本地开发环境基础，快速搭建开发环境，专注应用逻辑开发而非依赖配置。
• CI/CD测试流程：在持续集成/部署中作为测试环境基础镜像，确保测试环境依赖与生产一致。
• 生产环境运行：作为生产环境运行Frappe应用的基础镜像，配合应用代码与配置实现业务系统部署。

使用方法与配置说明

拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/frappe-base:latest  # 替换为实际镜像仓库地址

运行容器示例（基础用法）

bash
docker run -d \
  --name frappe-app-instance \
  -v /本地/frappe应用代码目录:/app \  # 挂载Frappe应用代码
  -p 8000:8000 \  # 映射应用端口（根据Frappe配置调整）
  -e FRAPPE_ENV=production \  # 指定运行环境
  [镜像仓库地址]/frappe-base:latest

作为基础镜像构建应用镜像（Dockerfile示例）

dockerfile
# 自定义Frappe应用Dockerfile
FROM docker.xuanyuan.run/[镜像仓库地址]/frappe-base:latest

# 复制应用代码
COPY ./my-frappe-app /app

# 安装应用特定依赖
RUN cd /app && \
    pip install -r requirements.txt && \
    npm install && \
    bench build  # 构建前端资源

# 启动命令
CMD ["bench", "start"]

关键配置说明

• 数据持久化：建议挂载/app（应用代码）、/home/frappe/.bench（bench配置）等目录以确保数据持久化。
• 环境变量：通过FRAPPE_ENV（环境标识）、DB_HOST（数据库地址）、REDIS_HOST（缓存服务地址）等变量配置外部依赖连接信息。
• 端口映射：根据Frappe应用配置映射端口（默认Web端口8000，WebSocket端口9000）。

注意事项

• 本镜像不含数据库或缓存服务，生产环境需配合MySQL/MariaDB、Redis等容器或外部服务使用。
• 运行前需确保应用代码已完成bench init、数据库迁移等初始化操作。