如何安装和使用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字，图片链接为示例需替换为真实地址。如需调整字数或内容细节可随时告知。