severecloud/gitlabvk

GitLab到VK通知服务

镜像概述

该镜像用于将GitLab的事件通知（如代码提交、合并请求、CI/CD结果）转发至VK平台，数据存储于VK官方Storage服务，确保安全可靠。支持多种配置方式，便于快速集成到团队协作或个人开发工作流中。

核心功能

• 接收GitLab事件并转发至VK群组/聊天
• 支持环境变量或配置文件（JSON、TOML、YAML等）灵活配置
• 提供HTTP服务监听事件请求
• 数据存储于VK Storage，使用gitlabvk_前缀管理键值

使用场景

• 团队协作：实时推送GitLab项目关键事件到VK群组，提升协作效率
• 个人开发：及时获取GitLab项目更新通知，掌握项目动态

配置说明

环境变量配置

使用GITLABVK_前缀的环境变量：

• GITLABVK_DOMAIN：接收事件的域名
• GITLABVK_ACCESS_TOKEN：VK群组访问令牌（需具备消息权限）
• GITLABVK_ADDR：服务监听地址（默认:8080）

配置文件配置

支持多格式配置文件（默认config.toml，可通过-config=路径指定）。示例TOML：

toml
domain = "example.com" # 接收事件的域名
access_token = "your_vk_token" # VK群组令牌
addr = ":8080" # 监听地址（可选）

获取VK令牌步骤

1. 进入VK群组「管理社区」→「消息」开启社区消息并保存
2. 进入「设置为机器人」开启机器人功能并保存
3. 进入「API工作」→「创建密钥」，选择消息权限后复制令牌

部署示例

Docker部署

bash
docker run -d -p 8080:8080 \
-e GITLABVK_DOMAIN=your_domain.com \
-e GITLABVK_ACCESS_TOKEN=your_vk_token \
severecloud/gitlabvk

Docker Compose部署

yaml
services:
  gitlabvk:
    image: severecloud/gitlabvk
    environment:
      GITLABVK_DOMAIN: your_domain.com
      GITLABVK_ACCESS_TOKEN: your_vk_token
    ports:
      - "8080:8080"