라이선스 없이 새 GitLab 인스턴스를 설치하면 무료 기능만 활성화됩니다. GitLab Enterprise Edition(EE)에서 더 많은 기능을 활성화하려면 활성화 코드로 인스턴스를 활성화하세요.

GitLab EE 활성화#

사전 요구 사항:

• 구독.
• GitLab Enterprise Edition(EE).
• 인스턴스가 인터넷에 연결되어 있어야 합니다.
• 관리자 액세스 권한.

활성화 코드로 인스턴스를 활성화하려면:

1. 다음 중 하나에서 24자 영숫자 문자열인 활성화 코드를 복사합니다:
   • 구독 확인 이메일.
   • 고객 포털의 Manage Purchases 페이지.
2. 인스턴스에 로그인합니다.
3. 오른쪽 상단 모서리에서 Admin을 선택합니다.
4. 왼쪽 사이드바에서 Subscription을 선택합니다.
5. Activation code에 활성화 코드를 붙여넣습니다.
6. 서비스 약관을 읽고 동의합니다.
7. Activate를 선택합니다.

구독이 활성화됩니다.

여러 인스턴스에 하나의 활성화 코드 사용#

사용자가 다음과 같은 경우 여러 GitLab Self-Managed 인스턴스에 단일 활성화 코드 또는 라이선스 키를 사용할 수 있습니다:

• 라이선스가 부여된 프로덕션 인스턴스와 동일합니다.
• 라이선스가 부여된 프로덕션 인스턴스의 하위 집합입니다.

사용자가 그룹 및 프로젝트에서 구성되는 방식에 관계없이 이러한 인스턴스에 활성화 코드가 유효합니다.

확장 아키텍처의 경우#

확장 아키텍처에서 인스턴스를 활성화하려면:

• 라이선스 파일을 애플리케이션 인스턴스 하나에만 업로드합니다.

라이선스는 데이터베이스에 저장되고 모든 인스턴스에 복제됩니다.

GitLab Geo의 경우#

GitLab Geo를 사용할 때 인스턴스를 활성화하려면:

• 기본 Geo 인스턴스에 라이선스를 업로드합니다.

라이선스는 데이터베이스에 저장되고 모든 인스턴스에 복제됩니다.

오프라인 환경의 경우#

오프라인 환경에 인스턴스를 활성화하려면:

• 라이선스 파일 또는 키로 GitLab EE를 활성화합니다.

인스턴스 활성화에 관한 질문이 있거나 도움이 필요하면 GitLab 지원에 문의하세요.

라이선스가 만료되면 일부 기능이 잠깁니다.

GitLab 에디션 확인#

에디션을 확인하려면 GitLab에 로그인하고 Help ([question-o]) > Help를 선택합니다. GitLab 에디션과 버전이 페이지 상단에 표시됩니다.

GitLab Community Edition(CE)을 실행 중인 경우 설치를 GitLab EE로 업그레이드할 수 있습니다. 자세한 내용은 다른 업그레이드 경로를 참조하세요.

질문이 있거나 도움이 필요하면 GitLab 지원에 문의하세요.

문제 해결#

GitLab Self-Managed 인스턴스에서 유료 구독 기능을 활성화할 때 다음과 같은 문제가 발생할 수 있습니다.

오류: An error occurred while adding your subscription#

이 문제는 활성화 코드를 입력한 후 발생할 수 있습니다.

오류에 대한 자세한 내용을 찾으려면 브라우저 개발자 도구를 사용할 수 있습니다:

1. 개발자 도구를 열려면 페이지를 마우스 오른쪽 버튼으로 클릭하고 Inspect를 선택합니다.

2. Network 탭을 선택합니다.

3. GitLab에서 활성화 코드를 다시 시도합니다.

4. Network 탭에서 graphql 항목을 선택합니다.

5. Response 탭을 선택하고 다음과 유사한 오류를 확인합니다:

   [{"data":{"gitlabSubscriptionActivate":{"errors":["<error> returned=1 errno=0 state=error: <error>"],"license":null,"__typename":"GitlabSubscriptionActivatePayload"}}}]
   

문제를 해결하려면:

• GraphQL 응답에 only get, head, options, and trace methods are allowed in silent mode가 포함된 경우 인스턴스의 사일런트 모드를 비활성화합니다.

문제를 확인할 수 없으면 GitLab 지원에 문의하고 이슈 설명에 GraphQL 응답을 제공합니다.

오류: Cannot activate instance due to a connectivity issue#

인스턴스를 활성화할 때 GitLab 서버 연결을 방해하는 연결 문제가 발생할 수 있습니다. 이는 다음으로 인해 발생할 수 있습니다:

• 방화벽 설정:

  • GitLab 인스턴스가 포트 443에서 https://customers.gitlab.com에 대한 암호화된 연결을 설정할 수 있는지 확인하려면 다음 curl 명령을 사용합니다:

    curl --verbose "https://customers.gitlab.com/"
    

  • curl 명령이 오류를 반환하면 다음 중 하나를 수행합니다:

    • 방화벽 또는 프록시를 확인합니다. 도메인 https://customers.gitlab.com은 Cloudflare에 의해 앞단에 위치합니다. 방화벽 또는 프록시가 활성화가 작동하도록 Cloudflare IPv4 및 IPv6 범위에 대한 트래픽을 허용하는지 확인합니다.
    • gitlab.rb에서 서버를 가리키도록 프록시 구성합니다.

    기존 프록시 또는 방화벽을 변경하려면 네트워크 관리자에게 문의합니다.

  • SSL 검사 어플라이언스를 사용하는 경우 어플라이언스의 루트 CA 인증서를 인스턴스의 /etc/gitlab/trusted-certs에 추가한 다음 gitlab-ctl reconfigure를 실행해야 합니다.

• 고객 포털이 작동하지 않음:
  • 상태에서 고객 포털의 활성 중단을 확인합니다.
• 오프라인 환경:
  • DNS 설정을 확인합니다.
  • 다음 중 하나에 문의합니다:
    • 오프라인 라이선스를 요청하려면 GitLab 영업 담당자.
    • 네트워크 연결 문제 해결 지원을 요청하려면 GitLab 지원.