GitLab (v16.x) 简述及安装部署

GitLab 介绍

GitLab 的历史

• GitLab 最初是一个完全免费的开源软件，根据 MIT 许可证分发。2013 年 7 月，它被分为两个不同的版本 - GitLab CE（社区版）和 GitLab EE（企业版）。GitLab EE 处于受限许可证下，但源代码仍然公开可见，而 GitLab CE 许可模型保持不变。2017 年，GitLab 宣布他们的代码将在 MIT 许可证下完全开源。

为什么使用 GitLab？

• GitLab是在集中式服务器上管理git仓库的好方法。GitLab让你完全控制你的仓库或项目，并允许你免费决定它们是公开还是私有的。

• 使用 GitLab 的主要好处是它允许所有团队成员在项目的每个阶段进行协作。GitLab 提供从规划到创建的跟踪，帮助开发人员自动化整个 DevOps 生命周期并实现最佳结果。越来越多的开发人员开始使用 GitLab，因为它具有广泛的功能和可用的代码块。

Git，GitHub 与 GitLab 的区别

• Git是一种版本控制系统，是一种工具，用于跟踪修改和从远程资源推送或拉取代码的版本控制。

• GitHub是一个目前全球最大的基于Git实现的在线代码仓库托管平台，是一个公开的、免费的服务，它要求所有的代码（除非你有一个付费账户）都是公开的。任何人都可以看到你推送到GitHub的代码，并提供改进建议。

• GitLab是一个基于Git实现的在线代码仓库软件，你可以用GitLab自己搭建一个类似于GitHub一样的仓库，但是GitLab有完善的管理界面和权限控制，一般用于在企业、学校等内部网络搭建Git私服。

• GitHub和GiLlab两个都是基于Web的Git远程仓库，它们都提供了分享开源项目的平台，为开发团队提供了存储、分享、发布和合作开发项目的中心化云存储的场所。从代码的私有性上来看，GitLab 是一个更好的选择。但是对于开源项目而言，GitHub 依然是代码托管的首选。

特点

• GitLab免费托管您的（私有）软件项目。

• GitLab是一个管理 Git 仓库的平台。

• GitLab提供免费的公共和私有仓库、问题跟踪和维基。

• GitLab是一个建立在Git之上的用户友好的网络界面层，它提高了使用Git的速度。

• GitLab提供了自己的 持续集成 （CI）系统来管理项目，并提供用户界面和GitLab的其他功能。

优势

• GitLab提供了 GitLab社区版 ，用户可以定位他们的代码在哪个服务器上。

• GitLab免费提供无限数量的私有和公共仓库。

• Snippet 部分可以分享一个项目中的少量代码，而不是分享整个项目。

缺点

• 在推送和提取仓库时，它没有GitHub快。

• GitLab的界面在从一个页面切换到另一个页面时需要时间。

先决条件

建议使用至少具有以下各项的服务器：

• CPU 4 核是建议的最小核心数，最多支持500个用户。
• 内存 4 GB RAM 是所需的最小内存大小，最多支持500个用户。

GitLab 还要求文件系统准备好用于存储 Git 仓库和各种其它文件。

请注意，如果您使用 NFS（网络文件系统），文件将通过网络传输，根据实现，该网络需要打开端口 111 和 2049

GitLab 架构图

Gitlab组件：

• repository：代码库，可以是硬盘或 分布式文件系统。

• Nginx：Web 入口。

• gitlab-workhorse：轻量级反向代理服务器，可以处理一些大的HTTP请求（磁盘上的 CSS、JS 文件、文件上传下载等），处理 Git Push/Pull 请求，处理到Rails 的连接会反向代理给后端的unicorn（修改由 Rails 发送的响应或发送给 Rails 的请求，管理 Rails 的长期 WebSocket 连接等）。

• gitlab-shell：用于 SSH 交互，而不是 HTTP。gitlab-shell 通过 Redis 与 Sidekiq 进行通信，并直接或通过 TCP 间接访问 Unicorn。用于处理Git命令和修改authorized keys列表。

