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

安装-升级

升级时需要打开如下网址规划路径:

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

自检查

bash 复制代码
gitlab-rake gitlab:check SANITIZE=true

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

bash 复制代码
gitlab-rake db:migrate:status
gitlab-rake db:migrate

备份

bash 复制代码
gitlab-rake gitlab:backup:create
ls /var/opt/gitlab/backups

恢复

bash 复制代码
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

卸载

bash 复制代码
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

bash 复制代码
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

bash 复制代码
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;

最后

bash 复制代码
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

bash 复制代码
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

bash 复制代码
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

bash 复制代码
sudo gitlab-rake gitlab:background_migrations:finalize[CopyColumnUsingBackgroundMigrationJob,push_event_payloads,event_id,'[["event_id"]\, ["event_id_convert_to_bigint"]]']

migrate后需要执行

bash 复制代码
gitlab-ctl reconfigure

升级到14.9.5

bash 复制代码
gitlab-ctl restart

升级到15.4.6遇到的问题

大规模升级依赖

bash 复制代码
gitlab-ctl restart

升级到16.1.5遇到的问题

bash 复制代码
gitlab-ctl restart

升级到16.3.6遇到的问题

bash 复制代码
gitlab-ctl restart

升级到16.7.0遇到的问题

bash 复制代码
gitlab-ctl restart
相关推荐
全栈工程师修炼指南1 天前
告别手动构建!Jenkins 与 Gitlab 完美协作,根据参数自动化触发CI/CD流水线实践
运维·ci/cd·自动化·gitlab·jenkins
xiaok3 天前
分支管理提交代码
git·gitlab·github
*老工具人了*4 天前
Terraform整合到GitLab+Jenkins工具链
gitlab·jenkins·terraform
走上未曾设想的道路5 天前
中标麒麟7.4为gitlab添加Registry
gitlab
韩zj5 天前
docker部署Gitlab社区版,步骤以及外网访问出现502的解决方式
docker·容器·gitlab
走上未曾设想的道路5 天前
gitlab流水线与k8s集群的联通
kubernetes·gitlab
走上未曾设想的道路5 天前
中标麒麟7.4部署gitlab-runner
gitlab
xiaok6 天前
把代码上传到gitee的时候,怎么忽略node_modules文件夹
git·gitlab·github
deeper_wind6 天前
OpenEuler部署gitlab(小白的“升级打怪”成长之路)
gitlab
-KamMinG7 天前
“从零到一:使用GitLab和Jenkins实现自动化CI/CD流水线”
自动化·gitlab·jenkins