一、GitLab简介

GitLab 社区版（Community Edition，简称 CE）是 GitLab 提供的免费开源版本。与企业版（Enterprise Edition，简称 EE）相比，社区版主要针对个人和小型团队，提供核心的代码仓库管理、代码审查、持续集成/持续部署（CI/CD）等功能。

1、主要特点

1. 版本控制：基于 Git，提供强大的版本控制功能。
2. 代码审查：支持合并请求（Merge Request），以及代码审查功能。
3. 持续集成和持续部署（CI/CD）：内置 GitLab CI/CD，无需额外服务。
4. 项目管理：提供问题追踪（Issue Tracking）、看板等项目管理工具。
5. 文档管理：支持 Wiki，以及其他文档管理功能。
6. 开放源代码：社区版是完全开源的，可以自由地进行定制和二次开发。

2、安装

GitLab CE 可以在 Linux 上通过多种方式安装，包括使用包管理器，Docker 容器，或者从源代码编译。

A. 使用包管理器（Ubuntu）

bash
sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo yum install -y gitlab-ce

B. Linux部署 (此处先省略，后面着重介绍部署步骤)

C. 使用 Docker (需要内存 4GB+)

• 注意端口是否已被占用

bash
docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 2322: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. 重置容器的 root 密码

完整的操作步骤如下：

A. 进入正在运行的 GitLab 容器:

运行以下命令以进入正在运行的 GitLab 容器：

bash
docker exec -it gitlab /bin/bash

B. 在容器内重置 root 密码:

在容器内执行以下命令来重置 root 密码：

bash
gitlab-rake gitlab:password:reset

它会要求你输入新的密码。输入后，系统会打印出新密码。

C. 使用新密码登录 GitLab

使用这个新密码登录 GitLab 网页端。之后，你可以在个人设置中再次修改密码。

通过这种方式，你可以安全地为 GitLab 实例设置一个新的 root 密码，而不需要查看日志。这是官方推荐的密码重置流程。

3、适用场景

1. 小型到中型项目：对于小型到中型的开发项目，社区版通常已足够。
2. 教育和个人用途：社区版是学习 DevOps 和 Git 的好选择。
3. 开源项目：社区版支持公开项目，适用于开源社群。

4、集成到 IT 环境

对于一个以 Java 和企业级微服务架构为基础的项目，GitLab 社区版可以提供代码版本管理，以及 CI/CD 流程。这样，每当有代码更改时，GitLab 可以自动触发构建和测试任务，确保代码质量。此外，通过 API 或 Webhook，GitLab 还可以与其他 IT 系统（如 Jira、Kubernetes 等）进行集成，形成一个完整的 DevOps 工作流。

解决方案设计、物理网络蓝图、系统集成接口定义和部署环境蓝图等都可以基于 GitLab 的各种功能来进行详细规划和实施。

二、部署步骤介绍

在Linux上部署GitLab，不采用Docker的方式，通常是通过下载和安装包来完成。以下是具体的步骤：

1. 系统准备

• 确保你的系统满足GitLab的硬件要求（4G），并且系统是最新更新的。

2. 安装必要的依赖

• 安装Postfix以发送通知邮件（或者你可以稍后配置其他的SMTP服务）。

  bash
  sudo yum install -y postfix
  

3. 添加GitLab包仓库

• 下载并安装GitLab的仓库设置包：

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

4. 安装GitLab

• 通过包管理器安装GitLab包：

  bash
  sudo yum install -y gitlab-ce
  

5. 配置GitLab

• 编辑/etc/gitlab/gitlab.rb文件来配置GitLab，例如设置外部URL等。

  bash
  vim /etc/gitlab/gitlab.rb
  # 修改external_url 'https://gitlab.example.com'
  # 查找：/external_url
  

• 配置SMTP (可选):
  • 如果您想通过SMTP服务器发送邮件，您需要配置SMTP设置。下面是一个示例配置：

  bash
     gitlab_rails['smtp_address'] = "smtp.qq.com"
     gitlab_rails['smtp_port'] = 587
     gitlab_rails['smtp_user_name'] = "xxxxxxxxx@qq.com"  # 用你的QQ邮箱地址替换
     gitlab_rails['smtp_password'] = "brxl*******gfha"  # 用你的SMTP授权码替换
     gitlab_rails['smtp_domain'] = "qq.com"
     gitlab_rails['smtp_authentication'] = "login"
     gitlab_rails['smtp_enable_starttls_auto'] = true
     gitlab_rails['gitlab_email_from'] = 'xxxxxxxxx@qq.com'  # 用你的QQ邮箱地址替换
  

