1. 为什么选择Docker部署GitLab在Linux环境下部署GitLab时Docker方案相比传统安装方式具有显著优势。首先容器化部署能完美解决依赖地狱问题——传统安装需要处理Ruby、PostgreSQL、Redis等复杂依赖关系而Docker镜像已包含所有预配置组件。我曾在CentOS 7上尝试源码编译安装光是解决openssl版本冲突就耗费了半天改用Docker后整个过程缩短到15分钟。其次Docker的隔离性让GitLab与其他服务互不干扰。当需要升级时只需拉取新镜像重启容器即可不会影响主机其他服务。这对于需要长期维护的代码仓库尤为重要我们团队就曾因传统安装的版本升级导致Nginx配置丢失而容器化部署完全规避了这类风险。2. 环境准备与前置检查2.1 硬件资源配置建议根据GitLab官方文档生产环境建议配置4核CPU及以上实测2核运行代码托管会明显卡顿4GB内存最低要求8GB才能流畅运行CI/CD50GB存储空间包含Docker镜像和仓库数据重要提示务必在部署前通过free -h和df -h确认资源情况。我曾遇到阿里云ECS突发性能实例因基准CPU不足导致容器频繁崩溃的情况。2.2 Docker环境配置对于主流Linux发行版Ubuntu/CentOS建议使用官方安装脚本# Ubuntu示例 curl -fsSL https://get.docker.com | sudo sh sudo systemctl enable --now docker验证安装成功后需要调整Docker守护进程配置sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json EOF { log-driver: json-file, log-opts: { max-size: 100m, max-file: 3 }, data-root: /data/docker # 建议修改默认存储位置 } EOF sudo systemctl restart docker3. GitLab容器化部署实战3.1 镜像拉取与启动使用官方Omnibus镜像包含所有组件sudo docker pull gitlab/gitlab-ce:latest启动容器时需要特别注意端口映射和数据持久化sudo docker run --detach \ --hostname gitlab.example.com \ --publish 8443:443 --publish 8080:80 --publish 8022:22 \ --name gitlab \ --restart always \ --volume /srv/gitlab/config:/etc/gitlab \ --volume /srv/gitlab/logs:/var/log/gitlab \ --volume /srv/gitlab/data:/var/opt/gitlab \ --shm-size 256m \ gitlab/gitlab-ce:latest参数解析--shm-size解决Sidekiq内存不足问题常见于CI/CD场景8022端口GitLab Shell的SSH端口必须与后续配置一致数据卷映射确保配置、日志、仓库数据持久化3.2 初始配置要点首次启动约需5-10分钟视硬件性能之后访问http://服务器IP:8080设置root密码。关键配置项位于/srv/gitlab/config/gitlab.rbexternal_url http://gitlab.example.com # 必须与--hostname一致 gitlab_rails[gitlab_shell_ssh_port] 8022 # 必须匹配docker映射端口 # 邮件服务配置以腾讯企业邮箱为例 gitlab_rails[smtp_enable] true gitlab_rails[smtp_address] smtp.exmail.qq.com gitlab_rails[smtp_port] 465 gitlab_rails[smtp_user_name] gitcompany.com gitlab_rails[smtp_password] password gitlab_rails[smtp_domain] exmail.qq.com gitlab_rails[smtp_authentication] login gitlab_rails[smtp_enable_starttls_auto] true gitlab_rails[smtp_tls] true应用配置后需要重建容器sudo docker exec -it gitlab gitlab-ctl reconfigure sudo docker restart gitlab4. 运维管理与故障排查4.1 日常维护命令查看容器状态sudo docker logs -f gitlab # 实时日志 sudo docker exec -it gitlab gitlab-ctl status # 服务状态备份与恢复# 备份会生成时间戳tar包 sudo docker exec -it gitlab gitlab-backup create # 恢复需要先停止相关服务 sudo docker exec -it gitlab gitlab-ctl stop unicorn sudo docker exec -it gitlab gitlab-ctl stop sidekiq sudo docker exec -it gitlab gitlab-backup restore BACKUP备份文件名4.2 常见问题解决方案问题1502 Whoops错误检查内存是否不足free -h查看unicorn日志sudo docker exec -it gitlab tail -n 100 /var/log/gitlab/unicorn/unicorn_stderr.log解决方案增加--shm-size参数或升级服务器配置问题2SSH克隆失败确认gitlab.rb中的ssh_port与docker映射端口一致检查防火墙规则sudo ufw allow 8022/tcp验证SSH连接ssh -T git服务器IP -p 8022问题3容器启动缓慢可能是PostgreSQL数据校验导致首次启动耐心等待查看启动进度sudo docker exec -it gitlab tail -f /var/log/gitlab/reconfigure.log5. 性能优化实践5.1 数据库调优对于超过100人的团队建议调整PostgreSQL参数postgresql[shared_buffers] 1GB # 建议为内存的25% postgresql[work_mem] 16MB # 复杂查询可提升至32MB postgresql[effective_cache_size] 3GB5.2 CI/CD优化修改Runner配置提升并发能力gitlab_ci[runner_concurrency] 10 # 默认4 gitlab_ci[runner_max_builds] 100 # 默认505.3 缓存配置使用Redis持久化缓存gitlab_rails[redis_cache_instance] redis://localhost:6379/0 gitlab_rails[redis_queues_instance] redis://localhost:6379/0 gitlab_rails[redis_shared_state_instance] redis://localhost:6379/06. 安全加固措施6.1 定期更新策略建议每月执行一次安全更新sudo docker pull gitlab/gitlab-ce:latest sudo docker stop gitlab sudo docker rm gitlab # 使用原有参数重新运行run命令6.2 防火墙配置最小化开放端口sudo ufw allow 8080/tcp # HTTP sudo ufw allow 8022/tcp # SSH sudo ufw enable6.3 备份策略设置每日自动备份通过crontab0 2 * * * /usr/bin/docker exec -it gitlab gitlab-backup create CRON1将备份同步到远程存储0 3 * * * rsync -avz /srv/gitlab/backups/ userbackup-server:/gitlab-backups在Kubernetes集群中部署时建议使用StatefulSet配合持久化卷声明(PVC)来管理GitLab实例。通过Ingress配置HTTPS访问并设置ResourceQuota限制资源使用。对于高可用方案需要单独部署PostgreSQL和Redis集群GitLab Rails应用配置为无状态服务横向扩展。
