brndnmtthws/labhub

LabHub镜像说明

镜像概述

LabHub是一个基于Rust开发的GitHub机器人，旨在解决GitLab默认不构建外部（分叉）PR的问题，帮助开源项目在外部PR中使用GitLab CI进行自动化测试与构建。

核心功能

• 监听GitHub的webhook事件（PR和推送事件）
• 将外部PR的分支推送到GitLab以触发CI流水线
• 支持通过PR评论执行命令（如@labhub retry重试失败的流水线）

使用场景

• 开源项目需要对外部贡献者的PR进行GitLab CI自动化测试
• 项目团队确认无需担心外部构建中暴露secrets的场景

配置说明

1. 配置文件：使用LabHub.toml配置GitHub/GitLab的API令牌、SSH密钥路径等，可通过LABHUB_TOML环境变量指定文件路径。
2. Webhook设置：在GitHub仓库的settings/hooks中添加webhook，指向LabHub的/github/events路径，选择PR和推送事件，设置secret并与LabHub配置一致。
3. SSH密钥：为CI用户生成ECDSA密钥，将公钥上传至GitHub和GitLab，部署时挂载私钥。
4. 个人访问令牌：在GitHub（需repo权限）和GitLab（需api权限）生成令牌，填入配置文件。

部署示例

Docker Run命令

bash
docker run -d \
  --name labhub \
  -p 8080:8080 \
  -v /host/path/to/LabHub.toml:/app/LabHub.toml \
  -v /host/path/to/ssh/keys:/root/.ssh \
  -e LABHUB_TOML=/app/LabHub.toml \
  docker.xuanyuan.run/brndnmtthws/labhub

Helm部署（推荐）

1. 创建SSH密钥Secret：

bash
kubectl create secret generic labhub-ssh-keys \
  --from-file=github=/path/to/labhub-key.ecdsa \
  --from-file=gitlab=/path/to/labhub-key.ecdsa

2. 安装Helm Chart：

bash
cd helm/labhub
cp values.yaml myvalues.yaml
# 编辑myvalues.yaml配置（如镜像版本、端口、环境变量等）
helm upgrade --install labhub . -f myvalues.yaml