jimsihk/alpine-moodle

基于Alpine Linux的高可用性Moodle

!Docker Image Size !nginx 1.28 !php 8.4 !moodle-5.0 !License MIT

基于Alpine Linux构建的Docker Moodle环境，具备高可用性（HA）能力。

仓库：https://github.com/jimsihk/alpine-moodle

• 基于官方Moodle源码 https://github.com/moodle/moodle
• 构建于轻量级镜像 https://github.com/jimsihk/alpine-php-nginx
• 容器镜像体积小（完整版约150MB，精简版约90MB）
• 支持高可用性安装，兼容多种缓存存储（memcached、Redis）和PostgreSQL连接池（如PgBouncer）
• 通过插件 https://github.com/catalyst/moodle-cachestore_redissentinel 支持Redis Sentinel作为缓存存储
• 构建时可通过参数ARG_MOODLE_PLUGIN_LIST预安装Moodle插件
• 通过Renovate自动更新Moodle版本和Alpine包（见下文）
• 支持数据库只读副本
• 多架构支持：386、amd64、arm/v7、arm64、ppc64le、s390x
• 针对100并发用户优化
• 优化为仅在有流量时使用资源（通过PHP-FPM的ondemand进程管理器）
• 默认启用JIT
• 使用runit替代supervisord以减少内存占用
• 配置cron以非特权用户运行 https://github.com/gliderlabs/docker-alpine/issues/381#issuecomment-621946699
• 通过环境变量进行配置
• 自动更新Moodle插件并升级至新版本（构建时通过ARG_MOODLE_GIT_URL和ARG_MOODLE_GIT_BRANCH，运行时通过MOODLE_GIT_URL和MOODLE_GIT_BRANCH）
• NGINX、PHP-FPM服务以非特权用户（nobody）运行，提升安全性
• 所有服务日志重定向至Docker容器输出（可通过docker logs -f <容器名称>查看）
• 遵循KISS原则（保持简单），便于理解和调整

自动化发布

