[GitLab] GitLab CE 백업 및 복구

Gitlab Docker 컨테이너가 돌아가는 서버를 이관하는 과정에서 깃랩을 백업하고 복구하는 과정을 기록했다.

 

GitLab 컨테이너를 초기화하고 다시 설정하려는 경우, 코드 외에도 별도의 데이터들이 볼륨에 저장되기 때문에 이를 백업해두어야 한다. Gitlab 컨테이너는 데이터를 아래와 같은 경로에 저장한다.

• /var/opt/gitlab (DB 및 저장소)
• /etc/gitlab (설정 파일)
• /var/log/gitlab (로그)

일반적으로 컨테이너 내부의 데이터는 컨테이너가 삭제되면 함께 사라지지만 볼륨을 사용하면 데이터는 컨테이너와 독립적으로 유지된다. 볼륨은 컨테이너 내부 디렉토리를 호스트 컴퓨터의 특정 디렉토리와 연결하여 데이터를 저장하기 때문에, 이 경로들이 Docker 볼륨으로 마운트되어 있다면 데이터를 먼저 백업해야 한다. 

 

GitLab Docker 설정 확인

아래의 명령어를 통해 현재 컨테이너의 볼륨 설정을 확인할 수 있다.

나의 경우 /srv/gitlab 폴더에 모든 자료들이 마운트되어 있기 때문에 해당 경로를 백업해줬다.

 

백업

tar -cvzf gitlab-backup.tar.gz /srv/gitlab

 

복구

압축해제 후 GitLab Docker 이미지를 다시 pull받고 실행한다. 기존 백업해둔 설정을 재사용하기 위해 동일한 옵션으로 컨테이너를 실행해야 한다.

docker run --detach \
    --hostname [ip] \
    --publish 443:443 --publish 80:80 --publish 22:22 \
    --name gitlab-ce \
    --restart always \
    --volume /srv/gitlab/config:/etc/gitlab \
    --volume /srv/gitlab/logs:/var/log/gitlab \
    --volume /srv/gitlab/data:/var/opt/gitlab \
    gitlab/gitlab-ce