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

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 버전은 커뮤니티 에디션에서 엔터프라이즈 에디션으로 업그레이드할 때 추가 단계를 수행해야 할 수 있습니다. 그러한 추가 단계가 필요한 경우 해당 버전별로 나열됩니다.