• Unicorn：Gitlab 自身的 Web 服务器(Ruby Web Server)，包含了 Gitlab 主进程，负责处理快速/一般任务，与 Redis 一起工作，配置参考：CPU核心数 + 1 = unicorn workers数量。工作内容包括：

  • 通过检查存储在 Redis 中的用户会话来检查权限。

  • 为 Sidekiq 制作任务。

  • 从仓库（warehouse）取东西或在那里移动东西。

• Redis：缓存每个客户端的sessions和后台队列，负责分发任务。Redis需求的存储空间很小，大约每个用户25KB。

• Gitaly：后台服务，专门负责访问磁盘以高效处理 gitlab-shell 和 gitlab-workhorse 的git 操作，并缓存耗时操作。所有的 git 操作都通过 Gitaly 处理，并向 GitLab web 应用程序提供一个 API，以从 git（例如 title, branches, tags, other meta data）获取属性，并获取 blob（例如 diffs，commits，files）。

• Sidekiq：后台核心服务，可以从redis队列中提取作业并对其进行处理。后台作业允许GitLab通过将工作移至后台来提供更快的请求/响应周期。Sidekiq任务需要来自Redis。

• 数据库（PostgreSQL/MySQL）：包含以下信息：

  • repository 中的数据（元数据，issue，合并请求 merge request 等）。

  • 可以登录 Web 的用户（权限）。

• mail_room：处理邮件请求。回复 GitLab 发出的邮件时，GitLab 会调用此服务处理Sidekiq、Unicorn 和 GitLab-shell 的任务 。

• logrotate：日志文件管理，切割。

组件操作命令

# nginx
gitlab-ctl start|stop|restart|status nginx

# unicorn
gitlab-ctl start|stop|restart|status unicorn

# sidekiq
gitlab-ctl start|stop|restart|status sidekiq

# postgresql
gitlab-ctl start|stop|restart|status postgresql

# redis
gitlab-ctl start|stop|restart|status redis

# gitlab
gitlab-ctl start|stop|restart|status|reconfigure

# supervisor
systemctl start|stop|restart|status gitlab-runsvdir.service

GitLab部署过程

准备环境

[root@GitServer ~]# cat /etc/redhat-release
CentOS Linux release 7.9.2009 (Core)
[root@GitServer ~]# uname -r
3.10.0-1160.el7.x86_64

[root@GitServer ~]# setenforce 0
[root@GitServer ~]# sed -i.bak '7s/enforcing/disabled/' /etc/selinux/config

[root@GitServer ~]# systemctl stop firewalld
[root@GitServer ~]# systemctl status firewalld
● firewalld.service - firewalld - dynamic firewall daemon
   Loaded: loaded (/usr/lib/systemd/system/firewalld.service; disabled; vendor preset: enabled)
   Active: inactive (dead)
     Docs: man:firewalld(1)
[root@GitServer ~]# firewall-cmd --state
not running

安装

• GitLab 官方
• 清华大学开源软件镜像站

