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證書路徑。