run-mooc-grader

镜像概述和主要用途

这是一个运行A+ MOOC-grader的Docker容器，默认暴露8080端口，核心功能是托管交互式课程内容。注意，MOOC-grader仅提供课程材料的托管服务，需配合A-plus前端使用，以实现用户界面展示和数据库记录存储。A-plus手册课程（A-plus manual course）中提供了Docker Compose配置文件，可用于课程内容的开发和测试。

核心功能和特性

• 交互式课程托管：提供A+平台交互式课程材料的运行环境
• 端口暴露：默认通过8080端口提供服务，支持端口映射配置
• 数据持久化：/data目录作为持久化卷，存储练***数据、数据库文件和密钥
• 课程目录挂载：支持将课程（git）目录挂载到/srv/courses/default（目录名"default"为容器内脚本硬编码）
• 开发模式支持：可挂载MOOC-grader源代码到/src/grader（自动复制到/srv/grader并编译翻译文件）或直接挂载到/srv/grader（需手动编译翻译文件，支持Django代码热重载）
• 非root运行兼容：/data目录为世界可写权限，支持普通用户运行容器

使用场景和适用范围

适用于A+平台的课程开发、测试和部署环境，主要用于：

• 课程开发者测试交互式课程内容
• 教育机构部署在线课程评分系统
• 配合A-plus前端构建完整的在线教育平台

使用方法和配置说明

目录结构说明

• /srv/grader：MOOC-grader程序安装目录，开发时可直接挂载源代码至此（需手动编译翻译文件）
• /src/grader：开发源代码挂载目录，容器会自动将代码复制到/srv/grader并编译翻译文件
• /srv/courses/default：课程内容挂载点，需将课程仓库目录挂载至此（只读权限推荐）
• /data：数据持久化卷，存储练***数据、数据库和密钥信息

必要挂载项

运行容器时必须挂载以下目录：

• /var/run/docker.sock:/var/run/docker.sock：Docker通信所需
• /tmp/aplus:/tmp/aplus：临时文件存储

Docker Compose配置示例

yaml
services:
  grader:
    image: apluslms/run-mooc-grader
    volumes:
      # 必要挂载项
      - /var/run/docker.sock:/var/run/docker.sock
      - /tmp/aplus:/tmp/aplus
      # 挂载课程目录（当前目录假设为课程仓库）
      - .:/srv/courses/default:ro
      # 命名持久卷（数据持久化）
      # - data:/data
      # 开发模式挂载（源代码到/src/grader，自动复制并编译）
      # - /home/user/mooc-grader/:/src/grader/:ro
      # 开发模式挂载（源代码直接到/srv/grader，支持热重载）
      # - /home/user/mooc-grader/:/srv/grader/
    ports:
      - "8080:8080"
volumes:
  data:

启动命令示例

使用Docker Compose启动（基于上述配置文件）：

bash
docker-compose up -d

直接使用Docker命令启动：

bash
docker run -d \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /tmp/aplus:/tmp/aplus \
  -v /path/to/course:/srv/courses/default:ro \
  apluslms/run-mooc-grader

开发模式配置

开发环境下推荐以下挂载方式：

1. 自动复制模式（适合日常开发）：

yaml
volumes:
  - /home/user/mooc-grader/:/src/grader/:ro

容器启动时会自动将源代码复制到/srv/grader并编译翻译文件

2. 直接挂载模式（适合调试，支持热重载）：

yaml
volumes:
  - /home/user/mooc-grader/:/srv/grader/

需提前手动编译翻译文件，修改代码后Django会自动重载服务器