monogramm/docker-frappe

![]([] ![]([]

Frappe自定义Docker容器

🐋 Frappe应用的Docker镜像。

此镜像受社区开发的多个其他容器启发：

• https://github.com/emadshaaban92/docker-compose-erpnext/ / https://github.com/BizzoTech/docker-frappe 提供"简单"的docker-compose设置
• https://github.com/donysukardi/docker-frappe 提供alpine变体（BizzoTech镜像的实际来源）
• https://github.com/pipech/erpnext-docker-debian 提供应用和站点的完整设置
• https://github.com/madnight/docker-alpine-wkhtmltopdf

核心概念如下：

• 无需提供任何配置文件：容器将通过环境变量自动生成所有配置
• 应用容器设置所有环境变量，其他容器等待设置完成
• 提供PostgreSQL兼容性
• 容器自动检测并执行迁移
• 容器自动检测并移除缺失的模块/应用
• 允许前后自定义"node"脚本

查看镜像 https://github.com/Monogramm/docker-erpnext 了解如何扩展此镜像并构建Frappe应用。

什么是Frappe

全栈Web应用框架，服务器端使用Python和MariaDB，客户端使用紧密集成的库。为ERPNext构建。

frappe.io

https://github.com/frappe/frappe

支持的标签

https://hub.docker.com/r/monogramm/docker-frappe/

• develop-buster （images/develop-master/buster/Dockerfile）
• develop-slim-buster （images/develop-master/slim-buster/Dockerfile）
• develop-alpine develop （images/develop-master/alpine/Dockerfile）
• 13.6.0-buster 13.6-buster 13-buster （images/13-master/buster/Dockerfile）
• 13.6.0-slim-buster 13.6-slim-buster 13-slim-buster （images/13-master/slim-buster/Dockerfile）
• 13.6.0-alpine 13.6-alpine 13-alpine 13.6.0 13.6 13 （images/13-master/alpine/Dockerfile）
• 12.19.2-buster 12.19-buster 12-buster （images/12-master/buster/Dockerfile）
• 12.19.2-slim-buster 12.19-slim-buster 12-slim-buster （images/12-master/slim-buster/Dockerfile）
• 12.19.2-alpine 12.19-alpine 12-alpine 12.19.2 12.19 12 （images/12-master/alpine/Dockerfile）
• version-11-hotfix-buster 11.x-buster 11-buster （images/11-master/buster/Dockerfile）
• version-11-hotfix-slim-buster 11.x-slim-buster 11-slim-buster （images/11-master/slim-buster/Dockerfile）
• version-11-hotfix-alpine 11.x-alpine 11-alpine version-11-hotfix 11.x 11 （images/11-master/alpine/Dockerfile）

通过环境变量自动配置

镜像支持通过环境变量自动配置。

Docker入口点配置

sh
# Docker "节点"类型。定义容器行为。
# 可通过命令参数或环境变量设置。
# 可选值：
#   doctor
#   setup
#   setup-database
#   build-apps
#   update
#   backup
#   restore
#   migrate
#   app
#   scheduler
#   worker-default
#   worker-long
#   worker-short
#   node-socketio
NODE_TYPE=

# 容器等待数据库启动的时间（秒）
DOCKER_DB_TIMEOUT=120

# 允许登录数据库的MariaDb主机。
# 仅在使用MariaDB且数据库由Frappe创建时需要（Frappe默认限制安装IP）。
# 这种情况下，使用172.%.%.%允许Docker网络上的任何容器
DOCKER_DB_ALLOWED_HOSTS=

# 容器等待应用设置的时间（秒）
DOCKER_APPS_TIMEOUT=600

# 容器等待站点设置的时间（秒）
DOCKER_SITES_TIMEOUT=900

# 设置为1可在容器崩溃时显示所有日志文件
DOCKER_DEBUG=

DOCKER_GUNICORN_BIND_ADDRESS=0.0.0.0
DOCKER_GUNICORN_PORT=8000
DOCKER_GUNICORN_WORKERS=4
DOCKER_GUNICORN_TIMEOUT=120
DOCKER_GUNICORN_LOGLEVEL=info

# 如果要为ERPNext应用启用SSL
# 使用Let's Encrypt时，应如下设置属性：
#   certfile=/etc/letsencrypt/live/my.domain.com/fullchain.pem
#   keyfile=/etc/letsencrypt/live/my.domain.com/privkey.pem
DOCKER_GUNICORN_CERTFILE=
DOCKER_GUNICORN_KEYFILE=

Frappe配置

sh
# 启动时初始化的Frappe应用列表（空格分隔，通过bench install-app安装）
FRAPPE_APP_INIT=

# 重置apps.txt
# 设置为1时，启动时将删除apps.txt的旧内容，仅包含FRAPPE_APP_INIT的内容
FRAPPE_APP_RESET=

# 受保护的应用，永不会被自动删除
# 主要用于确保frappe和erpnext不会因配置错误被移除
FRAPPE_APP_PROTECTED=frappe

# 默认协议。应设置为http（默认值）或使用SSL时的https
FRAPPE_DEFAULT_PROTOCOL=http

# 默认站点
FRAPPE_DEFAULT_SITE=

# 默认HTTP端口。应设置为80（默认值）或使用SSL时的443，或Nginx反向代理定义的任何自定义端口
FRAPPE_HTTP_PORT=80

# 默认后端端口。应设置为80（默认值）或应用后端定义的任何自定义端口
FRAPPE_WEBSERVER_PORT=80

# 默认socketio端口。应设置为3000（默认值）、生产环境常用的80或socketio服务定义的任何自定义端口
FRAPPE_SOCKETIO_PORT=3000

# 设置为1时，启动时删除所有站点数据
# 仅应在开发/测试环境中使用
FRAPPE_RESET_SITES=

# 重新安装数据库
# 设置为1时，将重新安装数据库。仅应在开发/测试环境中使用
FRAPPE_REINSTALL_DATABASE=

# 传递给bench build命令的构建选项
# 可与--restore一起使用，复制公共资产而不是创建符号链接
FRAPPE_BUILD_OPTIONS=

FRAPPE_LOGGING=1

GOOGLE_ANALYTICS_ID=

DEVELOPER_MODE=0
ALLOW_TESTS=0
SERVER_SCRIPT_ENABLED=0

ADMIN_PASSWORD=frappe

# 加密密钥
# 留空将生成随机的base64 32位密钥
ENCRYPTION_KEY=

数据库配置

sh
# 数据库类型。可选mariadb或postgresql
DB_TYPE=mariadb

DB_HOST=db
DB_PORT=3306

# 数据库名称。也用于Frappe关联的用户名
DB_NAME=frappe
DB_PASSWORD=youshouldoverwritethis

# 数据库root登录名。仅用于postgresql
DB_ROOT_LOGIN=root

# 数据库root密码。必填
DB_ROOT_PASSWORD=mariadb_root_password

邮件配置

sh
MAIL_MUTED=false
MAIL_HOST=mail
MAIL_PORT=587
MAIL_USE_SSL=tls
MAIL_LOGIN=frappe-mail
MAIL_PASSWORD=youshouldoverwritethis

Redis配置

sh
REDIS_CACHE_HOST=redis_cache
REDIS_QUEUE_HOST=redis_queue
REDIS_SOCKETIO_HOST=redis_socketio

如何运行此镜像

此镜像不包含Frappe的数据库。您需要使用现有数据库或数据库容器。

此镜像设计用于微服务环境，使用docker-compose。有两种镜像变体可供选择：alpine或debian。

使用docker-compose运行此镜像

• 在images文件夹中选择最接近您需求的版本
  • 可注释build行，取消注释image行并编辑版本以下载预构建的Docker容器
• 根据需要编辑.env中定义的变量
• 使用docker-compose up -d运行docker-compose
• 访问http://localhost:80进入首次运行安装向导

问题/反馈

如果在使用镜像时遇到任何问题，请访问我们的https://github.com/Monogramm/docker-frappe%E6%8F%90%E4%BA%A4issue%E3%80%82

文档

更多文档可查看此处。