- 사전 요구 사항
- JiHu Edition 패키지 설치 또는 업데이트
- GitLab Enterprise Edition에서 JiHu Edition으로 업데이트
- 기존으로 GitLab Enterprise Edition으로 돌아가기
JiHu Edition
참고: 이 섹션은 중국 시장의 고객인 경우에만 관련이 있습니다.
GitLab은 기술을 새로운 중국 독립 회사 인 지후(JiHu)에 라이선스를 부여했습니다. 이 독립 회사는 GitLab의 완전한 DevOps 플랫폼의 도입을 지원하고 중국에서의 GitLab 커뮤니티 및 오픈 소스 기여를 촉진할 것입니다.
자세한 정보는 블로그 글 공지 및 FAQ를 참조하십시오.
사전 요구 사항
GitLab JiHu Edition을 설치하기 전에 시스템 요구 사항을 검토하는 것이 매우 중요합니다. 시스템 요구 사항에는 GitLab을 지원하기 위한 최소 하드웨어, 소프트웨어, 데이터베이스 및 추가 요구 사항에 대한 세부 정보가 포함되어 있습니다.
지후와 계약을 체결한 후, 지후 대표가 연락하여 설치 프로세스의 일환으로 사용할 라이선스를 공급해줄 것입니다.
JiHu Edition 패키지 설치 또는 업데이트
참고:
처음 설치하는 경우, 우선 EXTERNAL_URL="<GitLab URL>"
변수를 전달하여 원하는 도메인 이름을 설정해야합니다. 설치는 해당 URL에서 GitLab을 자동으로 구성하고 시작합니다. HTTPS를 활성화하려면 인증서를 지정하기 위해 추가 구성이 필요합니다.
JiHu Edition 패키지를 설치하거나 업데이트하는 자세한 내용은 GitLab JiHu Edition 설치 페이지를 참조하십시오.
초기 암호 설정 및 라이선스 적용
GitLab JiHu Edition을 처음 설치하면 암호 재설정 화면으로 리디렉션됩니다. 초기 관리자 계정의 암호를 제공하면 다시 로그인 화면으로 리디렉션됩니다. 로그인에는 기본 계정의 사용자 이름 root
를 사용합니다.
자세한 지침은 설치 및 구성을 참조하십시오.
또한 서버의 GitLab 관리 패널로 이동하여 JiHu Edition 라이선스 파일을 업로드할 수 있습니다.
GitLab Enterprise Edition에서 JiHu Edition으로 업데이트
Omnibus GitLab 패키지를 사용하여 설치된 기존 GitLab Enterprise Edition (EE) 서버를 GitLab JiHu Edition(JH)로 업데이트하려면 EE 위에 JiHu Edition(JH) 패키지를 설치하면 됩니다.
사용 가능한 옵션은 다음과 같습니다:
- (권장) EE의 동일한 버전에서 JH로 업데이트합니다.
- 지원되는 업그레이드 경로(예: EE 13.5.4에서 JH 13.10.0으로 업데이트)를 통해 EE의 낮은 버전에서 JH의 높은 버전으로 업데이트합니다.
다음 단계에서는 동일한 버전을 업데이트하는 것으로 가정합니다(예: EE 13.10.0에서 JH 13.10.0으로 업데이트).
EE를 JH로 업데이트하려면:
-
deb/rpm 패키지를 사용하여 GitLab을 설치한 경우:
- 백업을 수행합니다.
-
현재 설치된 GitLab 버전을 찾습니다:
Debian/Ubuntu의 경우
sudo apt-cache policy gitlab-ee | grep Installed
출력은
Installed: 13.10.0-ee.0
과 유사해야 하며 설치된 버전은13.10.0-ee.0
입니다.CentOS/RHEL의 경우
sudo rpm -q gitlab-ee
출력은
gitlab-ee-13.10.0-ee.0.el8.x86_64
와 유사해야 하며 설치된 버전은13.10.0-ee.0
입니다. -
이전 단계에서 참고한 것과 동일한 버전을 선택하여 운영 체제에 따라 JiHu Edition 패키지 설치를 수행하고,
<url>
을 패키지 URL로 바꿉니다. -
GitLab을 다시 구성합니다:
sudo gitlab-ctl reconfigure
-
서버의 GitLab 관리 패널로 이동하여 (
/admin/license/new
) JiHu Edition 라이선스 파일을 업로드합니다. JH로 업데이트하기 전에 이미 EE 라이선스가 설치된 경우, JH가 설치되면 자동으로 EE 라이선스가 비활성화됩니다. -
GitLab이 예상대로 작동하는지 확인한 후 이전의 Enterprise Edition 저장소를 제거합니다:
Debian/Ubuntu의 경우
sudo rm /etc/apt/sources.list.d/gitlab_gitlab-ee.list
CentOS/RHEL의 경우
sudo rm /etc/yum.repos.d/gitlab_gitlab-ee.repo sudo dnf config-manager --disable gitlab_gitlab-ee
-
Docker를 사용하여 GitLab을 설치한 경우:
-
Docker 업데이트 가이드를 따르고
gitlab/gitlab-ee:latest
를 다음과 같이 바꿉니다:registry.gitlab.com/gitlab-jh/omnibus-gitlab/gitlab-jh:<version>
여기서
<version>
은 현재 설치된 GitLab 버전이며 다음과 같이 찾을 수 있습니다:sudo docker ps | grep gitlab/gitlab-ee | awk '{print $2}'
출력은
gitlab/gitlab-ee:13.10.0-ee.0
과 유사해야 하며 이 경우<version>
은13.10.0
입니다. -
서버의 GitLab 관리 패널로 이동하여 (
/admin/license/new
) JiHu Edition 라이선스 파일을 업로드합니다. JH로 업데이트하기 전에 이미 EE 라이선스가 설치된 경우, JH가 설치되면 자동으로 EE 라이선스가 비활성화됩니다.
-
여기까지입니다! 이제 GitLab JiHu Edition을 사용할 수 있습니다! 더 높은 버전으로 업데이트하려면 지후 패키지 설치 또는 업데이트를 참조하십시오.
기존으로 GitLab Enterprise Edition으로 돌아가기
JiHu Edition 설치를 GitLab Enterprise Edition (EE)으로 다운그레이드하려면 현재 설치된 것 위에 Enterprise Edition 패키지와 동일한 버전을 설치하십시오.
GitLab EE의 선호하는 설치 방법에 따라 다음 중 하나를 수행하십시오:
- 공식 GitLab 패키지 저장소를 사용하여 GitLab EE를 설치, 또는
- GitLab EE 패키지를 다운로드하여 수동으로 설치합니다.