Linux系统中如何安装GitLab

发布时间：2022-01-24 11:59:10 作者：小新
来源：亿速云阅读：258

# Linux系统中如何安装GitLab

## 前言

GitLab 是一个基于Git的代码托管和协作平台，提供项目管理、代码审查、CI/CD等功能。本文将详细介绍在Linux系统上安装GitLab的完整流程，涵盖环境准备、安装配置及基础使用。

---

## 一、环境准备

### 1. 系统要求
- **操作系统**: Ubuntu 20.04/22.04, CentOS 7/8, Debian 10/11（本文以Ubuntu 22.04为例）
- **硬件配置**:
  - 至少4GB内存（推荐8GB）
  - 2核CPU
  - 10GB磁盘空间（实际需求根据仓库大小调整）
- **网络**: 开放HTTP/HTTPS端口（80/443）

### 2. 依赖安装
确保系统已安装基础工具：
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl openssh-server ca-certificates postfix

（注：Postfix用于邮件通知，安装时选择“Internet Site”配置）

二、安装GitLab

1. 添加GitLab官方仓库

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

2. 安装GitLab社区版

sudo apt install gitlab-ce

（企业版需替换为gitlab-ee并配置许可证）

3. 配置GitLab域名

编辑配置文件/etc/gitlab/gitlab.rb：

external_url 'http://your_domain_or_ip'  # 替换为实际域名或IP

保存后执行：

sudo gitlab-ctl reconfigure  # 应用配置（耗时约5-10分钟）

三、防火墙与安全配置

1. 开放防火墙端口

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

2. 配置HTTPS（可选）

若需启用HTTPS，修改external_url为https://并添加证书路径：

nginx['ssl_certificate'] = "/path/to/cert.pem"
nginx['ssl_certificate_key'] = "/path/to/key.pem"

四、访问与初始化

1. 获取初始密码

首次安装后，密码存储在：

sudo cat /etc/gitlab/initial_root_password

2. 登录Web界面

浏览器访问http://your_domain_or_ip，使用用户名root和上述密码登录。

3. 修改密码（强制操作）

首次登录后需立即修改root密码。

五、基础功能配置

1. 邮件通知

编辑/etc/gitlab/gitlab.rb：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "user@example.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['gitlab_email_from'] = "gitlab@example.com"

重新配置：

sudo gitlab-ctl reconfigure

2. 备份设置

手动备份：

sudo gitlab-backup create

自动备份（通过Crontab）：

0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create

六、维护与升级

1. 常用命令

sudo gitlab-ctl start      # 启动
sudo gitlab-ctl stop       # 停止
sudo gitlab-ctl restart    # 重启
sudo gitlab-ctl status     # 查看状态

2. 版本升级

sudo apt update
sudo apt install gitlab-ce
sudo gitlab-ctl reconfigure

七、常见问题解决

1. 502错误

可能原因：内存不足。检查日志：

sudo gitlab-ctl tail nginx

解决方案：增加Swap空间或升级服务器配置。

2. 无法发送邮件

测试SMTP配置：

sudo gitlab-rails console
Notify.test_email('test@example.com', 'Test', 'Body').deliver_now

结语

通过以上步骤，您已成功在Linux系统上部署GitLab。建议定期备份数据并关注官方文档获取更新。如需更复杂的功能（如Kubernetes集成或高可用部署），可进一步探索GitLab的高级配置选项。

提示: 生产环境建议使用独立数据库（如PostgreSQL）和对象存储（如S3）以提高性能。 “`

（全文约1300字，实际字数可能因Markdown渲染略有差异）