6. 重新配置GitLab

• 运行下面的命令应用你的配置更改：

  bash
  sudo gitlab-ctl reconfigure
  

7. 访问和配置你的GitLab实例

从您提供的输出中，看起来GitLab已成功配置，并且默认的管理员账户（用户名：**root**）已被创建。但是，出于安全考虑，系统没有在标准输出（STDOUT）中显示初始的root密码。相反，它已将初始密码存储在`/etc/gitlab/initial_root_password`文件中。这个文件会在24小时后的第一次重新配置运行时被清理。

下面是如何获取初始root密码和登录到GitLab的步骤：

• 获取初始root密码:
  • 使用以下命令查看/etc/gitlab/initial_root_password文件中的密码：

    bash
    sudo cat /etc/gitlab/initial_root_password
    

• 登录到GitLab:
  • 在Web浏览器中打开您的GitLab实例的URL。
  • 如果是做了Nginx Proxy Manager管理的话，需要指定一下IP:port
  • 在登录页面上，使用用户名root和刚刚获取的密码登录。

• 重置root密码 (强烈推荐):

  • 出于安全考虑，强烈建议您在登录后立即重置root密码。您可以按照GitLab的重置密码文档中的指示进行操作。

• 清理初始密码文件 (可选):

  • 如果您已成功登录并重置了root密码，您可以选择手动删除/etc/gitlab/initial_root_password文件，以确保不会保留任何敏感信息：

    bash
    sudo rm /etc/gitlab/initial_root_password
    

通过这些步骤，应该能够获取初始的root密码，登录到您的GitLab实例，并重置root密码以增加安全性。

8. 创建备份策略

• 配置定期备份，以保护你的数据。

9. 设置监控和报警

• 考虑设置监控和报警，以确保你的GitLab实例运行正常，及时发现和解决问题。

是的，您可以将GitLab设置为中文。GitLab支持多种语言，包括简体中文。以下是如何将GitLab界面语言设置为中文的步骤：

10. 更改语言

• 登录到GitLab:

  • 使用您的用户名和密码登录到您的GitLab实例。

• 访问个人设置:

  • 在页面的右上角，点击您的头像或初始字母图标，然后从下拉菜单中选择“Settings”（设置）。

• 更改语言设置:

  • 在左侧的导航菜单中，点击“Preferences”（偏好设置）。
  • 在“Localization”（本地化）区域，找到“Language”（语言）下拉菜单。
  • 从“Language”下拉菜单中选择“简体中文”。
  • 滚动到页面底部并点击“Save changes”（保存更改）按钮。

• 确认更改:

  • 保存设置后，您的GitLab界面应该会立即更新为中文。

11. 导入第三方仓库

根据从不同源获取的信息，下面是在GitLab中启用项目导入选项的步骤：

• 管理员访问:
  • 登录到GitLab，您需要具有管理员访问级别。在左侧边栏中，选择搜索或转到Admin Area（管理员区域）。

• 导航到设置，启用导入源/导出:
  • 在管理员区域中，选择Settings > General（设置 > 通用）。展开Import and export settings（导入和导出设置）部分，滚动到Project export（项目导出）、Import sources（导入源）选项，选择Enabled（启用）复选框，你可以启用希望允许的导入源，例如Repo by URL, GitHub, Bitbucket等，然后选择Save changes（保存更改）。

• 应用程序设置 ( 如果适用 ) :

  • 对于某些GitLab版本，您可能需要导航到/admin/application_settings，并在Import sources下启用项目导入选项。

• 验证设置: 返回到GitLab的主页面，尝试导入项目以确保您的设置已正确应用。

12. 设置时区

• 北京时间是UTC+8时区。这意味着北京时间比协调世界时（UTC）快8小时。例如，如果UTC的时间是12:00（中午），那么北京时间将是20:00（晚上8点）。在中国，全国都统一使用北京时间，无论是东部还是西部地区。

三、 同级别大版本内更新

