gitlab安装升级及迁移

gitlab简介

GitLab 是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。
GitLab是由GitLabInc.开发，使用MIT许可证的基于网络的Git仓库管理工具，且具有wiki和issue跟踪功能。使用Git作为代码管理工具，并在此基础上搭建起来的web服务。
GitLab由乌克兰程序员DmitriyZaporozhets和ValerySizov开发，它使用Ruby语言写成。后来，一些部分用Go语言重写。截止2018年5月，该公司约有290名团队成员，以及2000多名开源贡献者。GitLab被IBM，Sony，JülichResearchCenter，NASA，Alibaba，Invincea，O’ReillyMedia，Leibniz-Rechenzentrum(LRZ)，CERN，SpaceX等组织使用。

安装环境介绍

服务器的操作系统为CentOS Linux release 7.9.2009
包管理工具yum.
这里安装的是gitlab企业版，本教程可以作为社区版安装的参考材料，社区版安装稍有不同，在了解社区版的差异后，安装步骤稍作调整．

gitlab 安装

gitlab的安装方式有很多中，比如docker镜像安装，Helm charts安装，源代码安装，GET(GitLab Environment Toolkit)安装, 本文主要讲述使用ceontos或redhat系列中通过yum安装使用rpm包安装．需要对yum和rpm命令有一定的了解．

系统要求

空闲硬盘空间：　2.5G+
CPU: 4core+ (4核最多支持500用户，8核最多支持1000用户)
内存：4GB+

安装准备工作

• 更新yum源
  这里采用清华镜像(主要处于下载速度考虑)，如果你访问外网的速度够快, 可以考虑使用官方镜像．
  将下面一段代码拷贝到/etc/yum.repos.d, 命名为gitlab_gitlab-ee.repo, 当然你也可以根据自己的喜好命名，只要文件后缀为.repo即可，符合yum源文件命名规范即可

   [gitlab_gitlab-ee]
    name=Gitlab EE Repository
    baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ee/yum/el$releasever/
    gpgcheck=0
    enabled=1
  

• 更新yum缓存，以便快速查询，确保缓存中有最新安装包信息

  yum makecache fast
  

  说明：这行命令从字面上已经很容易理解，这里只对fast参数，稍加说明，这行命令中加fast参数的目的是为了yum install时能快速找到下载速度最快的镜像，对于gitlab本身来说我们已经知道清华镜像应该是最快的，但是对于其依赖项来说，系统可以自动去判断，所以建议添加该参数．

开始安装gitlab

• 开始安装前可以使用yum命令查看有哪些可用的版本，以及当前最新版本是哪个．

  yum list gitlab-ee --showduplicates | sort -r
  

  通过以上命令，确定当前列表中包含最新版本，如果列表中最新版本不是最新的，可能需要执行yum makecache 更新缓存，或者yum源本身就不包含最新版本，那么要考虑更换yum源．如果要安装指定版本，需要确保需要安装的版本包含在列表中．

• 安装最新版本的方法

  yum install -y gitlab-ee
  

• 安装制定版本的方法
  以centos7为例, 后面的版本号x.y.z-ee.0.el7根据实际情况进行替换．

  yum install -y gitlab-ee-x.y.z-ee.0.el7
  

• 配置gitlab
  按照完成后执行以下命令gitlab将会自动帮我们完成一些必要的配置，切记如果你手动完成一些配置后不要重复执行以下命令，否则手动配置的参数会被清除，严重时会导致用户访问是出现html500错误．

  gitlab-ctl reconfigure
  

  手动修改external_url
  编辑文件/etc/gitlab/gitlab.rb

  #replace gitlab.example.com with your domain or your ip
  external_url 'your_domain'
  

