apluslms/run-radar

Radar本地测试开发容器

镜像概述

本镜像为Radar工具提供本地测试与开发环境。Radar是一款开源工具，用于源代码及其他可标记化数据的自动相似度分析，支持通过HTTP钩子接收提交数据，异步处理并生成匹配结果，帮助用户评估相似案例。

核心功能

• 数据提交处理: 接收HTTP钩子请求记录新数据提交，并从指定API获取数据。
• 异步相似度匹配: 使用Celery异步处理提交数据，通过greedy string tiling库进行相似度匹配。
• 结果组织: 形成提交组便于评估相似案例，提供视图跟踪提交者的练习系列。
• 集成支持: 支持LTI登录认证，可与A+学习管理系统集成。

使用场景

• 本地开发: 用于Radar工具的本地开发与功能测试。
• 教育评估: 辅助教师检测学生提交作业的相似度，提升评估效率。

配置说明

依赖要求

• 必需依赖: Python 3.8+、RabbitMQ 3.8+、Django 4.2、Celery 5.2、Memcached 1.5及其他Python包（见requirements.txt）。
• 可选依赖: Scala 2.11（Scala tokenizer）、Node.js 4.2+Esprima 4.0（JavaScript tokenizer）、submission_files/目录的写入权限。

与A+集成步骤

1. 登录A+管理页面，在EXTERNAL_SERVICES下添加新LTI服务，URL设为<Radar地址>/auth/lti_login，勾选Enable api access。
2. 在Radar中生成消费者密钥和秘钥: python manage.py add_lti_key --desc aplus。
3. 验证Django设置中PROVIDERS["a+"]["host"]与A+服务URL匹配。
4. 将Radar添加到A+课程实例菜单作为外部服务。
5. （可选）添加课程钩子以自动获取新提交: 在Radar课程实例URL后追加/hook-submission作为钩子地址，在A+管理页面的COURSE下添加课程钩子。

Docker部署示例

Docker Run命令

bash
docker run -d -p 8000:8000 -v $(pwd)/local_data:/app/data docker.xuanyuan.run/apluslms/run-radar

Docker Compose配置

yaml
version: '3.8'
services:
  radar:
    image: docker.xuanyuan.run/apluslms/run-radar
    ports:
      - "8000:8000"
    volumes:
      - ./local_data:/app/data
    environment:
      - RABBITMQ_HOST=rabbitmq
      - MEMCACHED_HOST=memcached
    depends_on:
      - rabbitmq
      - memcached

  rabbitmq:
    image: docker.xuanyuan.run/rabbitmq:3.8-management
    ports:
      - "5672:5672"
      - "15672:15672"

  memcached:
    image: docker.xuanyuan.run/memcached:1.5
    ports:
      - "11211:11211"

基于开源构建

Radar基于以下开源项目构建:

• Django
• jQuery
• Bootstrap
• django-bootstrap-form
• highlight.js

原始作者

***，2015年2月9日