Linux GitLab部署有哪些步骤

Linux 上部署 GitLab 的标准步骤

一 环境准备

• 选择主流发行版：如 Ubuntu/Debian 或 CentOS/RHEL。
• 硬件建议：至少 2 核 CPU、4 GB 内存（最低 2 GB）、20 GB+ 磁盘空间。
• 网络与端口：确保可访问互联网，并开放 HTTP 80 与 HTTPS 443；如通过 SSH 克隆，放行 22。
• 基础依赖与邮件（示例）：
  • Ubuntu/Debian：sudo apt update && sudo apt install -y curl openssh-server ca-certificates tzdata postfix
  • CentOS/RHEL：sudo yum install -y curl policycoreutils-python openssh-server postfix；随后启动并开机自启 SSH/Postfix。

二 安装方式一 Omnibus 包管理器安装（推荐）

• 添加官方仓库：
  • Ubuntu/Debian：curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
  • CentOS/RHEL：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
• 安装 GitLab CE（可一键带入 external_url）：
  • Ubuntu/Debian：sudo EXTERNAL_URL=“http://your-domain-or-ip” apt install -y gitlab-ce
  • CentOS/RHEL：sudo EXTERNAL_URL=“http://your-domain-or-ip” yum install -y gitlab-ce
• 使配置生效：sudo gitlab-ctl reconfigure
• 启动与验证：sudo gitlab-ctl start；sudo gitlab-ctl status。

三 安装方式二 Docker 与 Docker Compose

• 安装 Docker（示例）：sudo apt-get update && sudo apt-get install -y docker.io
• 准备 docker-compose.yml（示例，按需映射端口与目录）：
  • version: ‘3.6’
  • services:
    • gitlab:
      • image: gitlab/gitlab-ce:17.4.5-ce.0
      • container_name: gitlab
      • restart: always
      • ports:
        • ‘5480:80’
        • ‘5443:443’
        • ‘5022:22’
      • volumes:
        • ‘./config:/etc/gitlab’
        • ‘./logs:/var/log/gitlab’
        • ‘./data:/var/opt/gitlab’
      • shm_size: ‘256m’
• 启动：docker-compose up -d
• 容器内编辑 external_url：/opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml
• 重启使配置生效：docker exec -it gitlab gitlab-ctl restart。

四 初始化与安全配置

• 访问与初始化：浏览器打开配置的 external_url，首次访问为 root 用户设置密码。
• 防火墙放行（示例）：
  • UFW：sudo ufw allow ‘Nginx Full’；sudo ufw allow OpenSSH；sudo ufw enable
  • firewalld：sudo firewall-cmd --permanent --add-service={http,https,ssh}；sudo firewall-cmd --reload
• 配置 SMTP 邮件（示例，/etc/gitlab/gitlab.rb）：
  • gitlab_rails[‘smtp_enable’] = true
  • gitlab_rails[‘smtp_address’] = “smtp.example.com”
  • gitlab_rails[‘smtp_port’] = 587
  • gitlab_rails[‘smtp_user_name’] = “user@example.com”
  • gitlab_rails[‘smtp_password’] = “password”
  • gitlab_rails[‘smtp_authentication’] = “login”
  • gitlab_rails[‘smtp_enable_starttls_auto’] = true
  • gitlab_rails[‘gitlab_email_from’] = “gitlab@example.com”
  • 生效：sudo gitlab-ctl reconfigure
• 启用 HTTPS 与 Let’s Encrypt（/etc/gitlab/gitlab.rb）：
  • external_url ‘https://gitlab.example.com’
  • letsencrypt[‘enable’] = true
  • letsencrypt[‘contact_emails’] = [‘admin@example.com’]
  • 生效：sudo gitlab-ctl reconfigure。

五 常用运维命令与备份

• 服务管理：sudo gitlab-ctl start|stop|restart|status
• 查看日志：sudo gitlab-ctl tail
• 备份与恢复（Omnibus）：
  • 备份：sudo gitlab-backup create（备份文件位于 /var/opt/gitlab/backups）
  • 恢复：先停止相关服务（如 sudo gitlab-ctl stop puma/unicorn），再执行
    • sudo gitlab-backup restore BACKUP=timestamp_of_backup
    • 恢复后重启：sudo gitlab-ctl restart
• 建议：定期备份、监控磁盘与资源使用、为 external_url 配置有效证书与域名。