CentOS中GitLab配置步骤

CentOS中GitLab配置步骤

1. 安装前准备

• 更新系统：确保系统软件包为最新版本，避免兼容性问题。

  sudo yum update -y
  

• 安装必要依赖：GitLab运行需依赖SSH、防火墙、邮件服务等组件，安装以下包：

  sudo yum install -y curl policycoreutils-python-utils openssh-server postfix cronie
  

2. 配置基础服务

• 启动SSH服务：GitLab依赖SSH进行代码托管和远程操作，设置开机自启并立即启动。

  sudo systemctl enable sshd
  sudo systemctl start sshd
  

• 配置防火墙：允许HTTP（80）和HTTPS（443）流量通过，确保Web界面可访问。

  sudo firewall-cmd --permanent --add-service=http
  sudo firewall-cmd --permanent --add-service=https
  sudo firewall-cmd --reload
  

3. 添加GitLab官方仓库

• 导入GitLab镜像源：使用官方脚本添加GitLab的YUM仓库，确保后续能获取最新版本。

  curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
  

4. 安装GitLab社区版（CE）

• 安装GitLab：通过YUM命令从官方仓库安装GitLab CE（社区版），EXTERNAL_URL需替换为服务器IP或域名（如http://192.168.1.100）。

  sudo EXTERNAL_URL="http://your_server_ip" yum install -y gitlab-ce
  

5. 配置GitLab

• 修改配置文件：编辑/etc/gitlab/gitlab.rb，调整以下关键参数：
  • 设置外部访问URL：替换为服务器实际地址，确保用户可通过浏览器访问。

    external_url 'http://your_server_ip'
    

  • 配置邮件服务（可选）：若需使用邮件通知（如密码重置、合并请求提醒），需添加SMTP配置（以QQ邮箱为例）：

    gitlab_rails['smtp_enable'] = true
    gitlab_rails['smtp_address'] = "smtp.qq.com"
    gitlab_rails['smtp_port'] = 587
    gitlab_rails['smtp_user_name'] = "your_email@qq.com"  # 发件邮箱
    gitlab_rails['smtp_password'] = "your_authorization_code"  # 邮箱授权码（非登录密码）
    gitlab_rails['smtp_authentication'] = "login"
    gitlab_rails['smtp_enable_starttls_auto'] = true
    gitlab_rails['smtp_tls'] = false
    gitlab_rails['gitlab_email_from'] = 'your_email@qq.com'  # 发件人地址
    

  • 保存并退出：按Esc键输入:wq保存文件。

6. 应用配置并启动服务

• 重新配置GitLab：执行以下命令使配置生效，此步骤会自动初始化数据库、生成密钥等。

  sudo gitlab-ctl reconfigure
  

• 重启GitLab服务：确保所有服务（Nginx、PostgreSQL、Redis等）正常运行。

  sudo gitlab-ctl restart
  

• 设置开机自启：避免服务器重启后GitLab停止服务。

  sudo systemctl enable gitlab
  

7. 访问GitLab

• 打开Web界面：在浏览器中输入配置的external_url（如http://your_server_ip），进入GitLab登录页面。
• 首次登录设置：默认管理员账号为root，首次登录需通过邮件或控制台查看初始密码（可通过cat /etc/gitlab/initial_root_password查看，仅首次有效）。

8. 可选优化配置

• 关闭注册功能：若需限制用户自行注册，仅管理员创建账号，可进入GitLab后台（http://your_server_ip/admin/application_settings/general），关闭“已启用注册功能”。
• 修改默认端口：若服务器80端口被占用，可在/etc/gitlab/gitlab.rb中修改nginx['listen_port']（如改为8080），然后重新配置并重启服务。
• 配置HTTPS：为提升安全性，可申请SSL证书（如Let’s Encrypt），并在external_url中指定https://，同时在Nginx配置中添加SSL证书路径。