[root@GitLabServer ~]# yum install -y curl policycoreutils-python openssh-server perl postfix wget
[root@GitLabServer ~]# wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-16.4.2-ce.0.el7.x86_64.rpm
[root@GitLabServer ~]# yum localinstall gitlab-ce-16.4.2-ce.0.el7.x86_64.rpm
It looks like GitLab has not been configured yet; skipping the upgrade script.

       *.                  *.
      ***                 ***
     *****               *****
    .******             *******
    ********            ********
   ,,,,,,,,,***********,,,,,,,,,
  ,,,,,,,,,,,*********,,,,,,,,,,,
  .,,,,,,,,,,,*******,,,,,,,,,,,,
      ,,,,,,,,,*****,,,,,,,,,.
         ,,,,,,,****,,,,,,
            .,,,***,,,,
                ,*,.

     _______ __  __          __
    / ____(_) /_/ /   ____ _/ /_
   / / __/ / __/ /   / __ `/ __ \
  / /_/ / / /_/ /___/ /_/ / /_/ /
  \____/_/\__/_____/\__,_/_.___/

Thank you for installing GitLab!
GitLab was unable to detect a valid hostname for your instance.
Please configure a URL for your GitLab instance by setting `external_url`
configuration in /etc/gitlab/gitlab.rb file.    # 注意：设置external_url
Then, you can start your GitLab instance by running the following command:
  sudo gitlab-ctl reconfigure    # 注意：执行重载配置

For a comprehensive list of configuration options please see the Omnibus GitLab readme
https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md

Help us improve the installation experience, let us know how we did with a 1 minute survey:
https://gitlab.fra1.qualtrics.com/jfe/form/SV_6kVqZANThUQ1bZb?installation=omnibus&release=16-0

  Verifying  : gitlab-ce-16.4.2-ce.0.el7.x86_64                                                                                                                                1/1

Installed:
  gitlab-ce.x86_64 0:16.4.2-ce.0.el7

Complete!

修改GitLab配置

[root@GitLabServer ~]# hostname -I
172.16.70.191

[root@GitLabServer ~]# cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb_bak
[root@GitLabServer ~]# diff /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb_bak
32c32
# 例如1：external_url 'http://IP'            # 默认端口80
# 例如2：external_url 'http://IP:PORT'
< external_url 'http://172.16.70.191:91'    # 修改此行内容, 设置为本机IP:PORT
---
> external_url 'http://gitlab.example.com'

# 重载配置
[root@GitLabServer ~]# gitlab-ctl reconfigure

可选设置

# 启动ssh服务&设置为开机启动
systemctl enable sshd && sudo systemctl start sshd

# 设置postfix开机自启，并启动，postfix支持gitlab发信功能
systemctl enable postfix && systemctl start postfix

# 如系统防火墙是开启状态，则需设置允许策略
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --zone=public --add-port=PORT/tcp --permanent

systemctl reload firewalld

查看GitLab版本信息

[root@GitLabServer ~]# gitlab-rake gitlab:env:info
System information
System:
Current User:	git
Using RVM:	no
Ruby Version:	3.0.6p216
Gem Version:	3.4.19
Bundler Version:2.4.19
Rake Version:	13.0.6
Redis Version:	7.0.13
Sidekiq Version:6.5.7
Go Version:	unknown

GitLab information
Version:	16.4.2
Revision:	67c88353b76
Directory:	/opt/gitlab/embedded/service/gitlab-rails
DB Adapter:	PostgreSQL
DB Version:	13.11
URL:		http://172.16.70.191:91
HTTP Clone URL:	http://172.16.70.191:91/some-group/some-project.git
SSH Clone URL:	git@172.16.70.191:some-group/some-project.git
Using LDAP:	no
Using Omniauth:	yes
Omniauth Providers:

GitLab Shell
Version:	14.28.0
Repository storages:
- default: 	unix:/var/opt/gitlab/gitaly/gitaly.socket
GitLab Shell path:		/opt/gitlab/embedded/service/gitlab-shell

Gitaly
- default Address: 	unix:/var/opt/gitlab/gitaly/gitaly.socket
- default Version: 	16.4.2
- default Git Version: 	2.42.0

Gitlab目录结构

/opt/gitlab/ 　　                  # 主目录
/etc/gitlab/ 　　                  # 放置配置文件
/var/opt/gitlab/ 　　              # 各个组件
/var/log/gitlab/ 　　              # 放置日志文件
/var/opt/gitlab/git-data/repositories 　　 # 数据库的地址　　
/var/opt/gitlab/postgresql/data 　　       # gitlab组和项目的地址
/etc/gitlab/gitlab.rb                      # gitlab配置文件

端口信息

[root@GitLabServer ~]# netstat -ntpl
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address           Foreign Address         State       PID/Program name
tcp        0      0 127.0.0.1:9229          0.0.0.0:*               LISTEN      2637/gitlab-workhor
tcp        0      0 127.0.0.1:9168          0.0.0.0:*               LISTEN      2653/ruby
tcp        0      0 127.0.0.1:8080          0.0.0.0:*               LISTEN      2222/puma 6.3.1 (un
tcp        0      0 0.0.0.0:91              0.0.0.0:*               LISTEN      2330/nginx: master    # 对应前面设置external_url PORT
tcp        0      0 127.0.0.1:8082          0.0.0.0:*               LISTEN      2252/sidekiq_export
tcp        0      0 127.0.0.1:9236          0.0.0.0:*               LISTEN      2599/gitaly
tcp        0      0 127.0.0.1:8150          0.0.0.0:*               LISTEN      2626/gitlab-kas
tcp        0      0 0.0.0.0:22              0.0.0.0:*               LISTEN      1270/sshd
tcp        0      0 127.0.0.1:8151          0.0.0.0:*               LISTEN      2626/gitlab-kas
tcp        0      0 127.0.0.1:8153          0.0.0.0:*               LISTEN      2626/gitlab-kas
tcp        0      0 127.0.0.1:25            0.0.0.0:*               LISTEN      875/master
tcp        0      0 127.0.0.1:8154          0.0.0.0:*               LISTEN      2626/gitlab-kas
tcp        0      0 127.0.0.1:8155          0.0.0.0:*               LISTEN      2626/gitlab-kas
tcp        0      0 127.0.0.1:8092          0.0.0.0:*               LISTEN      2250/sidekiq 6.5.7
tcp        0      0 0.0.0.0:8060            0.0.0.0:*               LISTEN      2330/nginx: master
tcp        0      0 127.0.0.1:9121          0.0.0.0:*               LISTEN      2655/redis_exporter
tcp        0      0 127.0.0.1:9090          0.0.0.0:*               LISTEN      2662/prometheus
tcp        0      0 127.0.0.1:9187          0.0.0.0:*               LISTEN      2688/postgres_expor
tcp        0      0 127.0.0.1:9093          0.0.0.0:*               LISTEN      2678/alertmanager
tcp        0      0 127.0.0.1:9100          0.0.0.0:*               LISTEN      2647/node_exporter
tcp6       0      0 ::1:9168                :::*                    LISTEN      2653/ruby
tcp6       0      0 :::22                   :::*                    LISTEN      1270/sshd
tcp6       0      0 ::1:25                  :::*                    LISTEN      875/master
tcp6       0      0 :::9094                 :::*                    LISTEN      2678/alertmanager

GitLab 密码

获取初始登录密码，默认登录账号:root

设置初始密码：GitLab 14.0 开始引入。

默认情况下，Linux 软件包安装会自动为初始管理员用户账号 (root) 生成密码，并将其存储到 /etc/gitlab/initial_root_password 至少 24 小时。出于安全原因，24 小时后，此文件会被第一次 gitlab-ctl reconfigure 自动删除。

[root@GitLabServer ~]# grep Password: /etc/gitlab/initial_root_password
Password: JPbE/qElViuH3O1REgsnA+9hB669393vA0f19NAe8RY=

设置简体中文

其他设置

禁用注册

默认情况下，任何访问您的极狐GitLab 域名的用户都可以注册一个账户。对于运行面向公众的极狐GitLab 实例的客户，如果您不希望公众用户注册账户，我们强烈建议您考虑禁用新注册。

要禁用注册：
在左侧边栏中，选择 搜索或转到。
选择 管理中心。
选择 设置 > 通用。
展开 注册限制。
清除 已启用注册功能 复选框，然后选择 保存修改。

重置/修改root密码

使用Rake任务：GitLab 13.9 开始引入。

密码长度设置为最少8个字符，且必须符合复杂性要求。

[root@GitLabServer ~]# gitlab-rake "gitlab:password:reset[root]"
Enter password:    # 输入新密码
Confirm password:  # 再次输入
Password successfully updated for user with username root.

防止新用户创建顶级群组

# 编辑 /etc/gitlab/gitlab.rb 并添加以下行：
gitlab_rails['gitlab_default_can_create_group'] = false

gitlab-ctl reconfigure
gitlab-ctl restart

防止用户更改其用户名

默认情况下，新用户可以更改他们的用户名。要禁用您的用户更改其用户名的能力：

编辑 /etc/gitlab/gitlab.rb 并添加以下行：
gitlab_rails['gitlab_username_changing_enabled'] = false

gitlab-ctl reconfigure
gitlab-ctl restart