如何配置GitLab以适应Linux系统

一、准备工作

• 系统要求：推荐使用Ubuntu 22.04+或CentOS Stream 9+等主流Linux发行版；至少2GB RAM（推荐4GB+，生产环境建议8GB+）；至少20GB可用存储空间（根据项目规模调整）；确保服务器能访问互联网。
• 权限准备：需具备root或sudo权限，用于安装软件包和修改系统配置。

二、安装依赖包

• Ubuntu/Debian：更新包列表并安装必要依赖，包括curl（下载工具）、openssh-server（SSH服务，用于Git远程访问）、ca-certificates（SSL证书，保障通信安全）、tzdata（时区设置）、postfix（邮件服务，用于通知）：
  sudo apt update && sudo apt install -y curl openssh-server ca-certificates tzdata postfix。
• CentOS/RHEL：更新包列表并安装依赖，包括curl、policycoreutils-python（SELinux工具，若启用SELinux需此包）、openssh-server、postfix：
  sudo yum update && sudo yum install -y curl policycoreutils-python openssh-server postfix。

三、添加GitLab官方软件源

• Ubuntu/Debian：通过curl获取GitLab GPG密钥（验证软件包完整性），并添加GitLab APT源到系统源列表：
  curl https://packages.gitlab.com/gpg.key | sudo apt-key add -；
  echo "deb https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab-ce.list；
  更新APT缓存：sudo apt update。
• CentOS/RHEL：通过curl运行GitLab RPM脚本（添加YUM源），并安装源包：
  curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash。

四、安装GitLab Community Edition (CE)

• Ubuntu/Debian：通过APT安装GitLab CE：
  sudo apt install -y gitlab-ce。
• CentOS/RHEL：通过YUM安装GitLab CE：
  sudo yum install -y gitlab-ce。

五、配置GitLab

• 设置外部URL：编辑GitLab主配置文件/etc/gitlab/gitlab.rb（需root权限），修改external_url为服务器IP或域名（如http://192.168.1.100或https://gitlab.example.com）。若使用域名，需提前解析到服务器IP。
• 可选：配置邮件服务（用于账号通知、密码重置）：在/etc/gitlab/gitlab.rb中添加SMTP配置（以Gmail为例）：

  gitlab_rails['smtp_enable'] = true
  gitlab_rails['smtp_address'] = "smtp.gmail.com"
  gitlab_rails['smtp_port'] = 587
  gitlab_rails['smtp_user_name'] = "your_email@gmail.com"
  gitlab_rails['smtp_password'] = "your_app_password"  # 使用Gmail应用专用密码
  gitlab_rails['smtp_domain'] = "smtp.gmail.com"
  gitlab_rails['smtp_authentication'] = "login"
  gitlab_rails['smtp_enable_starttls_auto'] = true
  gitlab_rails['smtp_tls'] = false
  

  保存后重新配置GitLab使设置生效：sudo gitlab-ctl reconfigure。

六、启动GitLab服务

• 启动GitLab所有组件（包括Web服务器、数据库、SSH服务等）：
  sudo gitlab-ctl start。
• 设置开机自启（避免服务器重启后GitLab停止）：
  sudo systemctl enable gitlab-runsvdir（部分版本可能需要sudo systemctl enable gitlab）。
• 查看服务状态（确认所有组件运行正常，无红色错误）：
  sudo gitlab-ctl status。

七、访问GitLab

• 在浏览器中输入配置的external_url（如http://192.168.1.100），首次访问需设置root管理员密码（默认无密码，需强制修改）。
• 登录后即可使用GitLab，首次登录会引导创建项目、添加用户等操作。

八、常用管理命令

• 停止GitLab：sudo gitlab-ctl stop。
• 重启GitLab：sudo gitlab-ctl restart（修改配置后需重启生效）。
• 查看实时日志：sudo gitlab-ctl tail（排查问题时常用，如Web服务无法访问）。
• 备份数据：sudo gitlab-rake gitlab:backup:create（默认备份到/var/opt/gitlab/backups目录）。
• 恢复数据：sudo gitlab-rake gitlab:backup:restore BACKUP=timestamp_of_backup（需停止GitLab服务后执行）。