• 启动gitlab
  如果一切顺利，我们就可以启动gitlab了，启动命令为

  gitlab-ctl start
  

  启动成功后, 可以使用浏览器访问gitlab web页面，默认端口是80, 所以可以打开http://your_server_address访问．

  如果没有设置密码，系统将为root用户生成一个随机密码，该随机密码可以在/etc/gitlab/initial_root_password文件中找到．
  建议修改该随机密码，方式为

   gitlab-rake "gitlab:password:reset[root]"
  

  说明: 命令中的root即为root用户，改名了也可以用来为其他用户设置密码．

  关于gitlab的高级配置，可以参考gitlab的官网
  这里补充几点如何启动，关闭，查看gitlab状态的命令，方便troubleshooting
  关闭gitlab

   gitlab-ctl stop
  

  重启gitlab

  gitlab-ctl stop
  

  查看gitlab状态

  gitlab-ctl status
  

  查看gitlab滚动日志

  gitlab-ctl tail
  

  想了解更多命令，可以查看帮助

   gitlab-ctl --help
  

gitlab升级

开启yum缓存

• gitlab的每个安装包都接近1G大小，gitlab升级过程中需要反复恢复重试，如果不开启yum缓存，即每次执行yum install无论成功与否，安装包都会被清理掉，下次重试即使是相同的版本也会去服务器上重新下载，会特别慢，而且消耗服务器带宽，如果触发了镜像服务器的限流机制，升级可能会无法进行下去.

• 强烈建议开启yum缓存，等升级完成后再关闭缓存．手动清理 /var/cache/yum/x86_64/7/gitlab_gitlab-ee下的缓存．

• 开启yum 缓存步骤如下: 修改/etc/yum.conf, 将keepcache设置为1, 默认为0.
  这样当再次重试相同版本时就可以使用-C 参数使用缓存如下所示，而不必去镜像服务器上重新下载．

yum update -C gitlab-ee-x.y.z-ee.0.el7

[main]
cachedir=/var/cache/yum/$basearch/$releasever
keepcache=1　# 开启缓存
debuglevel=2
logfile=/var/log/yum.log
exactarch=1
obsoletes=1
gpgcheck=1
plugins=0

升级前备份

• 备份数据

gitlab-rake gitlab:backup:create

• 备份敏感数据

手动备份两个具有敏感数据的文件

cp  /etc/gitlab/gitlab.rb  /var/opt/gitlab/backups
# and
cp  /etc/gitlab/gitlab-secrets.json  /var/opt/gitlab/backups

• 说明：

  • 备份被保存在/var/opt/gitlab/backups目录下
  • 备份文件名格式如下: 例如1665044212_2022_10_06_14.4.1-ee_gitlab_backup.tar , 备份编号+日期+gitlab版本号+后缀
  • 备份恢复的原则是对应版本的备份文件只能使用对应版本的gitlab程序进行恢复
  • 跨版本恢复备份文件会出现恢复失败或未知错误
  • 如果要再高版本中使用低版本的备份文件
    • 方法一: 在另一台机中 安装低版本gitlab 将低版本的备份程序采用低版本的gitlab恢复后再将低版本的gitlab升级到高版本, 再使用高版本的gitlab制作备份文件

开始升级

• 升级前需要了解升级路径，gitlab不能一下子升级到最新版，需要升级到必要的中间版本，然后一步步升级到最新版本．主要涉及到数据的migration工作，所以必须经过其中关键的版本升级，才能顺利完成数据更新操作．
  升级路径可以参考官网 – Upgrade paths, 这里简要列举路径如下
  8.11.Z -> 8.12.0 -> 8.17.7 -> 9.5.10 -> 10.8.7 -> 11.11.8 -> 12.0.12 -> 12.1.17 -> 12.10.14 -> 13.0.14 -> 13.1.11 -> 13.8.8 -> latest 13.12.Z -> 14.0.12 -> 14.3.6 -> 14.9.5 -> 14.10.Z -> 15.0.Z -> 15.4.0 -> latest 15.Y.Z

• 首先确定gitlab版本信息, 然后再选择合适的升级路径

   gitlab-rake gitlab:env:info
  
   # 例如
   GitLab information
   Version:        14.4.1-ee
   Revision:       abc23a14bac
  
  

