GitLab 업데이트 — Upgrade Path 확인하고 Docker Compose로 순서대로 올리기
셀프호스팅 GitLab 버전 올릴 일이 있었음. 근데 GitLab은 최신 버전으로 한 방에 못 올림. 중간 버전들을 거쳐서 순서대로 올라가야 함. 이거 모르고 바로 최신 태그로 올리면 마이그레이션 꼬여서 골치 아파짐.
Upgrade Path 툴
공식 툴이 있음. 여기서 확인하면 됨.
https://gitlab-com.gitlab.io/support/toolbox/upgrade-path
- Current에 지금 버전, Target에 올리고 싶은 버전 선택
- Edition(Enterprise/Community), 배포 방식(Ubuntu/Docker 등) 선택
- 그러면 거쳐야 할 중간 버전들이 쭉 나옴
예를 들어 17.4.5에서 올리면 이런 식으로 정거장이 나옴.
17.4.5 → 17.5.5 → 17.8.7 → 17.11.7 → ...이 순서 그대로 하나씩 올리면 됨. 건너뛰기 금지.
Docker Compose 업그레이드
나는 Docker Compose로 GitLab을 돌리고 있어서 과정 자체는 단순함.
docker-compose.yml의 이미지 태그를 다음 정거장 버전으로 수정
services:
gitlab:
image: gitlab/gitlab-ce:17.5.5-ce.0- 새 이미지 받고 재시작
docker compose pull
docker compose up -d- GitLab이 뜨면서 DB 마이그레이션이 자동으로 돌아감. 끝나면 다음 버전으로 1번부터 반복.
조마조마했던 순간
버전 바꾸고 컨테이너 올리면 GitLab이 바로 안 뜸. 내부에서 reconfigure 하고 마이그레이션 돌리느라 생각보다 시간이 꽤 걸림. 502 뜨는 화면 보면서 이거 죽은 건가 싶어서 조마조마했음…
정리
- GitLab은 최신으로 바로 못 올림. Upgrade Path 툴에서 경로 확인 먼저.
- 중간 버전 하나씩, 순서대로. 건너뛰기 금지.
- Docker Compose면 태그 수정 → pull → up 반복.
- 부팅이 오래 걸려도 로그 흐르고 있으면 정상. 기다리면 됨.