coursemology/evaluator-image-java

Coursemology Java Evaluator Image

镜像概述

Coursemology Java Evaluator Image是用于在受控容器环境中运行Java代码包的Docker镜像。该镜像基于安装了make并配置了容器命令的base镜像（构建于Debian 8或10系统），专门用于模拟Coursemology自动评分器的运行环境，帮助用户调试无法通过自动评分的Java代码。

核心功能和特性

• 受控环境运行：提供与Coursemology自动评分器一致的隔离容器环境，确保代码运行条件的一致性
• 自动评分模拟：可手动执行自动评分流程，复现评分过程中的问题
• 调试支持：允许用户直接修改代码并重新测试，快速定位问题所在
• 标准化工具链：预安装Java开发和测试所需的工具链，无需额外配置

使用场景

适用于Coursemology平台用户在Java编程题提交后，代码无法通过自动评分器时，进行本地调试。通过模拟自动评分过程，帮助用户识别代码逻辑错误、编译问题或测试用例适配问题。

使用方法

前提条件

1. 安装Docker以在本地运行镜像

拉取镜像

Java仅提供一个官方镜像，直接拉取即可：

bash
docker pull coursemology/evaluator-image-java

准备代码包文件

1. 在Coursemology编辑Java编程题页面，下载题目对应的代码包ZIP文件
2. 解压ZIP文件到本地文件夹
3. 将待调试的Java代码复制到解压目录中的submission文件夹
4. 包结构详情可参考https://github.com/coursemology/evaluator-samples

启动调试容器

使用以下命令启动容器并进入交互式Shell，同时挂载本地代码包目录到容器中：

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

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

bash
root@container-id:/# cd /home/coursemology/package
root@container-id:~/package#

运行测试

容器中预安装了自动评分脚本coursemology-evaluate.sh，通过以下命令执行测试流程：

1. 准备测试环境：

   bash
   make prepare
   

2. 编译代码（Java为编译型语言，修改代码后需重新执行）：

   bash
   make compile
   

3. 运行公开测试：

   bash
   make public
   

查看测试报告

测试完成后，在当前目录下生成report.xml文件，包含详细的测试结果：

bash
cat report.xml

其他常用命令

• 运行私有测试：

  bash
  make private
  

• 运行完整评估测试：

  bash
  make evaluation
  

• 清理测试环境（当配置文件混乱时使用）：

  bash
  make clean