Gitlab升级记

一： 验证gitlab备份是否可用

这里所使用的操作系统环境全部都基于Cetnos7， 防火墙以及selinux全部关闭。

1. 另外找一台机器，安装与服务器版本相同的gitlab，根据原服务器数据的大小，来决定验证数据服务器磁盘的大小。避免因磁盘空间不足而无法正常恢复数据。

• 配置yum源

shell> vi /etc/yum.repos.d/gitlab-ce.repo

[gitlab-ce]
name=Gitlab CE Repository
baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/
gpgcheck=
enabled=

• 安装指定版本

shell> yum install gitlab-ce-11.2.

• 将原服务器的配置文件拷贝至新部署的机器上，然后进行配置;

 #这里是我的 配置文件，这里我们使用了Windows AD来作为LDAP服务器
 external_url 'http://gitlab.mofangge.cc'
 gitlab_rails['ldap_enabled'] = true
  gitlab_rails['ldap_servers'] = YAML.load <<-'EOS'
    main: # 'main' is the GitLab 'provider ID' of this LDAP server
      label: 'LDAP'
      host: 'domainserver.mofangge.cc'
      port:
      uid: 'sAMAccountName'
      bind_dn: 'cn=gitadmin,cn=Users,dc=mofangge,dc=cc'
      password: 'ling4022@163.com'
      encryption: 'plain' # "start_tls" or "simple_tls" or "plain"
      verify_certificates: true
      active_directory: true
      allow_username_or_email_login: true
      lowercase_usernames: false
      block_auto_created_users: false
      base: 'OU=mofangge,DC=mofangge,DC=cc'
      user_filter: ''
      group_base: 'OU=mofangge,DC=mofangge,DC=cc'
      sync_ssh_keys: false
 EOS
 gitlab_rails['manage_backup_path'] = true
 gitlab_rails['backup_path'] = "/opt/data/backups"
 gitlab_rails['backup_archive_permissions'] =
 gitlab_rails['backup_keep_time'] =
  git_data_dirs({
    "default" => {
      "path" => "/opt/data/git-data"
     }
  })
 unicorn['worker_processes'] =
 sidekiq['concurrency'] =
 postgresql['shared_buffers'] = "1024MB"
 postgresql['max_worker_processes'] = 

我的配置文件，仅供参考

shell> grep -Ev "^$|^[#;]" /etc/gitlab/gitlab.rb
shell> scp root@youserverip:/etc/gitlab/gitlab.rb /etc/gitlab/
#然后输入密码即可
shell> gitlab-ctl reconfigure
shell> gitlab-ctl status
#然后这里将host 解析写在wineos下的hosts文件中，访问域名进行校验
192.168.133.12  gitlab.mofangge.cc

然后进行登录验证，如果能正常访问的话，接下来进行恢复工作

二： 恢复数据

将原备份文件拷贝到指定目录下。

shell> scp root@192.168.200.27:/data/gitlabbackup/1589134406_2020_05_11_11..3_gitlab_backup.tar /opt/data/backups/
#由于我自定义了文件名称，这里还需要重命名
shell> mv /opt/data/backups/1589134406_2020_05_11_11..3_gitlab_backup.tar /opt/data/backups/1589134406_gitlab_backup.tar
#查看验证
shell> ls /opt/data/backups/
#进行恢复
shell> gitlab-rake gitlab:backup:restore BACKUP=
#重启之后进行登录验证
shell> gitlab-ctl restart

这里登录之后，查看数据以及配置均为正常。校验数据没有问题之后，进行升级的模拟操作。

三：进行升级

gitlab具有版本帝之称，版本更新之快让人望而却步，由于我们想要适用gitlab ci等新功能，所以还是选择进行升级。

这里我们可以参照官方建议的升级版本顺序进行选择，官方链接地址如：https://docs.gitlab.com/ee/policy/maintenance.html#upgrade-recommendations

建议安装官方推荐的升级版本路径进行升级，避免踩坑。

由于我目前的版本是11.2.3，这里我们先升级到11.11.8,然后升级到12.0.12,最后升级到现在的最新版本，12.10.3进行测试。希望能成功。

这里我在准备虚拟机的阶段已经将所需要的安装包已经下载到本地了。接下来我们进行升级工作。

[root@c7-node2 ~]# ll
total
-rw-r--r--  root root  May  : gitlab-ce-11.11.-ce..el7.x86_64.rpm  #第一次升级到的版本
-rw-r--r--  root root  May  : gitlab-ce-11.2.-ce..el7.x86_64.rpm   #现在版本
-rw-r--r--  root root  May  : gitlab-ce-12.0.-ce..el7.x86_64.rpm  #第二次升级到的版本
-rw-r--r--  root root  May  : gitlab-ce-12.10.-ce..el7.x86_64.rpm  #需要升级的最终版本

[root@c7-node2 ~]# yum install gitlab-ce-11.11.-ce..el7.x86_64.rpm
Loaded plugins: fastestmirror
Examining gitlab-ce-11.11.-ce..el7.x86_64.rpm: gitlab-ce-11.11.-ce..el7.x86_64
Marking gitlab-ce-11.11.-ce..el7.x86_64.rpm as an update to gitlab-ce-11.2.-ce..el7.x86_64
Resolving Dependencies
--> Running transaction check
---> Package gitlab-ce.x86_64 :11.2.-ce..el7 will be updated
---> Package gitlab-ce.x86_64 :11.11.-ce..el7 will be an update
--> Finished Dependency Resolution

Dependencies Resolved

====================================================================================================================================================================================
 Package                             Arch                             Version                                    Repository                                                    Size
