GitLab Enterprise Edition (EE) 활성화

Tier: Premium, Ultimate Offering: Self-Managed

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

GitLab EE 활성화

필수 사항:

  • 구독을 구매해야 합니다.
  • GitLab Enterprise Edition (EE)를 실행 중이어야 합니다.
  • 인스턴스가 인터넷에 연결되어 있어야 합니다.

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

  1. 활성화 코드(숫자와 알파벳의 24자리 문자열)를 다음 중 하나에서 복사합니다:
  2. GitLab self-managed 인스턴스에 로그인합니다.
  3. 왼쪽 사이드바에서 맨 아래 관리자를 선택합니다.
  4. 구독을 선택합니다.
  5. 활성화 코드를 붙여넣기합니다.
  6. 약관을 읽고 동의합니다.
  7. 활성화를 선택합니다.

구독이 활성화됩니다.

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

라이선스된 본 프로덕션 인스턴스와 동일한 사용자 또는 그 사용자들의 하위 집합인 경우 단일 활성화 코드 또는 라이선스 키를 여러 self-managed 인스턴스에 사용할 수 있습니다.

이 사용자들이 어떻게 그룹과 프로젝트에 구성되었는지에 관계없이 이 코드는 해당 인스턴스에 유효합니다.

규모 확장 아키텍처에 대한 내용

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

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

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

GitLab Geo에 대한 내용

GitLab Geo를 사용하는 경우 인스턴스를 활성화하려면:

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

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

오프라인 환경에 대한 내용

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

인스턴스 활성화에 질문이 있거나 지원이 필요한 경우, GitLab 지원팀에 문의하세요.

라이선스 만료되면 발생하는 사항에 대해 알아보세요.

GitLab 에디션 확인

GitLab에 로그인하여 도움말 () > 도움말을 선택하여 에디션을 확인하세요. 페이지 상단에 GitLab 에디션과 버전이 표시됩니다.

GitLab Community Edition (CE)를 실행 중이라면 설치를 GitLab EE로 업그레이드할 수 있습니다. 자세한 내용은 에디션 간 업그레이드를 참조하세요.

질문이 있거나 도움이 필요한 경우, GitLab 지원팀에 문의하세요.

문제 해결

자체 관리 인스턴스에서 유료 구독 기능을 활성화하는 중에 다음 문제가 발생할 수 있습니다.

오류: 구독 추가 중 오류 발생

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

오류에 대한 자세한 내용은 브라우저의 개발자 도구를 사용하여 확인할 수 있습니다:

  1. 개발자 도구를 열려면 페이지에서 마우스 오른쪽 버튼을 클릭한 후 검사를 선택합니다.
  2. 네트워크 탭을 선택합니다.
  3. GitLab에서 활성화 코드를 다시 시도합니다.
  4. 네트워크 탭에서 graphql 항목을 선택합니다.

  5. 응답 탭을 선택하고 다음과 비슷한 오류를 확인합니다: 

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

이 문제를 해결하려면:

  • GraphQL 응답에 silent mode에서는 get, head, options 및 trace 메서드만 허용됩니다가 포함된 경우 인스턴스의 silent mode를 비활성화하세요.

이 문제를 확인할 수 없는 경우, 문제에 대한 설명과 함께 GitLab 지원팀에 연락하여 GraphQL 응답을 제공하세요.

연결 오류로 인한 인스턴스 활성화 불가

인스턴스를 활성화하는 도중 GitLab 서버에 연결되지 못하는 연결 오류가 발생할 수 있습니다. 다음에 의해 발생할 수 있습니다:

  • 방화벽 설정:

    • GitLab 인스턴스가 https://customers.gitlab.com의 443포트에서 암호화된 연결을 설정할 수 있는지 확인하려면 다음 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를 실행하세요.
  • Customers Portal이 작동되지 않음:
    • 상태에서 Customers Portal에 대한 활성 장애를 확인하세요.
  • 오프라인 환경:

    • GitLab 서버에 연결을 허용하도록 설정할 수 없는 경우, 판매 담당자에게 오프라인 라이선스를 요청하는 방법에 대해 문의하여야 합니다.

      판매 담당자를 찾는 데 도움이 필요하면 GitLab 지원팀에 문의하세요.