[Docker] Gitlab CE 업그레이드 하기 (14 ver later) 2탄

1편에서 13버전의 Last까지 업그레이드는 성공했다.

14버전도 동일하게 진행하려고 하였으나 14버전에서 부터는 Background Migration이 적용됬다.

https://docs.gitlab.com/ee/update/background_migrations.html

Background migrations and upgrades | GitLab

 

14버전의 초입까지는 쉽게 마이그레이션이 되었으나 그 다음 버전부터 이미지 교체 후 실행하면 컨테이너가 정상 작동하지 않는 현상이 발생됬다.

 

https://docs.gitlab.com/ee/update/background_migrations.html#batched-background-migrations

Background migrations and upgrades | GitLab

 

로그를 뜯어보면 

 

Expected batched background migration for the given configuration to be marked as 'finished', but it is 'active':

 

라는 메세지를 찾을 수 있다.

말 그대로 Background Migration이 완료되지 않은 상태에서 진행되어 발생된 현상이였다.

 

https://docs.gitlab.com/ee/update/background_migrations_troubleshooting.html#database-migrations-failing-because-of-batched-background-migration-not-finished

Troubleshooting | GitLab

가이드에 나온 트러블 슈팅을 보며 정확히 내가 마주한 현상의 로그가 발생된걸 확인할 수 있다.

 

우선 이전에 백업을 뜬 버전으로 롤백했다.

(https://luji.tistory.com/97 참고)

 

Background Migration 현황 확인하기

 

정확하진 않지만 13버전 마지막, 혹은 14버전 초반까지 업그레이드가 모니터링 매뉴에 Backgorund Migrations가 추가된다.

 

1. Gitlab 홈페이지 관리자 계정 로그인

2. 상단 메뉴 -> 관리자 -> 관리자 영역의 모니터링 탭 -> Background Migration 메뉴 클릭

Background Migration 현황

큐에 들어간 작업 목록(진행중)

 

위의 화면에서 Background Migration의 현황을 확인 할 수 있다.

여기서 체크해야할 부분은 Queued(진행중), 실패 메뉴에 항목이 없고, 완료 탭에 모든것이 Finished 상태여야한다.

Queued은 진행될 작업이 쌓여있으며 순차적으로 실행 된다.

모든것이 Finished 상태가 된다면 앞서서 진행한 방식대로 이미지 교체 방식으로 Git을 업그레이드 하면된다.

 

진행하다 보니 모든 버전에서 Background Migration이 진행되는것은 아니였다.

특정 버전을 기점으로 진행되는거 같으니 항상 업그레이드가 끝난 뒤 관리자 페이지에서 현황을 확인해보고 진행해야한다.

또한 버전별로 백업을 진행하여 태초마을로 돌아가지 않도록 주의하자.

 

Sidekiq 프로세스 설정 (선택, 딱히 효과 없는듯)

좀더 빠른 진행을 위해 Sidekiq의 프로세스 수를 늘려줘 봤다.
이 Sidekiq의 Multiple processes 처리를 위해 프로세스의 갯수를 임의로 늘릴 수 있다.

Gitlab에서 제공하는 Sidekiq은 백그라운드 관리자와 비슷한 역할인듯하다.

https://docs.gitlab.com/ee/administration/sidekiq/extra_sidekiq_processes.html

Run multiple Sidekiq processes | GitLab

 

1. vi /srv/gitlab/logs/gitlab.rb

 - Vi 에디터로 오픈

2. 맨 마지막 줄에 아래의 설정 추가 후 저장

sidekiq['queue_groups'] = ['*'] * 4

3. docker exec -t <container-name> gitlab-ctl reconfigure

 

 

릴리즈 노트 확인

https://gitlab-com.gitlab.io/cs-tools/gitlab-cs-tools/what-is-new-since/?tab=features&minVersion=12_03

Release Overview

버전별 릴리즈 노트를 한눈에 확인할 수 있는 사이트

 

마무리

Gitlab Docker 이미지 업그레이드를 하면서 느낀점이 있다면 자주 관심을 가져주자 ㅜ,,

한번에 몰아서 하려고 하니 들어가는 시간이 좀 걸렸다 ㅜ

그렇지만 자동화된 업그레이드 & 마이그레이션으로 솔직히 쉽게 진행했다.

물론 초반에 겪은 시행착오가 스트레스를 받긴 했지만..