当前位置：首页 > news >正文

GitLab之搭建（Building GitLab）

news 来源：原创 2025/9/14 10:17:46

GitLab之搭建

“ 在企业开发过程中，GitLab凭借其强大的版本管理、CI/CD集成和项目管理功能，成为许多团队的首选工具。本文将探讨GitLab的基础介绍、搭建过程、权限管理、代码审查以及团队知识管理等方面。通过详细的步骤和实用的技巧，旨在帮助读者更好地利用GitLab提升工作效率。”

GitLab简介

GitLab是利用 Ruby on Rails 一个开源的版本管理系统，实现一个自托管的Git项目仓库，可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能，能够浏览源代码，管理缺陷和注释。可以管理团队对仓库的访问，它非常易于浏览提交过的版本并提供一个文件历史库。很多公司都是基于 GitLab 进行版本管理的。

GitLab是一种基于Web的Git仓库管理工具，提供版本控制和协作开发的功能。它集成了源代码管理（SCM）、持续集成和持续交付（CI/CD）、项目管理等功能，旨在支持整个软件开发生命周期。

GitLab的主要特点：

提供Git仓库的托管，支持多用户协作，便于代码版本控制。
持续集成/持续交付（CI/CD）: 内置CI/CD功能，可以自动化构建、测试和部署流程，提高开发效率。
提供问题跟踪、看板、里程碑、标签等功能，帮助团队管理项目进度和任务。
代码审查: 支持合并请求（Merge Request）和代码审查，促进团队间的协作与代码质量保证。
安全: 提供权限管理和审计日志，确保代码的安全性和合规性。

GitLab适用于各种规模的团队，从小型开源项目到大型企业级应用开发。它的全面功能使其成为DevOps实践的重要工具。

搭建 GitLab

搭建步骤：

安装一些依赖软件。

sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates
sudo apt-get install -y postfix  
# postfix发送邮件，其它的邮件配置见：https://docs.gitlab.com/omnibus/settings/smtp.html

postfix发送邮件，其它的邮件配置见：https://docs.gitlab.com/omnibus/settings/smtp.html。

添加下载源：

 vim /etc/apt/sources.list.d/gitlab_gitlab-ee.list # 打开该文件添加：# deb https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/ubuntu xenial main

安装GitLab：

 sudo apt-get updatesudo apt-get install gitlab-ce

配置GitLab：
```
vim /etc/gitlab/gitlab.rb
# 把external_url修改成访问的IP，更复杂的配置信息可以参考
# https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
external_url 'http://192.168.2.129' 
# 开始配置
gitlab-ctl reconfigure
```
在这个过程中，可能会遇到类似下面这个问题，是因为external_url配置的url不正确。

更多的配置可以参考https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab。reconfigure成功会出现以下内容：

重启查看状态：

gitlab-ctl restart/start/status/stop     # 通过gitlab-ctl help都能查看到该信息

比如gitlab-ctl status，会显示以下信息：

启动gitlab后，访问http://192.168.2.129可能出现502错误：

此时可以使用gitlab-ctl tail来查看gitlab的服务日志，通过日志可以看到8080端口被别的进程占用了：
此时需要修改gitlab的配置信息，如下：

vim /var/opt/gitlab/gitlab-rails/etc/unicorn.rb  
# 然后把listen的8080端口改成8088，然后重启gitlab

把listen的8080端口改成8088，然后重启gitlab：

gitlab-ctl restart

如果不出什么意外，再次打开http://192.168.2.129会出现下面这个页面，这个时候需要配置root账户
的密码了：
配置账户密码成功后：

GitLab 的权限管理

3.1、用户注册

如果我们不是gitlab的用户，可以通过两种方式成为gitlab的用户：

通过这个页面去注册http://192.168.2.129/users/sign_in：
让gitlab的管理员去添加，如下图所示点击后进入管理页面，点击“New user”去添加一个用户：

3.2、创建用户组

创建用户组：

之后出现下图所示的界面：

在这个界面上，有几个点需要明白：

Visibility level：可见性，三种级别：
- Private ：这个用户组下的所有工程对该用户组可见。
- Internal ：用户组下和Internal工程对所有的用户可见。
Public ：用户组和public的工程对所有人可见。
Allowd to create projects：是否允许创建工程对于用户权限引入了角色进行管理，比如guester，Developers，Maintainers等等。
Two-factor authentication ：类似github的2F验证，就是在使用gitlab的时候必须通过2F进行验证。

3.3、为用户组添加用户

点击groups，然后点击用户组，就可以向该用户组添加用户了：

然后

3.4、为工程添加访问权限

选中工程，在左侧边栏会有一个setting选项，点击该选项的members选项：

GitLab的code review

分支合并的时候进行代码review。
对线上现有代码进行review。

不是所有人都可以去直接往Master，develop等分支去交接代码，而必须从feature，hotfix或者bug分支去merge request，经过有merge request权限的人review代码通过后，才能merge到被保护的分支。设置分支权限如下所示：