====================================================================================================================================================================================
Updating:
 gitlab-ce                           x86_64                           11.11.-ce..el7                           /gitlab-ce-11.11.-ce..el7.x86_64                           1.5 G

Transaction Summary
====================================================================================================================================================================================
Upgrade   Package

Total size: 1.5 G
Is this ok [y/d/N]:

出现如下提示，则证明升级成功了。

sudo gitlab-ctl restart postgresql

gitlab Reconfigured!
Restarting previously running GitLab services
ok: run: alertmanager: (pid ) 1s
ok: run: gitaly: (pid ) 5s
ok: run: gitlab-monitor: (pid ) 4s
ok: run: gitlab-workhorse: (pid ) 5s
ok: run: logrotate: (pid ) 1s
ok: run: nginx: (pid ) 0s
ok: run: node-exporter: (pid ) 5s
ok: run: postgres-exporter: (pid ) 1s
ok: run: postgresql: (pid ) 6862s
ok: run: prometheus: (pid ) 3s
ok: run: redis: (pid ) 52s
ok: run: redis-exporter: (pid ) 4s
ok: run: sidekiq: (pid ) 1s
ok: run: unicorn: (pid ) 0s

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

Upgrade complete! If your GitLab server is misbehaving try running
  sudo gitlab-ctl restart
before anything else.
If you need to roll back to the previous version you can use the database
backup made during the upgrade (scroll up for the filename).

  Verifying  : gitlab-ce-11.11.-ce..el7.x86_64                                                                                                                                /
  Verifying  : gitlab-ce-11.2.-ce..el7.x86_64                                                                                                                                 / 

Updated:
  gitlab-ce.x86_64 :11.11.-ce..el7                                                                                                                                               

Complete!

然后进行登录校验，这里我依然使用LDAP账户进行登录，因为我之前没有standard账户，root下是没有数据的。

然后继续进行升级，这次升级到10.0.12版本，因为11.11.8是11的最后一个版本。也是升级的必须步骤。

[root@c7-node2 ~]# yum install gitlab-ce-12.0.-ce..el7.x86_64.rpm -y
#这里出现的结果跟上次一样，就证明升级成功
Upgrade complete! If your GitLab server is misbehaving try running
  sudo gitlab-ctl restart
before anything else.
If you need to roll back to the previous version you can use the database
backup made during the upgrade (scroll up for the filename).

  Verifying  : gitlab-ce-12.0.-ce..el7.x86_64                                                                                                                                /
  Verifying  : gitlab-ce-11.11.-ce..el7.x86_64                                                                                                                                / 

Updated:
  gitlab-ce.x86_64 :12.0.-ce..el7                                                                                                                                               

Complete!

然后请继续进行登录和数据校验。有任何一个过程出问题，就需要考虑回滚。 数据最重要。

接下来，我将升级到最新版本，12.10.3。

[root@c7-node2 ~]# yum install gitlab-ce-12.10.-ce..el7.x86_64.rpm -y
Loaded plugins: fastestmirror
Examining gitlab-ce-12.10.-ce..el7.x86_64.rpm: gitlab-ce-12.10.-ce..el7.x86_64
Marking gitlab-ce-12.10.-ce..el7.x86_64.rpm as an update to gitlab-ce-12.0.-ce..el7.x86_64
Resolving Dependencies
--> Running transaction check
---> Package gitlab-ce.x86_64 :12.0.-ce..el7 will be updated
---> Package gitlab-ce.x86_64 :12.10.-ce..el7 will be an update
--> Finished Dependency Resolution

出现如下界面，则证明升级成功，最后也可以通过gitlab-ctl status进行验证。

Upgrade complete! If your GitLab server is misbehaving try running
  sudo gitlab-ctl restart
before anything else.
If you need to roll back to the previous version you can use the database
backup made during the upgrade (scroll up for the filename).

  Verifying  : gitlab-ce-12.10.-ce..el7.x86_64                                                                                                                                /
  Verifying  : gitlab-ce-12.0.-ce..el7.x86_64                                                                                                                                / 

Updated:
  gitlab-ce.x86_64 :12.10.-ce..el7                                                                                                                                               

Complete!
[root@c7-node2 ~]# gitlab-ctl status
run: alertmanager: (pid ) 13s; run: log: (pid ) 2186s
run: gitaly: (pid ) 62s; run: log: (pid ) 1559s
run: gitlab-exporter: (pid ) 13s; run: log: (pid ) 81s
run: gitlab-workhorse: (pid ) 12s; run: log: (pid ) 1525s
run: grafana: (pid ) 12s; run: log: (pid ) 1500s
run: logrotate: (pid ) 11s; run: log: (pid ) 2186s
run: nginx: (pid ) 11s; run: log: (pid ) 2186s
run: node-exporter: (pid ) 11s; run: log: (pid ) 2186s
run: postgres-exporter: (pid ) 10s; run: log: (pid ) 2186s
run: postgresql: (pid ) 162s; run: log: (pid ) 2186s
run: prometheus: (pid ) 10s; run: log: (pid ) 2186s
run: redis: (pid ) 152s; run: log: (pid ) 2186s
run: redis-exporter: (pid ) 9s; run: log: (pid ) 2186s
run: sidekiq: (pid ) 9s; run: log: (pid ) 1526s
run: unicorn: (pid ) 1299s; run: log: (pid ) 2186s

最后给大家来一张升级成功的图片，以示鼓励。加油~~

接下来大家可以在服务器端进行升级操作，如果服务器是虚拟机的话，建议先做快照，以便出问题时进行恢复，一定要做备份，数据最重要。