gitlab安装升级（大版本跨度9.4.5----13.2.1）
gitlab安装升级（大版本跨度9.4.5----13.2.1）
gitlab基础介绍
1、 repository： 代码库，可以是硬盘或NFS文件系统
2、 NGINX: web 入口
3、 数据库：包含信息Repository 中的数据（元数据，issue，合并请求merge request等）可以登陆的web用户信息
4、 Redis 缓存 ，负责分发信息
5、 sidekq： 后台任务，主要负责发送电子邮件，任务来自与redis
6、 unicorn （gitlab rails）：gitlab自身的web，包含了gitlab主进程，负责处理快速/一般任务，与redis一起工作，内容有
A 通过检查存储在redis中的用户来检查权限
B 为sidekiq 制作任务
C 从仓库（warehouse） 取东西或在哪里移动东西
7、 gitlab-shell：用于SSH交互，而不是http，gitlab-shell 通过redis与sidekiq 进行通信，并直接通过TCP访问unicorn
8、 gitaly： 后台服务，专门负责访问磁盘以高效处理git，并处理缓存耗时操作，所有的git操作都通过gitaly 进行处理
9、 gitlab-workshorse： 反向代理服务器，可以处理与redis无关的请求，磁盘上的CSS，JS 文件等），处理git push/pull 请求，处理redis的链接（修改有redis发送的响应或发送给redis请求，管理redis的长期web socket链接）
10、 mail_room： 处理邮件请求，恢复gitlab发送的邮件时，gitlab会调用此服务.
大体原理： gitlab 使用nginx将前端请求代理到UNicorn web 服务器，默认情况下，unicorn 与前端之间的通信是通过unix domain 套接字进行的，但也支持通过TCP请求转发，web访问前端/home/git/gitlab/pubilc绕过unicorn 服务来提供静态页面，上传和预编译资源，gitlab使用Unicorn web 提供网页和gitlab api，使用sidekiq作为作业队列， 反过来，它使用redis 作为作业信息，元数据和作业的非持久化数据后端。 gitlab应用程序使用mysql或postgresql 作为持久化数据库，保存用户，权限，issue其他元数据等。 通过http/https提供repository时，gitlab使用gitlab API 来解释授权和访问以及提供git对象。 gitlab-shell 通过ssh提供repository，他管理/home/git/,ssh/authorized_keys 内的SSH密钥，不应该手动编辑，gitlab-shell通过gitaly访问bare repository 已提供git对象并与redis 进行通信以向sidekiq提交作业以供gitlab处理，gitlab-shell 查询gitlab API一确定授权和访问。
一、gitlab安装（安装方式：下载rpm包）
1、先去官网下载安装包（https://packages.gitlab.com），但是鉴于下载速度实在太慢了，比较推荐去清华源下载，地址：https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/，我的安装环境是centos7.2,选择的版本是gitlab-ce-9.4.5-ce.0.el7.x86_64.rpm。
2、安装gitlab
# rpm -Uvh gitlab-ce-9.4.5-ce.0.el7.x86_64.rpm
3、编辑配置文件 /etc/gitlab/gitlab.rb
# grep '^[a-z]' /etc/gitlab/gitlab.rb
external_url 'http://172.16.68.154:10068' #gitlab监听地址和端口，默认监听端口号为80
unicorn['port'] = 28080 #组件unicorn监听的端口号，默认为8080
prometheus['enable'] = false #关闭prometheus监控，比较耗内存
4、初始化gitlab
# gitlab-ctl reconfigure
5、启动gitlab
# gitlab-ctl start
6、查看gitlab版本号
# cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
7、查看gitlab各组件的启动情况
# gitlab-ctl status
8、gitlab默认安装目录
/opt/gitlab/ ## 主目录 /etc/gitlab/ ## 放置配置文件 /var/opt/gitlab/ ## 各个组件 /var/log/gitlab/ ## 放置日志文件
9、输入访问地址http://172.16.68.154:10068，第一次登陆会转跳到重置密码的界面，设置完成即可用root用户登陆。
二、忘记root用户密码，重置密码。
# gitlab-rails console production
irb(main):001:0> u=User.where(id:1).first irb(main):003:0> u.password=12345678 irb(main):004:0> u.password_confirmation=12345678 irb(main):005:0> u.save! irb(main):006:0> quit
三、备份与恢复
1、备份
# gitlab-rake gitlab:backup:create
2、恢复
（1）先停止服务
# gitlab-ctl stop unicorn # gitlab-ctl stop sidekiq # gitlab-ctl stop nginx
(2) 恢复数据
# gitlab-rake gitlab:backup:restore BACKUP=1596428908_2020_08_03_9.4.5
四、升级
1、升级之前先做好备份
# gitlab-rake gitlab:backup:create
备份好的数据在没改备份路径的情况下，默认的目录是：/var/opt/gitlab/backups
2、参考https://docs.gitlab.com/ee/policy/maintenance.html#upgrade-recommendations给出的升级跨度版本，一个版本一个版本的升级，千万不可跨大版本升级。
（1）升级前先停掉服务
# gitlab-ctl stop unicorn sidekiq nginx
（2）我要从9.4.5升级到13.2.1，需要升级的版本号依次是9.4.5-->9.5.10-->10.8.7-->11.11.8-->12.0.12-->12.10.6-->13.0.0-->13.2.1
每升级一个版本都要重启gitlab登陆页面看看，有没有问题，确定无误之后方可进行升级下一个版本。
# rpm -Uvh gitlab-ce-9.5.10-ce.0.el7.x86_64.rpm
# gitlab-ctl reconfigure
# gitlab-ctl restart
