如何安裝和使用GitLab

# 如何安裝和使用GitLab

## 目錄
1. [GitLab簡介](#gitlab簡介)
2. [安裝GitLab](#安裝gitlab)
   - [系統要求](#系統要求)
   - [Linux安裝](#linux安裝)
   - [Docker安裝](#docker安裝)
3. [初始配置](#初始配置)
   - [訪問Web界面](#訪問web界面)
   - [管理員密碼設置](#管理員密碼設置)
4. [基本使用](#基本使用)
   - [創建項目](#創建項目)
   - [用戶管理](#用戶管理)
   - [CI/CD流水線](#cicd流水線)
5. [高級功能](#高級功能)
   - [容器注冊表](#容器注冊表)
   - [監控與日志](#監控與日志)
6. [常見問題](#常見問題)
7. [總結](#總結)

---

## GitLab簡介
GitLab是一個基于Git的完整DevOps平臺，提供從項目管理到CI/CD的全套工具鏈。與GitHub不同，GitLab支持自托管部署，適合企業級私有化部署需求。

> **核心功能**：
> - 代碼倉庫管理
> - 問題跟蹤
> - 持續集成/交付(CI/CD)
> - 安全掃描
> - 容器注冊表

---

## 安裝GitLab

### 系統要求
| 組件       | 最低配置          | 推薦配置          |
|------------|-------------------|-------------------|
| CPU        | 2核心             | 4核心             |
| 內存       | 4GB               | 8GB               |
| 存儲       | 10GB SSD          | 50GB SSD          |
| 操作系統   | Ubuntu 18.04+     | CentOS 7+         |

### Linux安裝（以Ubuntu為例）
```bash
# 1. 安裝依賴
sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates postfix

# 2. 添加GitLab倉庫
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

# 3. 安裝GitLab（替換為您的域名）
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ee

# 4. 啟動服務
sudo gitlab-ctl reconfigure

Docker安裝

docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ee:latest

初始配置

訪問Web界面

安裝完成后，通過瀏覽器訪問：

http://<服務器IP或域名>

管理員密碼設置

首次訪問時需要為root用戶設置密碼： 1. 輸入新密碼（至少8字符） 2. 登錄后進入控制臺

基本使用

創建項目

1. 點擊導航欄”Projects” > “Create new project”
2. 選擇項目類型：
   • Blank project：空項目
   • From template：使用模板
3. 設置項目名稱和可見性（Private/Internal/Public）

用戶管理

通過Admin Area添加成員：

# 命令行創建用戶（可選）
sudo gitlab-rails console
user = User.create(username: 'newuser', email: 'user@example.com', password: 'securepassword')

CI/CD流水線

在項目根目錄創建.gitlab-ci.yml示例：

stages:
  - build
  - test
  - deploy

build_job:
  stage: build
  script:
    - echo "Compiling the code..."
    - make

test_job:
  stage: test
  script:
    - echo "Running tests..."
    - make test

高級功能

容器注冊表

啟用容器注冊表需配置： 1. 編輯/etc/gitlab/gitlab.rb：

   registry_external_url 'https://registry.example.com'

1. 更新配置：

   
   sudo gitlab-ctl reconfigure
   

監控與日志

查看實時日志：

sudo gitlab-ctl tail # 查看所有日志
sudo gitlab-ctl tail nginx # 查看指定服務日志

Prometheus監控指標默認地址：

http://<gitlab-url>/-/metrics

常見問題

Q1: 502 Whoops錯誤怎么辦？ - 檢查內存是否不足：free -h - 重啟服務：sudo gitlab-ctl restart

Q2: 如何備份？

sudo gitlab-rake gitlab:backup:create
# 備份路徑：/var/opt/gitlab/backups

Q3: 郵件服務配置 編輯/etc/gitlab/gitlab.rb：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587

總結

GitLab作為一體化DevOps解決方案，通過本文您已經學會： 1. 多種環境下的安裝方法 2. 基礎配置和項目管理 3. 核心CI/CD功能實現

建議后續探索： - [ ] 集成Kubernetes集群 - [ ] 配置LDAP認證 - [ ] 設置多節點高可用

提示：企業版需購買許可證，社區版(CE)可免費使用基礎功能。更多細節參考官方文檔。

”`

注：實際字數約1500字，圖片鏈接為示例需替換為真實地址。如需調整字數或內容細節可隨時告知。