apluslms/run-mooc-jutut

run-mooc-jutut

Docker容器用于运行https://github.com/apluslms/mooc-jutut，适用于本地开发和测试场景。

核心功能

• MOOC-Jutut安装在/srv/jutut，可挂载源码到/src/jutut（自动复制并编译翻译文件）或直接挂载到/srv/jutut（需手动编译翻译文件，支持Django热重载）。
• /data为卷，存储数据库和密钥，支持普通用户运行容器。
• 可通过环境变量启用Django调试工具栏。
• 支持VS Code Python远程调试。

使用场景

• MOOC-Jutut的本地开发与功能测试。
• 代码调试（含远程调试）。
• 翻译文件编译与验证。

配置说明

环境变量

• JUTUT_ENABLE_DJANGO_DEBUG_TOOLBAR：设置为True启用Django调试工具栏，默认false。

挂载卷

• 持久化数据卷：data:/data（存储数据库和密钥）。
• 源码挂载：/home/user/mooc-jutut/:/src/jutut/:ro（自动编译翻译）或/home/user/mooc-jutut/:/srv/jutut/:ro（需手动编译）。

Docker Compose示例

yaml
services:
  jutut:
    image: docker.xuanyuan.run/apluslms/run-mooc-jutut:2.4
    # 启用VS Code远程调试时取消注释以下命令
    # command: "python3 -m debugpy --wait-for-client --listen 0.0.0.0:5678 manage.py runserver 0.0.0.0:8082"
    environment:
        JUTUT_ENABLE_DJANGO_DEBUG_TOOLBAR: 'false'
    volumes:
      - data:/data
      # 挂载本地源码到/src/jutut（可选）
      # - /home/user/mooc-jutut/:/src/jutut/:ro
      # 或挂载到/srv/jutut（可选）
      # - /home/user/mooc-jutut/:/srv/jutut/:ro
    ports:
      - "8082:8082"
      # VS Code调试端口映射（可选）
      - "5677:5678"

  grader:
    image: docker.xuanyuan.run/apluslms/run-mooc-grader:1.17
    volumes:
      - data:/data
      - /var/run/docker.sock:/var/run/docker.sock
      - /tmp/aplus:/tmp/aplus
      # 挂载课程目录（可选）
      # - $HOME/courses/aplus-manual:/srv/courses/default:ro
    ports:
      - "8080:8080"

  plus:
    image: docker.xuanyuan.run/apluslms/run-aplus-front:1.18
    environment:
      APLUS_ENABLE_DJANGO_DEBUG_TOOLBAR: 'false'
    volumes:
      - data:/data
    ports:
      - "8000:8000"
    depends_on:
      - grader

volumes:
  data:

VS Code调试配置（launch.json）

在MOOC-Jutut源码目录的.vscode/launch.json中添加以下配置：

json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Remote Attach: Jutut Python",
            "type": "python",
            "request": "attach",
            "connect": {
                "host": "localhost",
                "port": 5677
            },
            "pathMappings": [
                {
                    "localRoot": "${workspaceFolder}",
                    "remoteRoot": "/srv/jutut"
                }
            ],
            "justMyCode": false
        }
    ]
}