커뮤니티 에디션에서 자체 컴파일 설치를 위한 엔터프라이즈 에디션으로 업그레이드하기

Tier: Free, Premium, Ultimate Offering: Self-Managed
note
과거에는 커뮤니티 에디션에서 엔터프라이즈 에디션으로 업그레이드하기 위해 별도의 문서를 사용했습니다. 이러한 문서는 Enterprise Edition의 소스 코드의 doc/update 디렉터리에서 찾을 수 있습니다.

버전만 업그레이드하려면(예: 11.8에서 11.9로) GitLab 에디션을 변경하지 않고 업그레이드하려면, 소스에서 업그레이드 문서를 참조하세요.

일반 업그레이드 단계

이 가이드는 올바르게 구성되고 테스트된 GitLab 커뮤니티 에디션 설치를 가정합니다. 문제가 발생하거나 질문이 있으면 support@gitlab.com으로 문의하십시오.

모든 예에서 EE_BRANCH을 사용 중인 버전에 대한 엔터프라이즈 에디션 브랜치로, CE_BRANCH를 커뮤니티 에디션 브랜치로 대체합니다. 브랜치 이름은 엔터프라이즈 에디션의 경우 major-minor-stable-ee, 커뮤니티 에디션의 경우 major-minor-stable 형식을 사용합니다. 예를 들어 11.8.0의 경우 다음 브랜치를 사용합니다:

  • 엔터프라이즈 에디션: 11-8-stable-ee
  • 커뮤니티 에디션: 11-8-stable

0. 백업

문제가 발생하는 경우를 대비하여 백업을 만듭니다: 

cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production

1. 서버 중지 

sudo service gitlab stop

2. 엔터프라이즈 에디션 코드 가져오기 

cd /home/git/gitlab
sudo -u git -H git remote add -f ee https://gitlab.com/gitlab-org/gitlab.git
sudo -u git -H git checkout EE_BRANCH

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 RAILS_ENV=production NODE_ENV=production NODE_OPTIONS="--max_old_space_size=4096"

# 캐시 정리
sudo -u git -H bundle exec rake cache:clear RAILS_ENV=production

4. gitlab-elasticsearch-indexer 설치

Tier: Premium, Ultimate Offering: Self-Managed

설치 지침을 따르세요.

5. 애플리케이션 시작 

sudo service gitlab start
sudo service nginx restart

6. 애플리케이션 상태 확인

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

모든 항목이 녹색이면, 축하합니다! 업그레이드가 완료되었습니다.

문제가 발생했나요? 이전 버전(커뮤니티 에디션)으로 복구하세요.

1. 이전 버전으로 코드 되돌리기 

cd /home/git/gitlab
sudo -u git -H git checkout CE_BRANCH

2. 백업에서 복원 

cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:backup:restore RAILS_ENV=production

버전별 단계

GitLab의 특정 버전에는 커뮤니티 에디션에서 엔터프라이즈 에디션으로 업그레이드 시 추가 단계가 필요할 수 있습니다. 이러한 추가 단계가 필요한 경우 해당 버전별로 나열됩니다.