자체 컴파일 설치용 패치 버전의 범용 업데이트 가이드
Tier: Free, Premium, Ultimate
Offering: Self-Managed
설치할 버전 선택
GitLab 태그(버전)에서 이 업데이트 가이드를 보고자 하는 GitLab 버전의 태그(버전)에서 확인하세요.
대부분의 경우, 이는 rc가 포함되지 않은 가장 높은 번호의 프로덕션 태그여야 합니다.
GitLab의 왼쪽 상단의 버전 드롭다운 목록에서 태그를 선택할 수 있습니다.
0. 백업
상황이 나빠질 경우를 대비하여 백업을 만드세요. 설치 방법에 따라 백업 명령이 달라집니다. GitLab 백업 및 복원 문서를 확인하세요.
1. 서버 중지
# systemd가 실행 중인 시스템의 경우
sudo systemctl stop gitlab.target
# SysV init가 실행 중인 시스템의 경우
sudo service gitlab stop
2. 안정 브랜치의 최신 코드 가져오기
아래 명령어에서 LATEST_TAG를, 예를 들어 v8.0.3와 같은 최신 GitLab 태그로 바꿔서 업데이트할 수 있는 버전을 선택하세요. 모든 태그의 목록을 보려면 git tag -l 'v*.[0-9]' --sort='v:refname' 명령을 사용하세요. 현재 버전은 cat VERSION으로 확인하세요.
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
3. 라이브러리, 마이그레이션 등 설치
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'
# 젬 업데이트
sudo -u git -H bundle install
# 선택 사항: 이전 젬 정리
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"
4. 해당 버전에 맞는 GitLab Workhorse 업데이트
cd /home/git/gitlab
sudo -u git -H bundle exec rake "gitlab:workhorse:install[/home/git/gitlab-workhorse]" RAILS_ENV=production
5. 해당 버전에 맞는 Gitaly 업데이트
cd /home/git/gitlab
sudo -u git -H bundle exec rake "gitlab:gitaly:install[/home/git/gitaly,/home/git/repositories]" RAILS_ENV=production
6. 해당 버전에 맞는 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
7. 해당 버전에 맞는 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
8. gitlab-elasticsearch-indexer 설치/업데이트
Tier: Premium, Ultimate
Offering: Self-Managed
설치 지침을 따르세요.
9. 어플리케이션 시작
# systemd가 실행 중인 시스템의 경우
sudo systemctl start gitlab.target
sudo systemctl restart nginx.service
# SysV init가 실행 중인 시스템의 경우
sudo service gitlab start
sudo service nginx restart
10. 어플리케이션 상태 확인
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
모든 항목이 초록색인 경우, 축하합니다! 업그레이드가 완료되었습니다.
11. 백그라운드 마이그레이션 완료 확인
백그라운드 마이그레이션 상태를 확인하고 완료되었는지 확인하세요.
도움말