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
关闭gitlabgitlab-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技术博客空间
标签:备份,gitlab,升级,yum,版本,ctl,迁移,安装 From: https://www.cnblogs.com/guoapeng/p/16816764.html