mathinstitut/goemaxima

goemaxima Docker镜像文档

镜像概述和主要用途

goemaxima是由哥廷根数学研究所开发的webservice，作为stack（ilias和moodle平台中专注于数学的题型）的替代服务。该镜像主要设计为在集群环境中以Docker容器形式运行，尤其适合支持自动扩展的集群，因为服务本身不支持内置扩展。其采用Golang实现，通过使用fork机制而非为每个请求启动新进程，实现了比对应的Java版本更快的启动和处理速度。

核心功能和特性

• 高性能：基于Golang开发，通过fork机制减少进程启动开销，相比Java版本具有更快的启动和请求处理速度
• 集群适配：设计用于集群环境，特别适合支持自动扩展的集群部署
• 可配置性：通过环境变量灵活配置并发进程数、空闲进程队列长度等参数
• 监控支持：提供Prometheus metrics接口，便于监控服务运行状态
• 轻量级：作为Docker容器运行，部署简单，资源占用可控

使用场景和适用范围

• 部署ilias或moodle学习管理系统，需要为数学题型提供后端计算服务
• 需要高性能、低延迟数学计算处理的教育平台
• 需在集群环境中实现自动扩展以应对负载变化的场景

构建Docker镜像

前置条件

• 已安装Go环境

构建步骤

1. 首先通过buildweb.sh脚本构建web服务器，生成的可执行文件将位于./bin/目录：

   bash
   ./buildweb.sh
   

2. 然后使用buildimage.sh脚本构建特定stackmaxima版本的Docker镜像，需指定stackmaxima版本：

   bash
   ./buildimage.sh STACKMAXIMA_VERSION
   

示例

bash
$ ./buildweb.sh
$ ./buildimage.sh 2020061000

构建完成后，镜像将以goemaxima:2020061000-dev名称可用。支持的stackmaxima版本可查看仓库根目录的versions文件。

使用Docker镜像

预构建镜像获取

预构建镜像可从Docker Hub获取，格式为：mathinstitut/goemaxima:[version]-latest

服务访问

• 容器内服务器端口为8080
• stack中需配置的访问路径为http://[address:port]/goemaxima
• 旧版本镜像仅支持http://[address:port]/maxima，此路径在新版本中仍兼容

运行容器

bash
docker run --restart=always --tmpfs /tmp -p $port:8080 $imagename

参数说明：

• --restart=always：建议设置，因为服务在遇到无法恢复的错误时会退出
• --tmpfs /tmp：提高临时文件操作速度
• $port：宿主机端口，用于暴露服务
• $imagename：镜像名称，例如mathinstitut/goemaxima:2020120600-latest

环境变量配置

监控指标

Prometheus metrics通过/metrics路径暴露，包含以下指标：

• 成功响应数
• 超时响应数
• 内部错误响应数
• 进程启动时间直方图
• 响应时间直方图

许可证

goemaxima基于GPLv3许可证开源。