패치 버전으로 소스 컴파일 인스턴스를 업데이트합니다.

필수 요건#

업데이트 전에:

1. 필수 정보를 읽고 필수 단계를 수행해야 합니다.
2. 소스 컴파일 인스턴스를 백업합니다.

패치 버전으로 소스 컴파일 인스턴스 업데이트#

패치 버전으로 소스 컴파일 인스턴스를 업데이트하려면:

1. 업데이트 중에 유지 관리 모드 활성화를 고려합니다.
2. 실행 중인 CI/CD 파이프라인 및 job을 일시 중지합니다.
3. GitLab Runner를 업그레이드하여 대상 GitLab 버전과 동일한 버전으로 맞춥니다.
4. 이 페이지의 지침에 따라 GitLab을 업데이트합니다.

업데이트 후:

1. 실행 중인 CI/CD 파이프라인 및 job의 일시 중지를 해제합니다.
2. 활성화된 경우 유지 관리 모드를 비활성화합니다.
3. 상태 확인을 실행합니다.

GitLab 서버 중지#

GitLab 서버를 중지하려면:

# systemd를 실행하는 시스템의 경우
sudo systemctl stop gitlab.target

# SysV init를 실행하는 시스템의 경우
sudo service gitlab stop

안정 브랜치에서 최신 코드 가져오기#

다음 명령에서 LATEST_TAG를 업데이트할 GitLab 태그로 바꿉니다. 예를 들어 v8.0.3.

1. 현재 버전을 확인합니다:

   cat VERSION
   

2. 사용 가능한 모든 태그 목록을 가져옵니다:

   git tag -l 'v*.[0-9]' --sort='v:refname'
   

3. 현재 주요 버전 및 마이너 버전에 맞는 패치 버전을 선택합니다.

4. 사용할 패치 버전의 코드를 체크아웃합니다:

   cd /home/git/gitlab
   
   sudo -u git -H git fetch --all
   sudo -u git -H git checkout -- Gemfile.lock db/structure.sql locale
   sudo -u git -H git checkout LATEST_TAG -b LATEST_TAG
   

라이브러리 설치 및 마이그레이션 실행#

라이브러리를 설치하고 마이그레이션을 실행하려면 다음 명령을 실행합니다:

cd /home/git/gitlab

# 설치 또는 이전 업그레이드 시 이미 수행하지 않은 경우
sudo -u git -H bundle config set --local deployment 'true'
sudo -u git -H bundle config set --local without 'development test kerberos'

# gem 업데이트
sudo -u git -H bundle install

# 선택 사항: 이전 gem 정리
sudo -u git -H bundle clean

# 데이터베이스 마이그레이션 실행
sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production

# 에셋 및 캐시 정리
sudo -u git -H bundle exec rake yarn:install gitlab:assets:clean gitlab:assets:compile cache:clear RAILS_ENV=production NODE_ENV=production NODE_OPTIONS="--max_old_space_size=4096"

새 패치 버전으로 GitLab Workhorse 업데이트#

새 패치 버전으로 GitLab Workhorse를 업데이트하려면:

cd /home/git/gitlab

sudo -u git -H bundle exec rake "gitlab:workhorse:install[/home/git/gitlab-workhorse]" RAILS_ENV=production

새 패치 버전으로 Gitaly 업데이트#

새 패치 버전으로 Gitaly를 업데이트하려면:

cd /home/git/gitlab

sudo -u git -H bundle exec rake "gitlab:gitaly:install[/home/git/gitaly,/home/git/repositories]" RAILS_ENV=production

새 패치 버전으로 GitLab Shell 업데이트#

새 패치 버전으로 GitLab Shell을 업데이트하려면:

cd /home/git/gitlab-shell

sudo -u git -H git fetch --all --tags
sudo -u git -H git checkout v$(</home/git/gitlab/GITLAB_SHELL_VERSION) -b v$(</home/git/gitlab/GITLAB_SHELL_VERSION)
sudo -u git -H make build

새 패치 버전으로 GitLab Pages 업데이트 (필요한 경우)#

GitLab Pages를 사용하는 경우 새 패치 버전으로 GitLab Pages를 업데이트합니다:

cd /home/git/gitlab-pages

sudo -u git -H git fetch --all --tags
sudo -u git -H git checkout v$(</home/git/gitlab/GITLAB_PAGES_VERSION)
sudo -u git -H make

gitlab-elasticsearch-indexer 설치 또는 업데이트#

gitlab-elasticsearch-indexer를 설치하거나 업데이트하려면 설치 지침을 따르세요.

GitLab 시작#

GitLab을 시작하려면 다음 명령을 실행합니다:

# systemd를 실행하는 시스템의 경우
sudo systemctl start gitlab.target
sudo systemctl restart nginx.service

# SysV init를 실행하는 시스템의 경우
sudo service gitlab start
sudo service nginx restart

GitLab 및 해당 환경 확인#

GitLab 및 해당 환경이 올바르게 구성되었는지 확인하려면 다음을 실행합니다:

cd /home/git/gitlab

sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production

더 철저한 확인을 위해 누락된 사항이 없는지 확인하려면:

sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production

백그라운드 마이그레이션 완료 확인#

백그라운드 마이그레이션 상태를 확인하고 완료되었는지 확인합니다.