runtimes-docker 镜像文档

1. 镜像概述和主要用途

runtimes-docker 是一个容器化镜像，旨在提供 DMOJ（一个开源在线判题系统）支持的多种编程语言运行时环境。该镜像将各类编程语言的编译工具、解释器及依赖库打包为标准化容器，确保代码执行环境的一致性、隔离性和可移植性，主要用于在线判题系统、编程教育平台或多语言代码测试场景中，作为代码编译与执行的基础环境。

2. 核心功能和特性

2.1 多语言运行时支持

集成 DMOJ 官方支持的主流编程语言环境，包括但不限于：

• C/C++（GCC、Clang 编译器）
• Python（2.x/3.x 解释器及标准库）
• Java（JDK 及相关工具链）
• C#（Mono 运行时）
• JavaScript（Node.js 环境）
• Go、Ruby、PHP 等其他常见语言

2.2 环境隔离与安全性

通过容器化技术实现运行时环境隔离，避免不同代码执行时的资源冲突或依赖干扰；内置基础安全限制，降低恶意代码执行风险。

2.3 标准化配置

统一的目录结构和环境变量配置，简化外部系统（如 DMOJ 判题核心）与容器的交互，支持通过配置文件或命令行参数快速调整运行参数。

2.4 轻量级与可扩展性

基于精简基础镜像构建，减少资源占用；支持通过挂载卷动态扩展依赖库或工具链，适配定制化需求。

3. 使用场景和适用范围

3.1 在线判题系统搭建

作为 DMOJ 或其他在线判题平台的代码执行节点，提供标准化的编译/解释环境，确保判题结果的准确性。

3.2 编程教育与测评

用于编程课程作业提交、自动评分系统，或学生代码调试环境，提供一致的语言支持。

3.3 多语言代码测试

在开发流程中作为临时测试环境，快速验证跨语言代码片段的编译或执行结果，无需在本地配置复杂依赖。

3.4 CI/CD 流程集成

嵌入持续集成/部署 pipeline，用于自动化测试多语言项目的编译输出或运行时行为。

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker Engine（20.10+ 版本推荐）；
• 网络环境可访问镜像仓库（如 Docker Hub 或私有仓库）。

4.2 获取镜像

通过 Docker 命令拉取镜像（需替换 <image-source> 为实际镜像源，如私有仓库地址或官方镜像名）：

docker pull <image-source>/runtimes-docker:latest

4.3 基本使用方法

4.3.1 交互式运行（用于调试）

以交互式终端模式启动容器，直接进入运行时环境：

docker run -it --rm <image-source>/runtimes-docker:latest /bin/bash

• -it：启用交互式终端；
• --rm：容器退出后自动删除，避免残留；
• /bin/bash：启动 bash 终端，可直接执行编译/解释命令（如 gcc、python3）。

4.3.2 后台运行（作为服务节点）

通过挂载代码目录和配置文件，后台运行容器以接收外部任务：

docker run -d \
  --name dmoj-runtime \
  -v /path/to/local/code:/app/code \  # 挂载本地代码目录到容器内/app/code
  -v /path/to/config:/etc/dmoj/runtime \  # 挂载运行时配置文件
  --user 1000:1000 \  # 指定非root用户运行，增强安全性
  --memory 2g --cpus 1 \  # 限制资源使用（2GB内存，1核CPU）
  <image-source>/runtimes-docker:latest

4.4 配置参数说明

4.4.1 环境变量

4.4.2 挂载卷（Volumes）

4.4.3 资源限制

建议通过 docker run 参数限制容器资源，避免单个任务占用过多主机资源：

• --memory <size>：限制内存（如 2g、512m）；
• --cpus <number>：限制 CPU 核心数（如 1、0.5）；
• --pids-limit <number>：限制进程数（如 50）。

4.5 docker-compose 配置示例

适用于多容器部署场景（如与 DMOJ 判题核心联动）：

version: '3'
services:
  runtime:
    image: <image-source>/runtimes-docker:latest
    container_name: dmoj-runtime-node
    volumes:
      - ./local_code:/app/code:ro  # 只读挂载代码目录
      - ./runtime_config:/etc/dmoj/runtime:ro
    environment:
      - RUNTIME_LANG=python3,cpp
      - LOG_LEVEL=debug
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 2G
        reservations:
          cpus: '0.5'
          memory: 1G
    user: "1000:1000"
    restart: unless-stopped

5. 注意事项

• 镜像更新：定期拉取 latest 标签镜像以获取语言环境更新（如编译器版本升级）；
• 安全加固：生产环境中必须使用非 root 用户运行容器（通过 --user 参数指定），并限制挂载目录权限为只读（ro）；
• 兼容性：需与 DMOJ 判题系统版本匹配，具体支持的语言版本可通过 docker run --rm <image> /bin/bash -c "dmoj-runtime-list" 命令查看；
• 日志管理：运行时日志默认输出至 stdout，可通过 Docker 日志驱动（如 json-file、syslog）收集至外部系统。