• 查看版本号：

sh
cd /opt/gitlab/embedded/service/gitlab-rails
cat VERSION
rpm -q gitlab-ce

sh
sudo yum install gitlab-ce

sh
Is this ok [y/d/N]: y
Downloading packages:
No Presto metadata available for gitlab_gitlab-ce
gitlab-ce-16.10.3-ce.0.el7.x86_64.rpm                                                                                                                                                                  | 1.0 GB  00:02:12     
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
gitlab preinstall: It seems you are upgrading from 16.5 to 16.10.
gitlab preinstall: It is required to upgrade to the latest 16.7.x version first before proceeding.
gitlab preinstall: Please follow the upgrade documentation at https://docs.gitlab.com/ee/update/index.html#upgrade-paths
error: %pre(gitlab-ce-16.10.3-ce.0.el7.x86_64) scriptlet failed, exit status 1
Error in PREIN scriptlet in rpm package gitlab-ce-16.10.3-ce.0.el7.x86_64
  Verifying  : gitlab-ce-16.10.3-ce.0.el7.x86_64                                                                                                                                                                          1/2 
gitlab-ce-16.5.0-ce.0.el7.x86_64 was supposed to be removed but is not!
  Verifying  : gitlab-ce-16.5.0-ce.0.el7.x86_64                                                                                                                                                                           2/2 

Failed:
  gitlab-ce.x86_64 0:16.5.0-ce.0.el7                                                                            gitlab-ce.x86_64 0:16.10.3-ce.0.el7                                                                           

Complete!

(一) GitLab 升级指南：从 16.5.0 到 16.10.3

1. 备份前，先检查运行状态

• 执行以下命令以准备升级：

sh
sudo gitlab-ctl status
systemctl status gitlab-runsvdir.service

2. 创建备份

bash
# 停止相关数据连接服务,如果使用的话  
gitlab-ctl stop unicorn
gitlab-ctl stop puma
gitlab-ctl stop sidekiq

# 备份gitlab数据目录  
gitlab-rake gitlab:backup:create

sh
2024-04-18 06:50:38 UTC -- Warning: Your gitlab.rb and gitlab-secrets.json files contain sensitive data
and are not included in this backup. You will need these files to restore a backup.
Please back them up manually.

3. 升级到 16.7.x 版本

bash
# 停止所有gitlab服务
sudo gitlab-ctl stop

# 安装16.7版本
sudo yum install -y gitlab-ce-16.7.7

• 中间版本更新完成

• 重新配置并启动（注：重新配置若更新时自动配置了，则不需要执行）

sh
sudo gitlab-ctl reconfigure
sudo gitlab-ctl start

• 再次查看版本号：

sh
cd /opt/gitlab/embedded/service/gitlab-rails
cat VERSION
rpm -q gitlab-ce

4. 从 16.7.x 升级到 16.10.3

同样的，继续执行以下命令以完成升级，步骤与升级中间版本相同：

bash
# 停止相关连接服务
gitlab-ctl stop unicorn  
gitlab-ctl stop puma
gitlab-ctl stop sidekiq

# 停止所有gitlab服务  
sudo gitlab-ctl stop

# 安装16.10.3
sudo yum install -y gitlab-ce-16.10.3

# 重新配置并启动（注：重新配置若更新时自动配置了，则不需要执行）
sudo gitlab-ctl reconfigure
sudo gitlab-ctl start

• 再次查看版本号：

sh
cd /opt/gitlab/embedded/service/gitlab-rails
cat VERSION
rpm -q gitlab-ce

(二) 在安装或升级 GitLab CE 后的后续步骤

1. 重新配置 GitLab（注：重新配置若更新时自动配置了，则不需要执行）

安装或升级 GitLab CE 后，首先需要重新配置 GitLab。运行以下命令来启动此过程：

bash
sudo gitlab-ctl reconfigure

这个命令会根据新安装的软件包自动重新配置 GitLab，包括应用新的设置、更新数据库结构等。

2. 检查 GitLab 状态

配置完成后，使用以下命令检查 GitLab 各个组件的状态，确保它们都处于运行中：

bash
sudo gitlab-ctl status

这将显示如 Redis、Nginx、Unicorn 等组件的运行状态。

3. 浏览器访问