• 每个版本升级完成后，要启动gitlab等待数据迁移完成
  查看数据迁移任务，有两种查看方式，可以通过web界面查看，也可以通过命令行来查看．

  • web界面查看方式
    查看迁移任务的状态，打开web界面:
    在页面顶部, 选择 Menu > Admin.
    在页面左侧边栏，选择Monitoring > Background Migrations.

  • 命令行查看方式

    gitlab-rails runner -e production 'puts Gitlab::BackgroundMigration.remaining'
    

• 关闭gitlab的部分服务

    gitlab-ctl stop unicorn
    gitlab-ctl stop sidekiq
    gitlab-ctl stop nginx
    
  

• 升级命令
  升级命令和安装命令是一样的, 将x.y.z-ee.0.el7替换成关键中间版本

     yum update -y gitlab-ee-x.y.z-ee.0.el7
  

  升级完成后，
  需要重新运行配置,否则启动会失败

     gitlab-ctl reconfigure
  

  如果有手动配置，需要重做一遍．
  需要启动gitlab,等待数据迁移任务完成，然后再备份，再次进行下一个版本的升级．
  如果遇到严重问题，需要回退到上一个版本，导入备份，解决问题后继续往后升级，所以备份很重要．
  备份恢复命令如下：
  其中636041545_2021_11_04_12.10.14为备份文件的名字，不包含文件名后缀．

  gitlab-rake gitlab:backup:restore BACKUP=1636041545_2021_11_04_12.10.14
  

gitlab迁移

• 有时我们需要将gitlab迁移到新的性能更好的服务器．怎么进行迁移呢？当然方法很多，这里介绍其中的一种方式，即通过先备份，然后在新的服务器上进行还原操作．

• 说明: gitlab还原有一点需要注意，那就是备份文件只能是在与创建备份的gitlab版本相同的gitlab上才能恢复，备份文件的后八位即是创建该备份的gitlab的版本，该版本只能在这种版本下进行还原．

备份数据

gitlab-rake gitlab:backup:create

• 备份文件默认(如果没做额外配置的情况下)保存在/var/opt/gitlab/backups目录下面．

在新服务器上安装gitlab

• 可以参考本文的安装部分进行安装

还原备份

• 将备份文件拷贝到新服务器的/var/opt/gitlab/backups目录下，执行恢复命令．备份文件参数，根据自己的实际情况进行修改．

  gitlab-rake gitlab:backup:restore BACKUP=1636041545_2021_11_04_12.10.14
  

彻底卸载gitlab

• 警告: 注意标题上彻底二字，在你不清楚卸载意味会发生什么的时候，请不要执行以下任何步骤．

卸载前备份

• 卸载前执行一次备份，备份存放位置为/var/opt/gitlab/backups, 因为后续该目录也会被清除，所以请将备份拷贝到一个安全的位置，因为后续动作可能会永久的删除数据，以便后续发生问题或反悔的时候，可以从备份恢复数据．

• 备份数据

gitlab-rake gitlab:backup:create

• 备份敏感数据

手动备份两个具有敏感数据的文件

cp  /etc/gitlab/gitlab.rb  /var/opt/gitlab/backups
# and
cp  /etc/gitlab/gitlab-secrets.json  /var/opt/gitlab/backups

执行卸载

• 关闭gitlab

   #关闭gtilab
   gitlab-ctl stop
   #查看gitlab状态，确保已经关闭
   gitlab-ctl status
  

• 卸载应用程序

   rpm -e gitlab-ee
  

• 删除数据残留
  首先确认有哪些数据残留　　

    find / -name gitlab
  

  如果都是期望被删除的，那么开始执行删除操作，再次提醒将备份拷贝一份到安全位置．

  find / -name gitlab | xargs rm -rf
  

说明

本技术博客原创文章位于鹏叔的IT技术博客空间 – gitlab安装升级及迁移, 访问原创文件以获得最近更新.

更多技术博客请访问: 鹏叔的IT技术博客空间

原文地址：http://www.cnblogs.com/guoapeng/p/16816764.html