excelazmin/erpnext-v12

镜像概述

本镜像用于部署ERPNext V12版本及相关扩展应用（含Frappe框架、ERPNext核心应用和Excel-ERPNext扩展），帮助开发者快速搭建企业资源规划（ERP）系统的开发与测试环境，通过VSCode远程容器工具简化环境配置流程。

核心功能

1. 提供ERPNext V12完整部署能力，覆盖财务、库存、销售等企业管理核心模块
2. 集成Excel-ERPNext扩展，增强ERP系统与Excel的交互能力
3. 支持VSCode远程容器构建标准化开发环境
4. 包含MariaDB、Redis等依赖服务的配置指引

使用场景

1. 企业ERP系统的开发与测试环境搭建
2. 小型企业ERP解决方案快速部署
3. ERPNext二次开发的基础环境配置

配置说明

步骤1：克隆仓库

bash
cd Desktop
git clone https://github.com/excel-azmin/Frappe-Docker.git
cd frappe_docker

步骤2：配置DevContainer

复制示例配置文件：

bash
cp -R devcontainer-example .devcontainer
cp -R development/vscode-example development/.vscode

步骤3：安装VSCode扩展

安装「Remote - Containers」扩展：https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers

步骤4：启动远程容器

1. 在VSCode中打开frappe_docker文件夹
2. 执行命令（Ctrl+Shift+P）：Remote-Containers: Reopen in Container（或点击左下角远程容器菜单）

步骤5：设置虚拟环境

bash
pip3.7 install virtualenv
python3.7 -m virtualenv MyEnv
source MyEnv/bin/activate

步骤6：初始化Bench

bash
bench init --skip-redis-config-generation --frappe-branch version-12 --python python3.7 frappe-bench
cd frappe-bench

步骤7：配置服务地址

设置数据库和Redis连接：

bash
bench set-config -g db_host mariadb
bench set-config -g redis_cache redis://redis-cache:6379
bench set-config -g redis_queue redis://redis-queue:6379
bench set-config -g redis_socketio redis://redis-socketio:6379

若命令失败，手动修改common_site_config.json：

json
{
  "db_host": "mariadb",
  "redis_cache": "redis://redis-cache:6379",
  "redis_queue": "redis://redis-queue:6379",
  "redis_socketio": "redis://redis-socketio:6379"
}

步骤8：创建站点

bash
bench new-site excel_erpnext.localhost --mariadb-root-password 123 --admin-password admin --no-mariadb-socket

步骤9：启用开发者模式

bash
bench --site excel_erpnext.localhost set-config developer_mode 1
bench --site excel_erpnext.localhost clear-cache

步骤10：安装应用

安装ERPNext核心应用：

bash
bench get-app --branch version-12 erpnext https://github.com/frappe/erpnext.git
bench --site excel_erpnext.localhost install-app erpnext

安装Excel-ERPNext扩展：

bash
bench get-app --branch version-12 excel_erpnext https://gitlab.com/castlecraft/excel_erpnext.git
bench --site excel_erpnext.localhost install-app excel_erpnext

步骤11：启动服务

bash
bench start

访问站点

浏览器打开：http://excel_erpnext.localhost:8000/