![Renovate]([***]

Moodle版本和包依赖通过Renovate进行监控，并通过拉取请求自动更新：https://github.com/renovatebot/renovate

https://github.com/jimsihk/alpine-moodle/actions/workflows/nightly.yml/badge.svg](https://github.com/jimsihk/alpine-moodle/actions/workflows/nightly.yml)

GitHub Action中的夜间构建会扫描变更，然后执行标记并在容器仓库发布新版本。

发布标签格式为：XXX.YYY.ZZ

• XXX = Moodle分支
• YYY = Moodle发布增量及基于Moodle源码version.php的变更编号
• ZZ = Git仓库发布编号

例如：对于Moodle 4.1.1+分支_401_版本2022112801.06，发布标签将从401.106.0开始

多容器仓库

镜像可在多个仓库获取：

• DockerHub: https://hub.docker.com/r/jimsihk/alpine-moodle
• Quay.io: [***]

镜像变体

alpine-moodle:XXX.YYY.ZZZ

• 标准版，包含完整功能

alpine-moodle:XXX.YYY.ZZZ-slim

• 体积更小的容器镜像
• 未安装Git
• 移除了就地代码升级功能（即忽略UPDATE_MOODLE_CODE）
• 构建时通过参数ARG_ENABLE_GIT_CLONE控制

使用方法

启动Docker容器：

docker compose up

启动Moodle集群：

./generate_ssl_cert.sh
docker compose --file docker-compose.replica.yml up

使用提供的凭据（环境变量）登录系统

示例docker-compose文件

• docker-compose.yml - 带PostgreSQL
• docker-compose.replica.yml - 带PostgreSQL、Redis和多个Moodle容器，使用NGINX作为负载均衡器并终止SSL
  • 执行generate_ssl_cert.sh生成localhost的示例SSL证书
  • 登录后设置缓存可参考[***]
  • 注意：此配置不适用于生产环境，仅用于演示

配置

在docker-compose.yml文件中定义环境变量

更多PHP和NGINX设置可参考基础镜像https://github.com/jimsihk/alpine-php-nginx/blob/dev/README.md

关于使用AUTO_UPDATE_MOODLE和UPDATE_MOODLE_CODE的重要说明

如果设为true，容器启动时执行更新会将Moodle设为CLI维护模式。此时任何用户（包括管理员）都无法使用Moodle。

如果部署Moodle容器集群以实现HA（如在Kubernetes上），建议将两者都设为false，以避免自动扩展（如添加额外容器）或容器重启（自动修复）时对用户造成意外中断。

自定义构建

Moodle插件

ARG_MOODLE_PLUGIN_LIST：定义插件列表

• 构建主Dockerfile时安装插件（较慢），使用ARG_MOODLE_PLUGIN_LIST：

docker buildx build . -t my_moodle_image:my_tag \
    --build-arg ARG_MOODLE_PLUGIN_LIST='mod_attendance mod_checklist mod_customcert block_checklist gradeexport_checklist'

• 仅构建以安装额外Moodle插件（较快），创建如下Dockerfile然后构建。

• Dockerfile.plugins示例：

dockerfile
# Dockerfile.plugins
FROM quay.io/jimsihk/alpine-moodle:latest

# 安装额外插件，空格/逗号分隔的参数（可选）
# 使用install-plugin-list带参数"-f"强制安装不兼容当前Moodle版本的插件
ARG ARG_MOODLE_PLUGIN_LIST=''
ENV MOODLE_PLUGIN_LIST=${ARG_MOODLE_PLUGIN_LIST}
RUN if [ -n "${MOODLE_PLUGIN_LIST}" ]; then /usr/libexec/moodle/install-plugin-list -p "${MOODLE_PLUGIN_LIST}"; fi && \
    rm -rf /tmp/moodle-plugins

• 自v4.2.1.02-2（402.102.2）起，可简化为：

dockerfile
# Dockerfile.plugins
FROM quay.io/jimsihk/alpine-moodle:latest

# 安装额外插件，空格/逗号分隔的参数（可选）
ARG ARG_MOODLE_PLUGIN_LIST=''
ENV MOODLE_PLUGIN_LIST=${ARG_MOODLE_PLUGIN_LIST}
RUN /usr/libexec/moodle/download-moodle-plugin

• 使用Dockerfile.plugins构建示例：

# 构建
docker buildx build . -t my_moodle_image:my_tag \
    -f Dockerfile.plugins \
    --build-arg ARG_MOODLE_PLUGIN_LIST='mod_attendance,mod_checklist,mod_customcert,block_checklist,gradeexport_checklist'

ARG_ALLOW_INCOMPATIBLE_PLUGIN：允许安装不兼容插件

• 自v4.2.1.02-2（402.102.2）起，ARG_ALLOW_INCOMPATIBLE_PLUGIN可用，控制是否继续安装最新可用版本（尽管可能与当前Moodle版本不兼容），默认值为false：

docker buildx build . -t my_moodle_image:my_tag \
    --build-arg ARG_MOODLE_PLUGIN_LIST='mod_attendance mod_checklist mod_customcert block_checklist gradeexport_checklist' \
    --build-arg ARG_ALLOW_INCOMPATIBLE_PLUGIN='true'

• 或使用自定义Dockerfile.plugins：

dockerfile
# Dockerfile.plugins
FROM quay.io/jimsihk/alpine-moodle:latest

ARG ARG_MOODLE_PLUGIN_LIST='mod_attendance mod_checklist mod_customcert block_checklist gradeexport_checklist'
ARG ARG_ALLOW_INCOMPATIBLE_PLUGIN='true'
ENV MOODLE_PLUGIN_LIST=${ARG_MOODLE_PLUGIN_LIST}
ENV ALLOW_INCOMPATIBLE_PLUGIN=${ARG_ALLOW_INCOMPATIBLE_PLUGIN}
RUN /usr/libexec/moodle/download-moodle-plugin

已知问题

无法创建/更新Moodle角色，提示“角色简称不正确”（https://github.com/erseco/alpine-moodle/issues/26%EF%BC%89

• 解决方法：安装Moosh并使用role-update-capability命令，注意仅插件0.39版本包含此命令
• 已修复，自版本v4.1.2.07-1（401.207.1）起

致谢

• 插件安装功能借鉴自https://github.com/krestomatio/container_builder/tree/master/moodle===SHORT_DESC=== 基于Alpine Linux的Moodle Docker镜像，集成NGINX和PHP-FPM，支持高可用性配置，轻量高效，适用于构建稳定的在线学习平台。

===FULL_DESC===# 基于Alpine Linux的高可用性Moodle

!Docker Image Size !nginx 1.28 !php 8.4 !moodle-5.0 !License MIT

基于Alpine Linux构建的Docker Moodle环境，具备高可用性（HA）能力。

仓库：https://github.com/jimsihk/alpine-moodle

• 基于官方Moodle源码 https://github.com/moodle/moodle
• 构建于轻量级镜像 https://github.com/jimsihk/alpine-php-nginx
• 容器镜像体积小（完整版约150MB，精简版约90MB）
• 支持多种缓存存储（memcached、Redis）和PostgreSQL连接池（如PgBouncer）的高可用安装
• 通过插件 https://github.com/catalyst