Ubuntu 上 GitLab 集成方案
一 部署与集成架构选型
- 原生 Omnibus 包部署：在 Ubuntu 上通过官方仓库安装 GitLab CE/EE，适合生产长期使用，配置集中、维护简单。关键步骤：安装依赖（如 curl、openssh-server、ca-certificates、tzdata、perl），添加官方仓库，安装包，编辑 /etc/gitlab/gitlab.rb（设置 external_url 等），执行 gitlab-ctl reconfigure 生效。适合需要完整控制与内网集成的团队。
- Docker Compose 部署：使用 gitlab/gitlab-ce:latest 或指定版本，映射 80/443/22，持久化 /etc/gitlab、/var/log/gitlab、/var/opt/gitlab，便于快速搭建与迁移；可用 docker-compose up -d 启动，适合测试、预发布或弹性环境。
- GitLab + Jenkins 集成：当已有 Jenkins 生态时，可用 GitLab 触发 Webhook，Jenkins 执行构建、测试、部署；注意端口冲突（如 8080），必要时在 GitLab 或 Jenkins 调整端口映射与反向代理。
二 CI/CD 集成与 Runner 实践
- Runner 安装与注册：在 Ubuntu 安装 GitLab Runner（添加 Runner 仓库并安装包），在 GitLab 项目 Settings → CI/CD → Runners 获取 URL 与 Registration token，选择执行器（如 shell、docker、docker+machine），完成注册；按需设置 tags、executor、concurrency。
- 流水线示例与镜像使用：在项目根目录创建 .gitlab-ci.yml，定义 stages: build → test → deploy；构建/测试阶段可直接使用官方镜像（如 maven:3.6.3-jdk-8、node），部署阶段可按需使用 docker:dind 推送镜像到 CI_REGISTRY_IMAGE。
- 安全与合规要点：为 CI 创建 受保护变量（如 SSH_PRIVATE_KEY、REGISTRY_USER/PASSWORD），仅对受保护分支与标签启用部署作业；Runner 建议以 非 root 运行，必要时使用 Docker-in-Docker 隔离环境。
三 与 Docker 和 Kubernetes 的集成
- Docker 集成：在 Runner 中使用 docker 执行器或 docker:dind 构建与推送镜像；在 GitLab 项目设置 Container Registry 后，可直接使用 $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA 作为镜像标签，保证版本可追溯。
- Kubernetes 集成：在 GitLab 项目 → Infrastructure → Kubernetes clusters 添加集群，使用 Auto DevOps 或自定义 .gitlab-ci.yml 与 K8s manifests 实现滚动升级、蓝绿发布；结合 Ingress、Cert-Manager 提供 HTTPS 与证书自动化。
四 监控与告警体系
- 自监控与内置可视化：在 /etc/gitlab/gitlab.rb 启用 gitlab_rails[‘gitlab_metrics_enabled’] = true、gitlab_runner[‘metrics_enabled’] = true、global[‘monitoring_enabled’] = true，执行 gitlab-ctl reconfigure；在 Settings → Metrics and profiling → Self monitoring 启用自监控项目，查看实例健康与资源使用。
- Prometheus + Grafana：在 Prometheus 配置抓取 GitLab 目标（如 job_name: gitlab，targets: [‘your_gitlab_server_address’]），在 Grafana 添加 Prometheus 数据源并导入 GitLab 仪表盘；在 Prometheus 定义 告警规则（如 CPU > 80% 持续 1m），联动 Alertmanager 或邮件/企业微信/钉钉通知。
五 安全加固与运维要点
- 基础加固：使用 HTTPS/TLS（Let’s Encrypt 或企业 CA），限制 SSH 端口 与 防火墙 访问，禁用匿名注册（如不需要），开启 2FA，定期升级 GitLab 与 Runner；容器化部署时确保 卷持久化 与 备份 策略到位。
- 备份与恢复：Omnibus 环境执行 gitlab-rake gitlab:backup:create 定期备份；Docker Compose 环境执行 docker-compose exec gitlab gitlab-rake gitlab:backup:create 创建备份，恢复时使用 docker-compose exec gitlab gitlab-rake gitlab:backup:restore BACKUP=YYYY-MM-DD-HH-MM-SS；建议将备份文件异地存储并校验完整性。