Linux怎么搭建GitLab

发布时间：2022-01-27 14:46:00 作者：iii
来源：亿速云阅读：212

# Linux怎么搭建GitLab

## 前言

GitLab是一个基于Git的代码托管和协作平台，提供代码仓库管理、CI/CD、问题跟踪等功能。作为开源软件，它可以部署在自有服务器上，适合企业或团队构建私有代码管理平台。本文将详细介绍在Linux系统上搭建GitLab的完整流程。

---

## 一、环境准备

### 1.1 系统要求
- **操作系统**：Ubuntu 20.04/22.04、CentOS 7/8、Debian 10/11（本文以Ubuntu 22.04为例）
- **硬件配置**：
  - 最低配置：2核CPU、4GB内存（适用于小型团队）
  - 推荐配置：4核CPU、8GB内存（支持100人以上团队）
- **存储空间**：至少10GB可用空间（实际需根据代码量调整）

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

注：安装Postfix时会弹出配置界面，选择”Internet Site”并设置域名。

二、安装GitLab

2.1 添加GitLab仓库

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

2.2 执行安装

替换EXTERNAL_URL为你的域名或服务器IP：

sudo EXTERNAL_URL="http://your-domain-or-ip" apt install gitlab-ce

安装过程会自动： 1. 配置Nginx 2. 创建数据库（使用内嵌PostgreSQL） 3. 初始化Redis缓存

2.3 防火墙配置

开放必要端口：

sudo ufw allow http
sudo ufw allow https
sudo ufw allow 22  # SSH端口

三、初始配置

3.1 首次访问

在浏览器输入http://your-domain-or-ip，将显示密码重置页面。默认用户名： - Username: root - Password: 查看初始密码（24小时有效）：

  sudo cat /etc/gitlab/initial_root_password

3.2 配置文件修改

主配置文件路径：/etc/gitlab/gitlab.rb
常用配置项示例：

external_url 'http://gitlab.example.com'  # 修改访问地址
gitlab_rails['time_zone'] = 'Asia/Shanghai'  # 时区设置
nginx['listen_port'] = 8080  # 修改监听端口

3.3 应用配置更改

每次修改配置后需执行：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

四、HTTPS配置（可选但推荐）

4.1 使用Let’s Encrypt证书

修改gitlab.rb：

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']
external_url 'https://gitlab.example.com'
nginx['redirect_http_to_https'] = true

4.2 手动证书配置

将证书文件（.crt和.key）放入/etc/gitlab/ssl/

配置Nginx：


nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.example.com.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.example.com.key"

五、日常维护

5.1 常用命令

命令	功能
`sudo gitlab-ctl start`	启动所有服务
`sudo gitlab-ctl stop`	停止所有服务
`sudo gitlab-ctl status`	查看服务状态
`sudo gitlab-rake gitlab:check`	系统健康检查

5.2 备份与恢复

创建备份：

sudo gitlab-backup create

备份文件默认存储在/var/opt/gitlab/backups/

恢复备份：

sudo gitlab-ctl stop
sudo gitlab-backup restore BACKUP=备份文件名
sudo gitlab-ctl reconfigure
sudo gitlab-ctl start

5.3 升级GitLab

备份数据

查看当前版本：


sudo cat /opt/gitlab/embedded/service/gitlab-rails/VERSION

升级到指定版本：


sudo apt update
sudo apt install gitlab-ce=15.11.0-ce.0  # 替换为目标版本

六、高级配置

6.1 邮件通知配置

修改gitlab.rb示例：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "gitlab@example.com"
gitlab_rails['smtp_password'] = "your-password"
gitlab_rails['smtp_domain'] = "example.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true

6.2 集成外部数据库

默认使用内嵌PostgreSQL，如需改用MySQL： 1. 创建MySQL数据库和用户 2. 修改配置：

   gitlab_rails['db_adapter'] = 'mysql2'
   gitlab_rails['db_host'] = 'mysql-server'
   gitlab_rails['db_database'] = 'gitlab'
   gitlab_rails['db_username'] = 'gitlab'
   gitlab_rails['db_password'] = 'password'

6.3 性能优化

增加Unicorn workers：


unicorn['worker_processes'] = 4  # 建议每核心1个worker

调整Sidekiq并发：
```
sidekiq['max_concurrency'] = 10
```

七、故障排查

7.1 常见问题

502错误：
- 检查内存是否不足（free -h）
- 查看日志：sudo gitlab-ctl tail unicorn

无法发送邮件：

测试SMTP配置：


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

备份失败：
- 确保/var/opt/gitlab/backups有写入权限
- 检查磁盘空间（df -h）

7.2 日志查看

关键日志路径： - /var/log/gitlab/nginx/ - Nginx访问日志 - /var/log/gitlab/gitlab-rails/production.log - 主应用日志 - /var/log/gitlab/sidekiq/current - 后台任务日志

结语

通过本文的步骤，您已成功在Linux服务器上部署了功能完整的GitLab实例。建议定期执行备份和更新，并参考官方文档探索更多高级功能如CI/CD流水线、容器注册表等。对于生产环境，应考虑配置高可用方案和监控系统。

附：GitLab资源占用参考（活跃用户50人） - CPU平均负载：1.2 - 内存占用：~5GB - 存储增长：约2GB/月（取决于代码库大小） “`

注：实际部署时请根据具体需求调整配置参数，并确保服务器有足够资源。如需更详细的配置说明，可参考GitLab官方文档或社区论坛。