이 문서는 GitLab의 Linux 패키지 버전 중 CE(커뮤니티 에디션)를 EE(엔터프라이즈 에디션)로 업그레이드하는 방법을 안내합니다.
업그레이드는 기존 CE 인스턴스 위에 EE Linux 패키지를 설치하는 방식으로 진행되며, 전체 인스턴스를 다시 설치할 필요는 없습니다.
GitLab 18.0 이상 버전부터는 CE에서 EE로 직접 전환이 가능합니다. 단, 안정적인 전환을 위해 동일한 버전 간 업그레이드(예: CE 18.1 → EE 18.1)를 권장합니다.
⚠️ 주의: CE에서 EE로 전환한 후에는 CE로 되돌리는 것이 어렵습니다. CE로 되돌아가 가는 경우 기술지원이 필요한 데이터베이스 이슈가 발생할 수 있습니다.
[EE 업그레이드 절차]
① GitLab 백업
: 업그레이드 전, 기존 GitLab 데이터를 반드시 백업하세요.
② 현재 설치된 GitLab 버전 확인
Debian/Ubuntu >>
CentOS/RHEL >>
③ EE 레포지토리 추가
: 아래 명령어는 현재 사용 중인 OS 버전에 맞는 레포지토리를 자동으로 설정합니다.
설치 스크립트에 대한 상세 내용은 Installation instruction에서 확인할 수 있습니다.
apt-get 또는 yum 대신 dpkg나 rpm을 사용하는 경우, 수동 다운로드 패키지 업그레이드 절차를 참고하시기 바랍니다.
Debian/Ubuntu >>
CentOS/RHEL >>
④ gitlab-ee 패키지 설치
: 패키지를 설치하면 기존 gitlab-ce 패키지는 자동으로 제거됩니다.
Debian/Ubuntu >>
CentOS/RHEL >>
⑤ 라이선스 추가
: 라이선스 등록을 통해 EE 기능을 활성화합니다.
⑥ CE 레포지토리 제거
: EE 전환 이후에는 CE 관련 레포지토리를 삭제해 불필요한 충돌을 방지합니다.
Debian/Ubuntu >>
CentOS/RHEL >>
⑦ Elasticsearch 연동 (선택)
: EE에서는 Elasticsearch와 연동하여 고급 검색 기능을 사용할 수 있습니다.
이제 GitLab EE로의 전환이 완료되었습니다!
최신 버전으로 인스턴스를 업그레이드하는 경우에는 GitLab 리눅스 패키지 업그레이드 가이드를 참고해주시기 바랍니다.
🔗 원문 참고: GitLab 공식 가이드
