Debian中GitLab使用技巧与优化指南
依赖与环境准备
安装前确保系统更新至最新版本，安装必要依赖包（curl、openssh-server、ca-certificates、tzdata、postfix），其中postfix用于邮件通知（若需SMTP功能）。添加GitLab官方APT仓库：curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash，避免从第三方源安装导致兼容性问题。
配置external_url
编辑/etc/gitlab/gitlab.rb文件，设置external_url为服务器IP或域名（如http://your-server-ip或https://gitlab.example.com），此配置影响GitLab访问路径及邮件通知中的链接有效性，需与服务器实际地址一致。
禁用自带Nginx（可选）
若使用外部Nginx作为反向代理（如已有Nginx服务器），需修改/etc/gitlab/gitlab.rb：nginx['enable'] = false，执行sudo gitlab-ctl reconfigure应用配置，避免端口冲突（默认Nginx使用80/443端口）。
分支管理与协作流程
推荐采用Git Flow工作流（master/main分支用于稳定版本，develop分支用于集成开发，feature/*分支用于功能开发，release/*分支用于预发布，hotfix/*分支用于紧急修复），通过Merge Request（MR）进行代码审查，确保代码质量。创建项目时选择合适的可见性（公开、私有或内部），限制敏感代码的访问范围。
CI/CD自动化配置
在项目根目录创建.gitlab-ci.yml文件，定义自动化流程（如代码编译、测试、部署）。例如，使用docker executor运行job（隔离环境，避免“在我机器上能跑”的问题），配置缓存（cache: key: ${CI_COMMIT_REF_SLUG} paths: - vendor/bundle）加速依赖安装，减少重复构建时间。注册GitLab Runner（sudo gitlab-runner register），关联项目并配置执行器（如Docker、Shell）。
权限与安全管理
通过GitLab管理界面设置用户角色（Owner、Maintainer、Developer、Reporter、Guest），精细化控制对项目和仓库的访问权限（如Maintainer可合并MR，Developer可推送代码，Reporter仅能查看）。配置SMTP邮件服务（gitlab_rails['smtp_enable'] = true，填写SMTP服务器地址、端口、用户名密码），实现通知功能（如MR提醒、流水线状态变更通知）。
硬件资源配置
根据团队规模调整硬件：小型团队（≤5人）建议2核CPU、4GB内存、50GB SSD（满足基础代码托管需求）；中型团队（5-20人）建议4核CPU、8GB内存、100GB SSD（支持并发构建与高负载）；大型团队（≥20人）建议8核CPU、16GB+内存、200GB+ SSD（应对大规模代码库与CI/CD流水线）。优先使用SSD提升磁盘IO性能，避免磁盘瓶颈。
GitLab配置优化
编辑/etc/gitlab/gitlab.rb调整关键参数：unicorn['worker_processes']（根据CPU核心数设置，如4核设为4，提升并发处理能力）、sidekiq['concurrency']（设为CPU核心数的1-2倍，如4核设为4，优化后台任务处理）、postgresql['shared_buffers']（设为内存的25%-40%，如8GB内存设为2GB，提升数据库缓存效率）、gitlab_rails['git_timeout']（设为300秒，避免大仓库操作超时）。
缓存与存储优化
启用Redis缓存（redis['enable'] = true），加速GitLab对象访问（如用户会话、项目数据）；在.gitlab-ci.yml中配置缓存（如vendor/bundle、node_modules），减少每次构建的依赖下载时间。对于大附件（如设计文档、视频）、备份文件，使用对象存储（如Amazon S3、MinIO），降低服务器存储压力。
数据库优化
使用PostgreSQL（GitLab默认数据库），定期执行gitlab-rails db:migrate更新数据库结构；调整postgresql['max_connections']（设为并发用户数的2倍，如100并发设为200，避免连接数耗尽）、postgresql['work_mem']（设为4MB-8MB，提升复杂查询性能）、postgresql['maintenance_work_mem']（设为64MB-128MB，提升索引创建、备份等维护任务速度）。
监控与报警
使用Prometheus+Grafana搭建监控系统，采集GitLab的性能指标（如CPU使用率、内存占用、磁盘IO、流水线状态），设置报警规则（如CPU使用率超过80%持续5分钟、流水线失败时发送邮件/Slack通知），及时发现并解决问题。
日志管理
开启GitLab日志功能（默认开启），定期清理过期日志（如保留30天），避免日志文件过大占用磁盘空间。使用logrotate工具配置日志轮转（/etc/logrotate.d/gitlab），自动压缩、删除旧日志。
备份与恢复
配置自动备份（sudo vim /etc/gitlab/gitlab.rb添加gitlab_rails['backup_keep_time'] = 604800，保留7天备份），备份内容包括数据库、代码仓库、附件、配置文件。定期测试恢复流程（如模拟服务器故障，从备份中恢复GitLab），确保备份有效性。
定期更新
及时升级GitLab至最新稳定版本（sudo apt update && sudo apt upgrade gitlab-ce），获取性能优化、安全补丁（如修复漏洞）和新功能。升级前备份数据，遵循GitLab官方升级指南（如从CE升级至EE需额外步骤）。