submitty/autograding-default

镜像概述

该镜像为默认的完整自动评分容器，旨在提供一站式的代码自动评测解决方案。通过标准化的评测流程和灵活的配置选项，可对各类编程作业、代码提交或算法实现进行自动化评估，支持多种编程语言和评测标准，广泛应用于教育、在线编程平台及代码评估场景。

核心功能和特性

主要功能

• 多语言支持：兼容主流编程语言（如Python、Java、C++、JavaScript等）的代码评测需求。
• 自定义评测规则：支持通过配置文件定义评测指标（如正确性、性能、代码规范等）及权重。
• 自动化评分计算：根据测试用例执行结果自动计算得分，支持部分得分（如通过测试用例比例）。
• 详细报告生成：输出包含测试结果、错误信息、得分明细的结构化评测报告。
• 安全沙箱执行：采用隔离环境运行待评测代码，避免***代码对主机系统造成风险。

特性优势

• 开箱即用：内置基础评测框架和常用语言运行环境，无需额外配置即可快速启动评测任务。
• 可扩展性：支持集成自定义测试工具、代码分析插件及第三方评分系统。
• 轻量高效：优化的容器体积和资源占用，支持批量任务并行处理。

使用场景和适用范围

典型场景

• 教育领域：高校或培训机构的编程课程作业自动批改，减少人工审核成本。
• 在线编程平台：为用户提交的代码提供实时自动评测和反馈。
• 代码竞赛/考核：编程竞赛、技术面试中的算法题自动评分，确保公平性和效率。
• 企业内部：开发团队的代码质量门禁检查，对提交代码进行自动化合规性和功能性验证。

适用对象

• 教育工作者、在线教育平台开发者
• 编程竞赛组织者、技术招聘评估人员
• 需要自动化代码质量管控的企业研发团队

使用方法和配置说明

基本使用命令

通过docker run命令启动容器，需挂载待评测代码和测试用例目录，并配置必要环境变量：

bash
docker run -d \
  --name autograder \
  -e LANGUAGE=python \
  -e TEST_CASE_DIR=/testcases \
  -e SCORE_THRESHOLD=60 \
  -v /local/code:/code \
  -v /local/testcases:/testcases \
  [镜像名称]:[标签]

核心配置参数

环境变量

卷挂载

• 代码目录：需将本地待评测代码目录挂载至容器内CODE_DIR（默认/code），确保容器可访问代码文件。
• 测试用例目录：需将本地测试用例目录挂载至容器内TEST_CASE_DIR（默认/testcases），测试用例需符合容器支持的格式（如.test文件或结构化目录）。

评测报告输出

评测完成后，报告默认生成在容器内/report目录下，可通过卷挂载将报告同步至本地：

bash
docker run -d \
  ... \
  -v /local/report:/report \
  [镜像名称]:[标签]

报告内容通常包含：

• 总体得分（基于测试用例通过率和权重计算）
• 各测试用例执行结果（通过/失败、耗时、输出对比）
• 代码规范性检查结果（如适用）
• 错误日志（针对失败用例的详细错误信息）

注意事项

1. 安全限制：容器默认启用沙箱模式，限制网络访问和系统资源占用，若需调整权限，可通过--cap-add参数添加特定系统能力。
2. 语言环境：部分编程语言可能需要额外依赖（如Python库、Java SDK版本），可通过自定义Dockerfile基于此镜像扩展环境。
3. 测试用例格式：测试用例需遵循容器定义的格式规范（通常包含输入、预期输出、权重等信息），具体格式可参考镜像附带的文档或示例用例。