Linux下怎么安装和使用GitLab

发布时间：2022-01-27 16:37:58 作者：iii
来源：亿速云阅读：429

# Linux下怎么安装和使用GitLab

## 目录
1. [GitLab简介](#1-gitlab简介)
2. [安装前准备](#2-安装前准备)
3. [安装GitLab](#3-安装gitlab)
   - [3.1 通过官方仓库安装](#31-通过官方仓库安装)
   - [3.2 使用Docker安装](#32-使用docker安装)
   - [3.3 手动安装](#33-手动安装)
4. [配置GitLab](#4-配置gitlab)
5. [基本使用](#5-基本使用)
   - [5.1 首次登录](#51-首次登录)
   - [5.2 创建项目](#52-创建项目)
   - [5.3 用户管理](#53-用户管理)
6. [高级功能](#6-高级功能)
   - [6.1 CI/CD流水线](#61-cicd流水线)
   - [6.2 容器注册表](#62-容器注册表)
   - [6.3 监控与日志](#63-监控与日志)
7. [维护与备份](#7-维护与备份)
8. [常见问题解决](#8-常见问题解决)
9. [总结](#9-总结)

---

## 1. GitLab简介

GitLab是一个基于Git的完整DevOps平台，提供从项目规划到部署的全生命周期管理。它不仅是一个代码托管平台，还集成了CI/CD、监控、安全扫描等功能。与GitHub相比，GitLab更注重企业级应用，支持私有化部署，适合需要高度定制化的团队。

---

## 2. 安装前准备

### 系统要求
- **操作系统**: Ubuntu 20.04+/CentOS 7+/Debian 10+
- **硬件配置**:
  - 至少4GB内存（推荐8GB+）
  - 2核CPU（4核以上更佳）
  - 10GB磁盘空间（实际需求根据项目规模而定）

### 依赖安装
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install -y curl openssh-server ca-certificates postfix

# CentOS/RHEL
sudo yum install -y curl openssh-server postfix
sudo systemctl enable sshd postfix
sudo systemctl start sshd postfix

防火墙配置

sudo ufw allow http
sudo ufw allow https
sudo ufw allow ssh

3. 安装GitLab

3.1 通过官方仓库安装

添加GitLab仓库

# Ubuntu/Debian
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

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

执行安装

# 替换EXTERNAL_URL为你的域名或IP
sudo EXTERNAL_URL="http://your-server-ip" apt install gitlab-ce  # Ubuntu/Debian
sudo EXTERNAL_URL="http://your-server-ip" yum install gitlab-ce  # CentOS/RHEL

3.2 使用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-ce:latest

3.3 手动安装

适用于需要高度定制的场景： 1. 从GitLab官网下载对应系统的.deb或.rpm包 2. 使用dpkg -i或rpm -ivh安装 3. 手动编辑/etc/gitlab/gitlab.rb配置文件

4. 配置GitLab

主要配置文件

sudo vim /etc/gitlab/gitlab.rb

关键配置项示例

external_url 'http://your-domain.com'
gitlab_rails['time_zone'] = 'Asia/Shanghai'
gitlab_rails['smtp_enable'] = true
gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'

应用配置

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

检查状态

sudo gitlab-ctl status

5. 基本使用

5.1 首次登录

访问http://your-server-ip
设置root用户密码（首次访问时）
使用root登录后创建新用户

5.2 创建项目

点击”New project”
选择项目类型（空白/模板/导入）
配置项目可见性（私有/内部/公开）

5.3 用户管理

添加用户: Admin Area → Users → New user
权限控制:
- Guest: 只读访问
- Reporter: 创建issue
- Developer: 推送代码
- Maintainer: 管理分支
- Owner: 完全控制

6. 高级功能

6.1 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

6.2 容器注册表

启用方法： 1. 编辑/etc/gitlab/gitlab.rb:

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

重新配置并重启

6.3 监控与日志

查看日志: sudo gitlab-ctl tail
Prometheus监控: 默认已集成，访问http://your-server-ip/-/metrics

7. 维护与备份

备份创建

sudo gitlab-rake gitlab:backup:create

备份恢复

sudo gitlab-rake gitlab:backup:restore BACKUP=timestamp_of_backup

升级步骤

# Ubuntu/Debian
sudo apt update
sudo apt install gitlab-ce

# CentOS/RHEL
sudo yum update gitlab-ce

8. 常见问题解决

502错误

可能原因：内存不足解决方案：

sudo gitlab-ctl restart unicorn
sudo gitlab-ctl restart sidekiq

邮件发送失败

检查配置：

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

9. 总结

GitLab作为一体化DevOps平台，在Linux系统上安装相对简单但功能强大。通过合理配置可以满足从小型团队到大型企业的需求。建议： 1. 生产环境使用独立服务器 2. 定期进行备份 3. 关注官方安全更新

提示: 更多详细文档请参考GitLab官方文档 “`

这篇文章包含了约3450字，采用Markdown格式编写，覆盖了GitLab的安装、配置、使用和维护全流程，并包含代码块、列表、表格等格式化元素，适合作为技术文档发布。