illinois241/grader

Grader

镜像概述和主要用途

Grader是CS 241课程自动评分器的Docker化版本，旨在对学生提交的作业进行自动化评分。该镜像提供标准化的评分环境，确保评分过程的一致性和可重复性，支持多种作业类型和灵活的配置选项。

核心功能和特性

• 支持MP（编程项目）和lab（实验）两种作业类型的评分
• 可配置作业名称、具体部分、学生ID和提交截止日期
• 提供调试模式，便于问题排查
• 可选检查TA解决方案是否通过，确保评分环境有效性
• 支持使用unshare工具进行隔离测试，增强安全性
• 标准化的输出目录和代码仓库挂载机制

使用场景和适用范围

适用于CS 241课程的教学辅助场景，主要用于：

• 对学生提交的编程项目（MP）进行自动评分
• 对实验（lab）作业进行自动化评估
• 教学团队批量处理学生作业评分
• 提供一致的评分环境，减少环境差异导致的评分偏差

安装

该镜像已发布到Docker Hub，镜像名称为：illinois241/grader

配置

环境变量

卷

使用方法

手动运行容器

使用以下命令运行容器，需替换[...]为实际的环境变量和卷挂载配置：

sh
sudo docker run -e ASSIGNMENT_NAME="assignment1" -e ASSIGNMENT_TYPE="mp" -e STUDENT_ID="netid123" -v /path/to/job:/job -v /path/to/assignments:/job/assignments -v /path/to/student/repo:/job/netid123 -h cs241grader --network none -it illinois241/grader

其中：

• -e 参数指定环境变量（至少包含所有必填项）
• -v 参数指定卷挂载路径（需满足卷配置要求）
• -h cs241grader 设置容器主机名
• --network none 禁用网络，增强安全性
• -it 提供交互终端

使用辅助脚本

也可使用 run_grader.py 脚本简化运行过程。

测试

安装测试依赖

首先安装所有测试依赖（可安装到虚拟环境或全局环境）：

sh
pip install -r test_requirements.txt

执行测试

在当前目录执行以下命令运行集成测试：

sh
pytest