一、部署前系统准备与环境要求

1.1 服务器配置建议

推荐使用Ubuntu 20.04 LTS/CentOS 7+系统，硬件配置建议：4核CPU、8GB内存、100GB磁盘空间（存储库增长需预留空间）。磁盘建议采用SSD以提升I/O性能，网络带宽需保证100Mbps以上以支持多用户并发操作。

1.2 依赖环境安装

# Ubuntu系统安装依赖
sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata perl
# CentOS系统安装依赖
sudo yum install -y curl policycoreutils-python-utils openssh-server
sudo yum install -y postfix  # 邮件通知依赖
sudo systemctl enable postfix && sudo systemctl start postfix

1.3 防火墙配置

开放必要端口：80（HTTP）、443（HTTPS）、22（SSH）、8080（可选Prometheus监控）：

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 22/tcp
sudo ufw enable  # Ubuntu系统
# CentOS使用firewalld
sudo firewall-cmd --permanent --add-service={http,https,ssh}
sudo firewall-cmd --reload

二、GitLab安装方式详解

2.1 Omnibus包安装（推荐）

# Ubuntu/Debian系统
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo EXTERNAL_URL="http://your-server-ip" apt-get install gitlab-ce
# CentOS/RHEL系统
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
sudo EXTERNAL_URL="http://your-server-ip" yum install -y gitlab-ce

2.2 Docker容器部署

version: '3'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    restart: always
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://your-server-ip'
        gitlab_rails['gitlab_shell_ssh_port'] = 2222
    ports:
      - "80:80"
      - "443:443"
      - "2222:22"
    volumes:
      - ./config:/etc/gitlab
      - ./logs:/var/log/gitlab
      - ./data:/var/opt/gitlab

2.3 源码编译安装（高级用户）

需准备Ruby 2.7+、Go 1.13+、Node.js 12+环境，编译过程约30-60分钟：

sudo apt install -y build-essential zlib1g-dev libyaml-dev libssl-dev \
libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl
git clone https://gitlab.com/gitlab-org/gitlab-foss.git -b 15-x-stable
cd gitlab-foss
bundle install --deployment --without development test postgres aws kerberos
bundle exec rake gitlab:setup RAILS_ENV=production

三、核心配置与优化

3.1 配置文件解析

主配置文件位于/etc/gitlab/gitlab.rb，关键参数说明：

# 外网访问配置
external_url 'https://gitlab.example.com'
# 邮件服务配置
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
# 备份配置
gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"
gitlab_rails['backup_archive_permissions'] = 0644

3.2 性能调优参数

• 数据库缓存：postgresql['shared_buffers'] = "256MB"（根据内存调整）
• Unicorn工作进程：unicorn['worker_processes'] = 4（CPU核心数×2）
• Sidekiq并发数：sidekiq['concurrency'] = 25

3.3 HTTPS证书配置

使用Let’s Encrypt免费证书：

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d gitlab.example.com
# 修改gitlab.rb指向证书
external_url 'https://gitlab.example.com'
nginx['ssl_certificate'] = "/etc/letsencrypt/live/gitlab.example.com/fullchain.pem"
nginx['ssl_certificate_key'] = "/etc/letsencrypt/live/gitlab.example.com/privkey.pem"

四、运维管理最佳实践

4.1 定期备份策略

# 手动备份
sudo gitlab-rake gitlab:backup:create
# 自动化备份（crontab示例）
0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create CRON=1

4.2 升级流程

# 查看可用版本
sudo apt-cache madison gitlab-ce
# 升级操作
sudo apt update && sudo apt install gitlab-ce
# 升级后检查
sudo gitlab-ctl status
sudo gitlab-rake gitlab:check SANITIZE=true

4.3 监控方案

• Prometheus集成：通过/etc/gitlab/gitlab.rb启用

  prometheus_monitoring['enable'] = true

• Grafana仪表盘：导入GitLab官方模板（ID：9977）

五、常见问题解决方案

5.1 502错误排查

1. 检查Unicorn进程状态：sudo gitlab-ctl tail unicorn
2. 内存不足时调整swap：

   sudo fallocate -l 4G /swapfile
   sudo chmod 600 /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile

5.2 邮件发送失败

测试邮件配置：

sudo gitlab-rails console
ActionMailer::Base.deliveries.clear
Notify.test_email('user@example.com', 'Test Subject', 'Test Body').deliver_now

5.3 Git拉取缓慢优化

1. 启用Nginx静态资源缓存：

   location /assets/ {
   expires 1y;
   add_header Cache-Control "public";
   }

2. 配置Git存储加速：

   git_data_dirs({
   "default" => {
    "path" => "/var/opt/gitlab/git-data",
    "git_path" => "/opt/gitlab/embedded/bin/git"
   }
   })

六、进阶功能部署

6.1 CI/CD runner配置

# 注册Runner
sudo gitlab-runner register \
  --url https://gitlab.example.com/ \
  --registration-token REGISTRATION_TOKEN \
  --executor docker \
  --docker-image alpine:latest \
  --description "docker-runner"

6.2 镜像仓库集成

# 在gitlab.rb中启用容器镜像仓库
registry['enable'] = true
registry_external_url 'https://registry.example.com'
nginx['listen_port'] = 5050  # 镜像仓库专用端口

6.3 高可用架构

采用三节点架构：

1. 数据库主从复制（PostgreSQL）
2. Redis集群配置
3. 共享存储（NFS/Ceph）

本教程覆盖了GitLab部署的全生命周期管理，从基础安装到企业级高可用配置。实际部署时建议先在测试环境验证配置，生产环境建议使用自动化运维工具（如Ansible）实现标准化部署。根据GitLab官方数据，合理配置的实例可支持500+并发用户稳定运行，建议每季度进行一次健康检查和性能优化。