yashkumarverma/rc-heimdall

镜像概述

Heimdall是RC基础设施的主要微服务，承担用户管理、问题摄入、客户端API端点提供、与任务运行器交互、代码提交及评估等核心职责，是整个系统的请求处理中心。

核心功能

• 用户管理：处理用户注册、登录及权限控制
• 问题导入：从指定端点摄入编程问题数据
• API服务：为前端界面提供所需的API接口
• 任务交互：与任务运行器（task-runner）协同处理代码执行任务
• 代码评估：接收代码提交并完成评估流程

使用场景

• Reverse Coding活动的后台支撑系统
• 编程竞赛类平台的核心服务组件
• 需要代码提交与评估功能的教育类应用

配置说明

Heimdall运行依赖以下组件：

1. PostgreSQL数据库（需提前部署并配置连接信息）
2. Judge0服务（代码评估工具）
3. RC Task Runner服务（任务执行组件）

关键环境变量配置：

• NODE_ENV：运行环境（如production）
• DB_HOST：数据库主机地址
• DB_USERNAME：数据库用户名
• DB_PASSWORD：数据库密码
• DB_NAME：数据库名称
• JUDGE_ENDPOINT：Judge0服务端点
• JUDGE_CALLBACK：Judge0回调地址
• RUNNER_ENDPOINT_EXEC：任务运行器执行端点
• RUNNER_ENDPOINT_SEED：任务运行器同步端点

部署示例

本地开发运行

bash
# 克隆仓库
git clone https://github.com/YashKumarVerma/rc-heimdall
cd rc-heimdall

# 安装依赖
yarn install

# 启动开发服务器
yarn start:dev

Docker生产部署

bash
# 拉取最新镜像
docker pull yashkumarverma/rc-heimdall

# 启动容器（替换占位符为实际配置）
docker run -d \
    -p 80:80 \
    --name heimdall \
    -e NODE_ENV='production' \
    -e DB_HOST='your-postgres-host' \
    -e DB_USERNAME='your-db-username' \
    -e DB_PASSWORD='your-db-password' \
    -e DB_NAME='postgres' \
    -e JUDGE_ENDPOINT='http://your-judge0-endpoint' \
    -e JUDGE_CALLBACK='http://your-callback-url' \
    -e RUNNER_ENDPOINT_EXEC='http://your-task-runner-exec' \
    -e RUNNER_ENDPOINT_SEED='http://your-task-runner-seed' \
    yashkumarverma/rc-heimdall:latest

开源协作

Heimdall基于MIT许可证开源，欢迎通过GitHub提交issue或PR参与开发。若需新增功能，建议先提交需求issue讨论。

联系信息

• GitHub: https://github.com/yashkumarverma/
• 推特: @yash_kr_verma
• ***: ***
• Stack Overflow: https://stackoverflow.com/users/5131640/yash-kumar-verma