gitlab-ee 13.x->14.x->15.x->16.x升级踩坑记

发布时间:2024年01月11日

安装-升级

升级时需要打开如下网址规划路径:
https://gitlab-com.gitlab.io/support/toolbox/upgrade-path/?current=13.3.9&distro=centos&auto=true
导入gitlab官方软件仓库
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

自检查

gitlab-rake gitlab:check SANITIZE=true

列出后台是否存在正在运行的migration

gitlab-rake db:migrate:status
gitlab-rake db:migrate

备份

gitlab-rake gitlab:backup:create
ls /var/opt/gitlab/backups

恢复

cp ${tar} /var/opt/gitlab/bakcups/
gitlab-ctl stop unicorn
gitlab-ctl stop puma
gitlab-ctl stop sidekiq
gitlab-rake gitlab:backup:restore BACKUP=1704745822_2024_01_09_13.4.1-ee
gitlab-ctl reconfigure

卸载

gitlab-ctl stop
rpm -e gitlab-ee-${version}-ee.0.el8.x86_64.rpm
rm -rf /etc/gitlab
rm -rf /opt/gitlab
rm -rf /var/opt/gitlab
rm -rf /var/log/gitlab
rm -rf /run/gitlab

升级过程中遇到问题一般解决方案

1、数据库migrate失败(频率最高)

   查看caused by原因,手动解决问题后,执行:gitlab-rake db:migrate
   执行完毕后,输入:gitlab-rake db:migrate:status以查看迁移状态
  **注意:最好按提示one-by-one执行,即执行gitlab-rake db:migrate后看报错,然后解决报错,再执行gitlab-rake db:migrate,直到全部成功**
   全部迁移完成后下执行:gitlab-ctl reconfigure

2、提示restart某个组件以启用新版版本
按提示执行即可,也可全部重启,按个人喜好

3、升级过程中由于没有执行2,导致数据库migrate失败,启动组件超时
可以先重启gitlab: gitlab-ctl restart
若数据库迁移失败,参考问题1
若启动组件超时,重新配置即可:gitlab-ctl reconfigure
最后 重启gitlab: gitlab-ctl restart

升级到13.8.8遇到的问题

PG::DuplicateTable: ERROR: relation “public.postgres_indexes” already exists

sudo -u gitlab-psql /opt/gitlab/embedded/bin/psql -h /var/opt/gitlab/postgresql -d gitlabhq_production
DROP VIEW public.postgres_indexes;
exit;

PG::DuplicateTable: ERROR: relation “postgres_index_bloat_estimates” already exists

sudo -u gitlab-psql /opt/gitlab/embedded/bin/psql -h /var/opt/gitlab/postgresql -d gitlabhq_production
Drop view public.postgres_index_bloat_estimates;
exit;

最后

gitlab-ctl reconfigure

升级到14.3.6遇到的问题

Expected batched background migration for the given configuration to be marked
as ‘finished’, but it is ‘active’:
sudo gitlab-rake gitlab:background_migrations:finalize[CopyColumnUsingBackgroundMigrationJob,ci_builds,id,‘[[“id”, “stage_id”], [“id_convert_to_bigint”, “stage_id_convert_to_bigint”]]’]
Expected batched background migration for the given configuration to be marked as ‘finished’, but it is ‘active’: {:job_class_name=>“CopyColumnUsingBackgroundMigrationJob”, :table_name=>“ci_stages”, :column_name=>“id”, :job_arguments=>[[“id”], [“id_convert_to_bigint”]]}
Finalize it manualy by running

sudo gitlab-rake gitlab:background_migrations:finalize[CopyColumnUsingBackgroundMigrationJob,ci_stages,id,'[["id"]\, ["id_convert_to_bigint"]]']

Expected batched background migration for the given configuration to be marked as ‘finished’, but it is ‘active’: {:job_class_name=>“CopyColumnUsingBackgroundMigrationJob”, :table_name=>“ci_builds_metadata”, :column_name=>“id”, :job_arguments=>[[“id”], [“id_convert_to_bigint”]]}
Finalize it manualy by running

sudo gitlab-rake gitlab:background_migrations:finalize[CopyColumnUsingBackgroundMigrationJob,ci_builds_metadata,id,'[["id"]\, ["id_convert_to_bigint"]]']

Expected batched background migration for the given configuration to be marked as ‘finished’, but it is ‘active’: {:job_class_name=>“CopyColumnUsingBackgroundMigrationJob”, :table_name=>“push_event_payloads”, :column_name=>“event_id”, :job_arguments=>[[“event_id”], [“event_id_convert_to_bigint”]]}
Finalize it manualy by running

sudo gitlab-rake gitlab:background_migrations:finalize[CopyColumnUsingBackgroundMigrationJob,push_event_payloads,event_id,'[["event_id"]\, ["event_id_convert_to_bigint"]]']

migrate后需要执行

gitlab-ctl reconfigure

升级到14.9.5

gitlab-ctl restart

升级到15.4.6遇到的问题

大规模升级依赖

gitlab-ctl restart

升级到16.1.5遇到的问题

gitlab-ctl restart

升级到16.3.6遇到的问题

gitlab-ctl restart

升级到16.7.0遇到的问题

gitlab-ctl restart
文章来源:https://blog.csdn.net/u013241245/article/details/135523860
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。