coursemology/evaluator-image-c_cpp

Coursemology评估器镜像

镜像概述和主要用途

这些镜像用于在受控容器中运行代码包，其命名遵循https://github.com/Coursemology/polyglot%E9%A1%B9%E7%9B%AE%E4%B8%AD%60Coursemology::Polyglot::Language%60%E5%AD%90%E7%B1%BB%E7%9A%84%E5%91%BD%E5%90%8D%E8%A7%84%E8%8C%83%E3%80%82%E6%89%80%E6%9C%89%E9%95%9C%E5%83%8F%E5%9D%87%E5%9F%BA%E4%BA%8E%60base%60%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E8%AF%A5%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E5%B7%B2%E5%AE%89%E8%A3%85%60make%60%E5%B9%B6%E9%85%8D%E7%BD%AE%E4%BA%86%E5%AE%B9%E5%99%A8%E5%91%BD%E4%BB%A4%E3%80%82%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E6%A0%B9%E6%8D%AE%E6%89%80%E5%9F%BA%E4%BA%8E%E7%9A%84OS%E9%95%9C%E5%83%8F%EF%BC%88Debian 8或10）进行标记，其他镜像则针对特定语言安装了所需的软件包。

核心功能和特性

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

使用场景和适用范围

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

使用方法和配置说明

前提条件

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

拉取镜像

Python

Python镜像按版本划分标签，无latest默认标签。可在https://github.com/Coursemology/evaluator-images/tree/master/python%E6%9F%A5%E7%9C%8B%E5%8F%AF%E7%94%A8%E7%89%88%E6%9C%AC%E3%80%82

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. 有关包结构的更多信息，请参考https://github.com/coursemology/evaluator-samples%E3%80%82

获取容器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.shhttps://github.com/Coursemology/evaluator-images/blob/master/base/usr/local/bin/coursemology-evaluate.sh%E7%94%A8%E4%BA%8E%E6%89%A7%E8%A1%8C%E8%87%AA%E5%8A%A8%E8%AF%84%E5%88%86%E7%9A%84%E6%AD%A5%E9%AA%A4%E5%BA%8F%E5%88%97%E3%80%82%E5%9C%A8%E5%8C%85%E7%9B%AE%E5%BD%95%E4%B8%AD%E8%BF%90%E8%A1%8C%E4%BB%A5%E4%B8%8B%E5%91%BD%E4%BB%A4%E6%89%A7%E8%A1%8C%E5%85%AC%E5%BC%80%E6%B5%8B%E8%AF%95%EF%BC%9A

bash
make prepare
make compile
make public

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

查看测试报告

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

其他Makefile命令

• 运行私有测试：

  bash
  make private
  

• 运行评估测试：

  bash
  make evaluation
  

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

  bash
  make clean