GitLab 应该会自动启动 web 服务，你可以用浏览器访问对应的 URL（例如 http://gitlab.example.com）查看 GitLab 的登录页面。

4. 登录并修改密码（如有必要）

使用默认的 root 用户和更新后的新密码（可在 /etc/gitlab/initial_root_password 查看）登录到 GitLab 实例。为了安全起见，建议修改默认的 root 密码。

5. 执行其他配置（可选）

根据实际需求，你可能还需要进行其他配置，比如设置域名/HTTPS、配置邮件服务器等，请参考 GitLab 官方文档进行操作。

6. 升级检查和清理

最后，你可以输入以下命令检查是否还有可用的软件包升级，并进行清理：

bash
sudo yum update
sudo yum clean all

如有新版本的升级包，可以选择继续升级。同时也可以清理过期的包和缓存。按照上述步骤操作，你就能顺利地在升级后继续使用最新版本的 GitLab。

四、 GitLab 内存调优

受限环境的最低要求

可以运行极狐GitLab的最低预期规格是：

• 基于Linux的系统（最好基于Debian或基于RedHat）
• 4个ARM7/ARM64 CPU内核或1个AMD64架构CPU内核
• 最低2GB RAM + 1GB SWAP，最佳为2.5GB RAM + 1GB SWAP
• 20GB可用存储空间
• 具有良好随机I/O性能且具有优先顺序的存储：SSD, eMMC, HDD, 高性能A1-type SD卡

存储尤其重要，因为在受限环境中，我们预计会发生一定量的内存交换，这会给使用过的磁盘带来更大的压力。

1. 配置Swap

在安装极狐GitLab之前，您需要配置swap。Swap是磁盘上的专用空间，在物理RAM已满时使用。当Linux系统耗尽RAM时，非活动页面将从RAM移动到交换空间。建议的swap配置为可用内存的50%左右。

如何配置Swap

• Ubuntu 20.04

  bash
  sudo fallocate -l 1G /swapfile
  sudo chmod 600 /swapfile
  sudo mkswap /swapfile
  sudo swapon /swapfile
  echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
  

• CentOS 7

  bash
  sudo dd if=/dev/zero of=/swapfile bs=1024 count=1048576
  sudo chmod 600 /swapfile
  sudo mkswap /swapfile
  sudo swapon /swapfile
  echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
  

2. 验证系统的性能

有许多工具可以让您验证基于Linux的系统的性能，例如 sbc-bench，它可以用作一种验证系统性能是否足以在受限环境中运行极狐GitLab的方法。

这些系统提供足够的性能来运行极狐GitLab 的小型安装：

• Raspberry PI 4 2GB
• 带有 SSD 的 DigitalOcean Basic 2GB
• Scaleway DEV1-S 2GB/20GB
• GCS e2-small

3. 禁用监控以节省资源

在 /etc/gitlab/gitlab.rb 中禁用监控：

ruby
prometheus_monitoring['enable'] = false

4. 优化GitLab的配置（根据实际情况调整）

• 减少Puma工作进程数量：

  ruby
  puma['worker_processes'] = 0
  

• 降低Sidekiq的并发请求数：

  ruby
  sidekiq['max_concurrency'] = 10
  

• 优化Gitaly配置：

  ruby
  gitaly['configuration'] = {
      concurrency: [
        {'rpc' => "/gitaly.SmartHTTPService/PostReceivePack", 'max_per_repo' => 3},
        {'rpc' => "/gitaly.SSHService/SSHUploadPack", 'max_per_repo' => 3}
      ],
      cgroups: {
          repositories: {'count' => 2},
          mountpoint: '/sys/fs/cgroup',
          hierarchy_root: 'gitaly',
          memory_bytes: 500000,
          cpu_shares: 512,
      }
  }
  gitaly['env'] = {'GITALY_COMMAND_SPAWN_MAX_PARALLEL' => '2'}
  

5. 重载配置

进行所有这些更改后，重新配置极狐GitLab以使用新设置：

bash
sudo gitlab-ctl reconfigure

6. 性能结果

配置完成后，您可以预期以下内存使用情况：

              total        used        free      shared  buff/cache   available
Mem:          1.9Gi       1.7Gi       151Mi        31Mi       132Mi       102Mi
Swap:         1.0Gi       153Mi       870Mi