BitnamiGitLab升级以及Troubledshooting

目前GitLab已经成为最流行的使用Git工具托管代码的软件,有开源和企业版本的。本文介绍GitLab的升级方式,用的是Bitnami的一键安装包,安装包地址

https://bitnami.com/stack/gitlab/installer

文章介绍从版本7.13.5升级到 8.1.0,8.2.0也可以。

步骤如下:

1.停掉Gitlab服务器,启动 postgresql 和 redis,ctlscript.sh 就在安装目录下,默认是在/opt/gitlab-7.13.5/ctlscript.sh  ,注意下面的路径中的“bitnami”都换成你安装的路径

sudo /opt/bitnami/ctlscript.sh stop
sudo /opt/bitnami/ctlscript.sh start postgresql
sudo /opt/bitnami/ctlscript.sh start redis

2.切换到Git用户,(注意一下均使用git用户,这一点非常重要,以免后面各种权限问题)升级 Gitlabshell

sudo su git
cd /opt/bitnami/apps/gitlab/gitlab-shell
git stash
git fetch https://github.com/gitlabhq/gitlab-shell
git pull  #拉取远程库的更新,由此命令可以知道 gitlab-shell文件夹下面是一个git库
git checkout v2.6.3  [replace it with the latest version]  #在这里checkout 最新版本即可,通过 git branch -a 可以查看 pull了哪些版本
git stash apply
3.备份GitLab,此处略去。

4.   在Github上找到你想要升级到的版本,链接为 https://github.com/gitlabhq/gitlabhq/releases

运行自动升级命令 cd /opt/bitnami/apps/gitlab/htdocs

 
  
ruby -Ilib -e 'require "gitlab/upgrader"' -e 'class Gitlab::Upgrader' -e 'def latest_version_raw' -e '"v8.1.0"' -e 'end' -e 'end' -e 'Gitlab::upgrader.new.execute'  #v8.1.0替换成你需要的版本即可
 
  
然后屏幕输出类似于于下:
 
  
GitLab 7 upgrade tool
Your version is 7.13.5
Latest available version for GitLab 7 is 8.1.0
Newer GitLab version is available
Do you want to upgrade (yes/no)? yes
Stash changed files
 -> git stash
Saved working directory and index state WIP on (no branch): 489b413 Version 7.13.5
HEAD is now at 489b413 Version 7.13.5
 -> OK
Get latest code
 -> git fetch
 -> OK
Switch to new version
 -> git checkout v8.1.0
Previous HEAD position was 489b413... Version 7.13.5
HEAD is now at b725318... Version 8.1.0
 -> OK
Install gems
 -> bundle
Fetching source index from https://rubygems.org/
注意 "->"符号后面跟的除了OK之外都是可以单独运行的命令,如果自动升级命令中间断开,那么调试错误之后,可以手动运行命令,以继续。这一步自动升级有
一些Ruby 的 gems依赖需要下载可能会涉及包下不下来后面后文会有 troubleshooting
5.注意步骤4最后一步是 bundle这个命令如果,这个命令顺利运行,则会输出一下类似内容:
 
  
Your bundle is complete!
Gems in the groups development, test, sqlite, test and sqlite were not installed.
It was installed into ./vendor/bundle
Post-install message from httparty:
When you HTTParty, you must party hard!
6.版本7到8的一个最重要的变化是 使用http clone代码的模块改动了,但是公司内部一般使用ssh协议,所以本文不涉及这一模块的升级
安装一些 libs,bitnami使用的是 postgresql,
 
  
bundle install --without mysql development test --deployment
数据库迁移
 
  
bundle exec rake db:migrate RAILS_ENV=production
清除升级所产生的缓存
 
  
 bundle exec rake assets:clean assets:precompile cache:clear RAILS_ENV=production
7.升级 config files
不同版本的不同功能模块在gitlab.yml文件中 这个文件一般在 /opt/gitlab-x-x-x/apps/gitlab/htdocs/config/下面 进入这个文件夹
运行命令
git diff origin/7-13-stable:config/gitlab.yml.example origin/8-0-stable:config/gitlab.yml.example
查看7.13版本与8.1的config文件有哪些不同,减号开头的删除,加好开头的添加即可。
8.升级后校验
按照上面的步骤运行完成之后,就可以重启gitlab服务器了,使用 ctlscript.sh restart 命令即可
如果升级有误,调试又无法解决那就使用备份恢复到之前的版本,按照上面的步骤,除了新版本中的http协议模块没有升级,其他模块都可以升级
(1)检查升级后的版本以及模块是否运行

bundle exec rake gitlab:env:info RAILS_ENV=production
(2)
检查各种权限以及gems包等细节部分是否安装正确
bundle exec rake gitlab:check RAILS_ENV=production
这里会显示一些没有正确升级的或安装的部分,有些是不用改的如果可以在升级之后完整执行clone push 等一些操作,没有报错日志,就没有必要修改
因为使用的是Bitnami的安装包,而这个命令检查的是使用源码安装的gitlab所以检查结果有一些出入。在这里,我推荐使用官网的Omnibus安装包或者
源码编译安装,不要使用Bitnami的安装包,这个安装包不好维护。

Troubleshooting

1.在步骤4的 bundle命令,经常会出现从 ruby方网站下不下来gems包,只要换成淘宝的镜像即可替换命令如下,注意还是git用户,在htdocs文件夹下面,这个文件夹下面还有一个Gemsfile文件,
查看现在的源:
gem sources -l 显示当前的源
一般为 
https://rubygems.org/
gem sources -r https://rubygems.org/  #去掉官网的源
gem sources -a https://ruby.taobao.org/ #添加淘宝的源
将htdocs下面的Gemfile的以source开头的一行后的url也改为淘宝的源
然后bundle应该是可以成功了
2.升级之后,如果在网页上不能看到仓库的服务器路径可能是权限问题,将repositories文件夹的权限给git用户即可,repositories文件夹下面为GitLab上托管的所有项目代码库一般在/opt/gitlab-7.13.5-0/apps/gitlab/下面
3.升级之后无法使用 ssh协议clone,查看 production.log日志可能是 gitlabshell的日志 gitlab-shell.log文件夹git没有权限,将这个文件夹的权限给git即可,因为客户端在使用 git命令clone的时候是调用 服务器端的 gitlab-shell来执行相关的命令,服务器端需要记录操作信息,必须写入日志。

参考资源:

Bitnami官网的升级步骤:https://wiki.bitnami.com/Applications/BitNami_GitLab#How_to_upgrade_Gitlab.3f 这里只执行到bundle命令即可

Gitlab官网的升级步骤:https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/7.14-to-8.0.md 这里给出的是7.14到8.0其实7.13也可以,在这个链接下面
有http server的升级方法,对于使用 http协议的可以参考这里。
如果只是按照Bitnami的官网的升级方式是不能正常升级7到版本8的,因此处在寻找Git版本管理软件开始的阶段,我推荐使用官网的Omnibus安装包和源码安装,便于维护等。
 
  

 
  
 
  

你可能感兴趣的:(Git,配置管理)