在 Debian 上进行 GitLab 定制化开发
一 环境准备与安装
- 更新系统并安装依赖：sudo apt update && sudo apt install -y curl openssh-server ca-certificates postfix。
- 添加 GitLab 官方仓库并安装社区版（CE）：
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo apt-get install gitlab-ce。
- 首次配置与启动：编辑 /etc/gitlab/gitlab.rb，设置外部访问地址（如 external_url ‘http://your-gitlab-domain.com’），然后执行 sudo gitlab-ctl reconfigure 与 sudo gitlab-ctl start。以上步骤完成后即可在 Debian 上获得可定制的 GitLab 实例。
二 核心配置定制
- 修改对外访问与 SSH：在 /etc/gitlab/gitlab.rb 中设置 external_url（建议使用域名与 HTTPS），并按需调整 gitlab_rails[‘gitlab_shell_ssh_port’]（如 22/2222）。
- 端口与监听：如需变更 Nginx 监听端口，可设置 nginx[‘listen_port’]（如 8080），并同步 external_url 端口。
- 自动化证书：启用 Let’s Encrypt 自动签发与续期（letsencrypt[‘enable’]、letsencrypt[‘auto_renew’] 等），或手动配置证书路径。
- 邮件通知：开启 SMTP（gitlab_rails[‘smtp_enable’] = true 等参数），用于密码重置、工单与流水线通知。
- 变更生效：每次修改 gitlab.rb 后执行 sudo gitlab-ctl reconfigure，必要时 sudo gitlab-ctl restart。
三 界面与功能扩展
- 自定义主题与静态资源：将自定义 CSS/JS 放入 /opt/gitlab/embedded/service/gitlab-rails/public/assets/（Omnibus 包内路径），或通过 Nginx/资产管道进行覆盖；修改后重启实例生效。
- 插件与集成：通过管理界面或市场集成 Jira/Slack 等；也可将自研服务以插件或外部集成方式接入。
- 功能开关：利用 gitlab_rails[‘feature_flags’] 控制新功能灰度与回滚，降低风险。
- API 扩展：使用 REST API/GraphQL API 做自动化（创建项目、用户、触发流水线等），配合访问令牌实现外部系统编排。
四 CI/CD 与 Runner 定制
- 流水线定义：在项目根目录创建 .gitlab-ci.yml，划分 build/test/deploy 阶段并编写脚本，实现构建、测试、部署自动化。
- Runner 注册与执行器：安装 GitLab Runner 并执行 sudo gitlab-runner register，选择 Docker/Shell/SSH 等执行器；在 CI 中按标签调度任务。
- 触发器与 Webhooks：通过项目 Webhooks 或 Pipeline Triggers 与外部系统（如 Jenkins、镜像仓库）联动，实现跨系统自动化。
五 高级定制与维护
- 源码级定制与开发环境：如需深度改动 Rails/前端代码，建议基于官方代码库搭建开发环境、运行测试并遵循发布流程；生产环境仍推荐 Omnibus 包 管理，通过覆盖配置与资源实现定制，减少与上游升级的冲突。
- 容器化定制：基于 gitlab/gitlab-ce:latest 编写 Dockerfile 预装依赖/主题，挂载 /etc/gitlab、/var/log/gitlab、/var/opt/gitlab 持久化数据；适合一致性与可移植部署。
- 存储与路径：通过 gitlab_rails[‘data_dir’] 等参数调整项目、日志与数据目录，满足大容量与分离存储需求。
- 监控与运维：集成 Prometheus + Grafana 监控实例性能与资源使用；变更后使用 sudo gitlab-ctl reconfigure/restart 使配置生效，并保留变更记录以便回滚。
