Coursemology评估器镜像

镜像概述和主要用途

这些镜像用于在受控容器中运行代码包，其命名遵循polyglot项目中Coursemology::Polyglot::Language子类的命名规范。所有镜像均基于base镜像构建，该基础镜像已安装make并配置了容器命令。基础镜像根据所基于的OS镜像（Debian 8或10）进行标记，其他镜像则针对特定语言安装了所需的软件包。

核心功能和特性

• 受控运行环境：提供隔离的容器环境，模拟Coursemology自动评分器的运行环境
• 多语言支持：支持Python、C++、Java等多种编程语言
• 版本区分：Python镜像按版本细分（如3.7），C++和Java各有一个统一镜像
• 调试工具集成：通过Makefile命令（prepare、compile、public等）模拟自动评分流程

使用场景和适用范围

当代码无法通过Coursemology自动评分器时，可使用这些Docker镜像手动模拟自动评分过程，帮助定位和调试问题。适用于需要排查编程作业提交中错误的学生或教师。

使用方法和配置说明

前提条件

安装Docker以在本地运行镜像。

拉取镜像

Python

Python镜像按版本划分标签，无latest默认标签。可在python文件夹查看可用版本。

bash
docker pull coursemology/evaluator-image-python:3.7

C++ 和 Java

这两种语言各仅有一个镜像：

bash
docker pull coursemology/evaluator-image-c_cpp

bash
docker pull coursemology/evaluator-image-java

准备包文件

1. 在Coursemology编辑编程题目时，点击包zip文件链接下载并解压。
2. 将需要调试的代码复制到解压后文件夹中的submission（提交）文件夹内。
3. 有关包结构的更多信息，请参考evaluator-samples仓库。

获取容器Shell

使用docker run启动容器，模拟Coursemology自动评分器环境。需指定-it和--entrypoint=/bin/bash，否则容器会执行评分脚本后立即退出。

为方便调试，将本地解压后的包文件目录挂载到容器的/home/coursemology/package：

bash
docker run -it --entrypoint=/bin/bash --mount type=bind,source="$(pwd)",target=/home/coursemology/package coursemology/evaluator-image-java

进入容器后，切换到包目录：

bash
root@someid:/# cd /home/coursemology/package
root@someid:~/package#

运行测试

coursemology-evaluate.sh脚本用于执行自动评分的步骤序列。在包目录中运行以下命令执行公开测试：

bash
make prepare
make compile
make public

可编辑测试运行器使用的文件后重新运行测试进行调试。prepare步骤的输出会显示相关文件路径，编译型语言需重新执行compile步骤。

查看测试报告

测试完成后，在包目录中生成的report.xml文件即为测试报告。

其他Makefile命令

• 运行私有测试：

  bash
  make private
  

• 运行评估测试：

  bash
  make evaluation
  

• 清理准备文件（当文件混乱时）：

  bash
  make clean