code-executor-service Docker镜像文档

镜像概述

本镜像用于部署和运行code-executor-service，提供代码执行服务的容器化运行环境。通过封装服务依赖和配置，实现code-executor-service的快速部署，支持在隔离环境中安全执行用户提交的代码并返回执行结果。

核心功能与特性

• 隔离执行环境：基于容器化技术实现代码执行的环境隔离，防止不同任务间的资源干扰
• 多语言支持：默认集成主流编程语言的运行时环境（具体语言依赖服务配置）
• 资源管控：支持配置CPU、内存等系统资源限制，避免单个任务过度占用资源
• 安全机制：内置基础安全沙箱，限制代码对宿主系统的访问权限
• 轻量化部署：容器化封装简化环境依赖管理，支持快速启停和横向扩展

使用场景与适用范围

• 在线编程教育：为学***者提供实时代码运行环境，支持即时反馈执行结果
• 自动评测系统：用于编程题目评测、作业自动批改等场景
• CI/CD集成：在持续集成流程中执行测试代码，验证代码功能正确性
• 开发工具后端：作为代码编辑器、IDE的后端服务，提供代码运行支持

使用方法与配置说明

基础启动命令

通过以下命令启动code-executor-service容器：

docker run -d -p 8080:8080 --name code-executor-service [镜像名称]:[版本标签]

环境变量配置

可通过环境变量自定义服务参数，常用配置项如下：

自定义配置示例

指定端口、日志级别和资源限制启动：

docker run -d \
  -p 9000:9000 \
  -e PORT=9000 \
  -e LOG_LEVEL=DEBUG \
  -e SUPPORTED_LANGUAGES="python,cpp,go" \
  -e CPU_LIMIT=1.0 \
  -e MEM_LIMIT=512 \
  --name code-executor-service [镜像名称]:[版本标签]

数据持久化

如需持久化存储执行日志，可挂载日志目录：

docker run -d \
  -p 8080:8080 \
  -v /host/path/to/logs:/app/logs \
  --name code-executor-service [镜像名称]:[版本标签]

健康检查

服务启动后，可通过访问以下地址验证服务状态：

http://localhost:8080/health

返回{"status":"UP"}表示服务正常运行。

注意事项

• 建议使用Docker Engine 20.10及以上版本运行
• 生产环境中应配置网络隔离和资源限制，增强安全性
• 根据实际业务需求调整支持的编程语言和资源参数，避免资源滥用