Git•
GitLab 업데이트 가이드 (Docker Compose)
GitLab의 최신 보안 패치와 신규 기능을 적용하기 위한 업데이트 절차를 안내해 드립니다. 본 가이드는 Docker Compose 환경에서 설치된 경우를 기준으로 작성되었습니다.
1. 업데이트 확인
먼저 현재 운영 중인 버전보다 높은 버전이 있는지 확인해야 합니다.
TIP
Docker Hub - GitLab CE 페이지를 방문하여 최신 릴리스 태그를 확인할 수 있습니다.
2. 버전 정보 수정
서버에 접속하여 GitLab 설정 파일 내의 이미지 버전을 업데이트합니다.
- GitLab이 설치된 경로로 이동합니다.
cd /services/gitlab
IMPORTANT
설정 파일 수정 및 컨테이너 재시작 작업을 위해 반드시 root 권한이 있는 계정으로 진행해 주세요.
-
vim또는 사용하시는 텍스트 에디터로compose.yaml파일을 엽니다.vim compose.yaml -
services > web > image항목을 확인하여 버전 태그를 최신 버전으로 변경한 후 저장합니다.
services:
web:
# 변경 전: gitlab/gitlab-ce:18.11.1-ce.0
# 변경 후: 최신 버전 태그 입력
image: 'gitlab/gitlab-ce:18.11.2-ce.0'
container_name: 'gitlab'
restart: always
networks:
- default
- net-nginx
3. 업데이트 적용 및 재시작
수정된 설정을 바탕으로 최신 이미지를 반영합니다.
업데이트 프로세스
graph LR
A[설정 파일 수정] --> B[이미지 다운로드]
B --> C[컨테이너 재구성]
C --> D[데이터 마이그레이션]
D --> E[완료]
실행 명령어
# 1. 수정된 설정에 따른 새 이미지 다운로드
docker compose pull
# 2. 컨테이너 백그라운드 재실행 (이미지 변경 시 자동 재생성)
docker compose up -d
CAUTION
업데이트가 시작되면 내부적으로 데이터베이스 마이그레이션[1]이 진행됩니다. 메이저 버전 업데이트 시에는 데이터 손실 위험이 있으므로 작업 전 반드시 백업을 수행하시기 바랍니다.
마이그레이션 규모에 따라 서비스 정상화까지 수 분에서 수십 분이 소요될 수 있습니다.
docker compose logs -f명령어로 진행 상황을 모니터링할 수 있습니다. ↩︎