[월:] 2025년 11월

Synology에 gitlab을 설치해서, 프로젝트마다 (간혹 그리고 어쩌다가 commit 하면서) 작업을 하고 있다.

편한 것도 있고 조금 불편한 것도 있고 그랬지만, 버전 관리가 되고 있다는 점에서 안심이 되었기 때문이다.

21년도에 gitlab 14.3.2-ce.0를 docker로 설치해서 지금까지 업데이트를 하지 않고 사용해왔다.

사실 내가 쓰는 기능이라고 해봐야 아주 초보적인, 그리고 웹 브라우저에서 간혹 코드 살펴볼 정도만 쓰는거라 버전이 낮아도 큰 불편함은 없었다.

그래도 혹시나 보안에 취약하지는 않을까, 중간에 뻑이 나지 않을까 걱정은 되기는 했다.

털려봐야 큰 타격이 없는 것들이기는 하지만, 그래도 기분은 나쁘니까...

---

며칠 전에 갑자기 gitlab을 업데이트해야겠다는 마음을 먹었다.

docker 사용법도 다 잊어버렸고, gitlab 설정파일을 어디 고쳤는지 기억도 나지 않았지만 그래도 chtaGPT가 있으니 안심하고 시작했다. (결론적으로 설정파일인 gitlab.rb 은 문제가 발생하지 않는 한 손보지 않고 그대로 갖고 가는 것을 확인했다.)

우선은 gitlab을 업데이트하기 위해서는 upgrade path가 맞아야 한다.
바로 14.3.2에서 18.5.1로 업데이트가 되지 않는다.

https://gitlab-com.gitlab.io/support/toolbox/upgrade-path/

위 링크에서 업데이트해야 하는 주요 image를 다 pulling해 놓는다. (아래 코드는 버전 하나만 적어놓았지만, upgrade path에 보여지는 모든 버전을 pulling해야 한다)

sudo docker pull gitlab/gitlab-ce:14.10.5-ce.0

그리고 기존 컨테이너는 중지한다.

sudo docker stop gitlab

컨테이너들 모두 살펴본다.

sudo docker ps -a

가장 최신 gitlab 컨테이너의 이름을 바꿔놓는다.

`sudo docker rename gitlab gitlab_14.3_backup'

컨테이너를 실행한다.

sudo docker run -d \
  --hostname URL_OF_MY_GITLAB \
  -p 8080:80 -p 8443:443 -p 49158:22 \
  --name gitlab \
  --restart always \
  -v /volume1/@docker/volumes/217a84837ed4ad139ca6da453e54bea098aba367f3120cdc67161d57b2409072/_data:/etc/gitlab \
  -v /volume1/docker/gitlab/logs:/var/log/gitlab \
  -v /volume1/@docker/volumes/ef707c6e62394d75d232a9b3c7ce72c90a34ca9b8b6d79239712a1e812e9e2a0/_data:/var/opt/gitlab \
  gitlab/gitlab-ce:14.10.5-ce.0

약 15~20분 정도 기다려야 하는데, 이게 귀찮으니...
다음 쉘 스크립트를 실행해서, 제대로 작동하는지를 10초마다 확인한다.

while true; do
  out=$(sudo docker ps)
  echo "$out"
  if echo "$out" | grep -q "(healthy)"; then
    echo "SUCCESS!!"
    break
  fi
  sleep 10
done

웹브라우저로 접속이 되는지 확인한다.

---

아주 종종, 여러가지 문제가 발생한다.

gitlab.rb 파일을 손봐서 gitlab reconfigure를 하거나,
사용자 비번이 먹히지 않아서 새로 손봐야 하거나,
gitaly 설정 파일 등을 손봐야 할 경우도 있다.

이럴 경우는 문제에 따라서 해결해야 하는 초식이 다르니,
chatGPT한테 해결책을 물어가면서 해결했다.