ERPnext：容器化安装部署步骤

楚钊

2023-12-01

ERPnext(一)

前言

    ERPnext是GitHub上开源的最热门的ERP项目之一，它的开源协议是GPL-3.0，因此自由度高，无需担心版权问题。ERPnext项目设计简单且使用PYTHON语言实现，因此部署、修改难度小，号称全球最敏捷的ERP系统。ERPnext简单但功能完整，旨在能使企业使用一个系统就能处理公司日常工作中的所有问题。
    因此，对于不想花大价钱购买一套后期服务费更昂贵的ERP系统的中小企业、初创企业；想拥有一套简单但功能完整，易于新增功能的免费的ERP系统的中小企业、初创企业；想拥有一套安装、部署和运维人力成本低的ERP系统的中小企业、初创企业；ERPnext也许是他们的最好的选择。
    ERPnext是基于低代码平台frappe开发的软件。frappe是ERPnext的基座，ERPnext是frappe框架上运行的一个app。
    本系列文章将包含 1. 介绍ERPnext的安装部署；2. 关键模块的源码走读分析；3. 新增功能、修改功能的方法；4. 汉化实现。旨在通过本系列文章，帮助中小企业、初创企业从0开始构建自主可控的，可稳定应用于生产环境的ERP系统。

安装介绍：

ERPnext是一个印度团队开源的软件，它在github上的安装教程bug非常多，流程也乱七八糟的。按照官方文档，绝大多数人不能成功安装，他们在安装过程中总是会遇到各种各样的问题。ERPnext是我见过最不真诚的开源，单单找安装文档链接你就可能头晕。

github项目代码地址：https://github.com/frappe/erpnext
安装方法有三：

容器化部署：https://github.com/frappe/frappe_docker
easy way install(意思是超级简单的安装): https://github.com/frappe/bench#easy-install-script
手动安装：https://github.com/frappe/bench#manual-installation

吐槽：一个ERPnext项目，三种安装方式，在不同的项目下。完成看不出他们这个写作文档的逻辑。以上链接大家看看就好。

以上3中安装方法我都多次测试过，总有各种各样的问题。最好我选择了使用方法1，也就是容器化部署方法。
使用的安装方法在这里。单服务器部署方法：
https://github.com/frappe/frappe_docker/blob/main/docs/single-server-example.md

本次我使用的环境为：阿里云ecs,系统CentOS Linux release 7.8.2003。

安装步骤：

1. 安装docker容器

curl -fsSL https://get.docker.com | bash
systemctl start docker

2. 安装compose v2

DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
mkdir -p $DOCKER_CONFIG/cli-plugins
curl -SL https://github.com/docker/compose/releases/download/v2.2.3/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose

3. 下载frappe源码，并进入源码目录

git clone https://github.com/frappe/frappe_docker
cd frappe_docker

4. 创建一个目录存储配置文件

mkdir ~/gitops

5. 安装Traefik(一个类似负责均衡的软件)

5.1 创建环境变量配置文件

echo 'TRAEFIK_DOMAIN=traefik.example.com' > ~/gitops/traefik.env
echo 'EMAIL=admin@example.com' >> ~/gitops/traefik.env
echo 'HASHED_PASSWORD='$(openssl passwd -apr1 changeit | sed 's/\$/\\\$/g') >> ~/gitops/traefik.env

5.2 部署Traefik容器

docker compose --project-name traefik \
--env-file ~/gitops/traefik.env \
-f docs/compose/compose.traefik.yaml \
-f docs/compose/compose.traefik-ssl.yaml up -d

6. 安装Mariadb数据库

6.1 创建Mariadb相关的配置文件

echo "DB_PASSWORD=changeit" > ~/gitops/mariadb.env

密码想修改就替换changeit

6.2 部署Mariadb容器

docker compose --project-name mariadb --env-file ~/gitops/mariadb.env -f docs/compose/compose.mariadb-shared.yaml up -d

7. 安装ERPnext

7.1 创建配置文件erpnext-one.env

cp example.env ~/gitops/erpnext-one.env
sed -i 's/DB_PASSWORD=123/DB_PASSWORD=changeit/g' ~/gitops/erpnext-one.env
sed -i 's/DB_HOST=/DB_HOST=mariadb-database/g' ~/gitops/erpnext-one.env
sed -i 's/DB_PORT=/DB_PORT=3306/g' ~/gitops/erpnext-one.env
echo 'ROUTER=erpnext-one' >> ~/gitops/erpnext-one.env
echo "SITES=\`one.example.com\`,\`two.example.com\`" >> ~/gitops/erpnext-one.env
echo "BENCH_NETWORK=erpnext-one" >> ~/gitops/erpnext-one.env

7.2 创建配置文件erpnext-one.yaml

docker compose --project-name erpnext-one \
  --env-file ~/gitops/erpnext-one.env \
  -f compose.yaml \
  -f overrides/compose.erpnext.yaml \
  -f overrides/compose.redis.yaml \
  -f docs/compose/compose.multi-bench.yaml \
  -f docs/compose/compose.multi-bench-ssl.yaml config > ~/gitops/erpnext-one.yaml

7.3 部署erpnext-one容器

docker compose --project-name erpnext-one -f ~/gitops/erpnext-one.yaml up -d

这部耗时有点久，需要耐心等待

7.4 部署站点

docker compose --project-name erpnext-one exec backend \
  bench new-site one.example.com --mariadb-root-password changeit --install-app erpnext --admin-password changeit

到这里就部署完成了。部署完成后直接使用本机ip登录是会找不到页面的。且http协议登录也是会报错找不到页面的。需要使用https协议+域名登录。也就是在浏览器输入https://one.example.com 登录。为了让one.example.com解析到部署机器的ip地址呢，需要在host文件中配置ip 于域名one.example.com的映射。

接下来会继续进行ERPnext的部署分享。计划把我部署好的环境的docker容器打包成镜像，以后在其它的地方部署指定docker compose就可以部署成功。
拒绝转载，谢谢