negash/gitlab-tuning

Gitlab Tuning 镜像文档

镜像概述

Gitlab Tuning是一个针对Gitlab平台的功能增强与系统调优镜像，旨在通过自动化工具链提升Gitlab的用户管理效率、数据统计能力及系统维护便捷性，适用于企业级Gitlab部署环境。

核心功能与特性

• 用户自动授权：新群组创建时自动添加指定用户为群组所有者
• 数据统计集成：向统计服务器发送标准化数据（用户、提交记录、仓库信息、时间戳）
• 头像同步机制：通过定时任务从LDAP服务器同步用户头像
• 新用户头像设置：为新注册用户自动配置默认头像
• 数据库修复工具：包含修复旧版Gitlab web_hooks表默认值的SQL脚本

使用场景与适用范围

• 企业Gitlab实例的用户管理自动化需求
• 需要收集Git活动数据进行统计分析的场景
• 基于LDAP认证的Gitlab环境中用户头像统一管理
• 旧版Gitlab升级后web_hooks表默认值异常修复

使用方法与配置说明

基础部署命令

bash
docker run -d --name gitlab-tuning \
  --network gitlab-network \  # 确保与Gitlab实例在同一网络
  -e GITLAB_URL="http://gitlab:80" \  # Gitlab实例地址
  -e STATISTIC_SERVER="http://stats-server:3000/api" \  # 统计服务器API端点
  -e LDAP_HOST="ldap.example.com" \  # LDAP服务器地址
  -e LDAP_PORT=389 \  # LDAP服务端口
  -e AVATAR_SYNC_CRON="0 2 * * *" \  # 每日凌晨2点执行头像同步
  gitlab-tuning:latest

环境变量配置说明

数据库修复操作

针对旧版Gitlab数据库中web_hooks表默认值异常问题，执行以下SQL命令：

sql
-- 修复web_hooks表默认事件配置
alter table web_hooks alter column push_events set default true;
alter table web_hooks alter column issues_events set default false;     
alter table web_hooks alter column merge_requests_events set default false;
alter table web_hooks alter column tag_push_events set default false;

执行方式：通过Gitlab数据库容器执行（需替换容器名和数据库信息）

bash
docker exec -it gitlab-postgresql psql -U gitlab -d gitlabhq_production -c "alter table web_hooks alter column push_events set default true;"
docker exec -it gitlab-postgresql psql -U gitlab -d gitlabhq_production -c "alter table web_hooks alter column issues_events set default false;"
docker exec -it gitlab-postgresql psql -U gitlab -d gitlabhq_production -c "alter table web_hooks alter column merge_requests_events set default false;"
docker exec -it gitlab-postgresql psql -U gitlab -d gitlabhq_production -c "alter table web_hooks alter column tag_push_events set default false;"