Docker 인스턴스 업그레이드

요약

Docker 기반 인스턴스를 최신 버전의 GitLab으로 업그레이드합니다. Docker 인스턴스를 업그레이드하기 전에 먼저 필수 정보를 읽고 필수 단계를 수행해야 합니다. Docker 기반 인스턴스를 업그레이드하려면: Docker Engine으로 설치된 GitLab 인스턴스를 업그레이드하려면:

Docker 기반 인스턴스를 최신 버전의 GitLab으로 업그레이드합니다.

사전 요구사항#

Docker 인스턴스를 업그레이드하기 전에 먼저 필수 정보를 읽고 필수 단계를 수행해야 합니다.

Docker 기반 인스턴스 업그레이드#

Docker 기반 인스턴스를 업그레이드하려면:

업그레이드 중에 유지 관리 모드 활성화를 고려합니다.
실행 중인 CI/CD 파이프라인 및 작업을 일시 중지합니다.
GitLab Runner를 대상 GitLab 버전과 동일한 버전으로 업그레이드합니다.
다음 중 하나를 사용하여 GitLab 자체를 업그레이드합니다:
- Docker Engine 사용.
- Docker Compose 사용.

업그레이드 후:

Docker Engine으로 업그레이드#

Docker Engine으로 설치된 GitLab 인스턴스를 업그레이드하려면:

백업을 생성합니다. 최소한 데이터베이스와 GitLab 시크릿 파일을 백업합니다.
실행 중인 컨테이너를 중지합니다:
```
sudo docker stop gitlab
```
기존 컨테이너를 제거합니다:
```
sudo docker rm gitlab
```
새 이미지를 가져옵니다:

   sudo docker pull gitlab/gitlab-ee:<version>-ee.0

   sudo docker pull gitlab/gitlab-ce:<version>-ce.0

GITLAB_HOME 환경 변수가 정의되었는지 확인합니다:
```
echo $GITLAB_HOME
```

이전에 지정한 옵션으로 컨테이너를 다시 생성합니다:

sudo docker run --detach \
--hostname gitlab.example.com \
--publish 443:443 --publish 80:80 --publish 22:22 \
--name gitlab \
--restart always \
--volume $GITLAB_HOME/config:/etc/gitlab \
--volume $GITLAB_HOME/logs:/var/log/gitlab \
--volume $GITLAB_HOME/data:/var/opt/gitlab \
--shm-size 256m \
gitlab/gitlab-ee:<version>-ee.0

첫 번째 실행 시 GitLab이 자동으로 재구성되고 업그레이드됩니다.

Docker Compose로 업그레이드#

Docker Compose로 설치된 GitLab 인스턴스를 업그레이드하려면:

백업을 생성합니다. 최소한 데이터베이스와 GitLab 시크릿 파일을 백업합니다.
docker-compose.yml을 편집하고 가져올 버전을 변경합니다.
최신 릴리스를 다운로드하고 GitLab 인스턴스를 업그레이드합니다:
```
docker compose pull
docker compose up -d
```