GitLab Enterprise Edition (EE) 활성화

Tier: Premium, Ultimate Offering: Self-managed

새로운 GitLab 인스턴스를 라이센스 없이 설치하면, Free 기능만 사용 가능합니다. GitLab Enterprise Edition (EE)에서 더 많은 기능을 활성화하려면, 활성화 코드로 인스턴스를 활성화하세요.

GitLab EE 활성화

사전 요건:

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

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

구독이 활성화됩니다.

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

여러 자체 관리 인스턴스에 대해 단일 활성화 코드 또는 라이센스 키를 사용할 수 있으며, 이는 사용자가:

  • 라이센스가 있는 프로덕션 인스턴스와 동일할 경우.
  • 라이센스가 있는 프로덕션 인스턴스의 부분 집합일 경우.

활성화 코드는 이러한 인스턴스에 대해 유효하며, 사용자가 그룹 및 프로젝트에서 어떻게 구성되었는지와는 관계가 없습니다.

확장 아키텍처의 경우

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

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

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

GitLab Geo의 경우

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

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

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

오프라인 환경의 경우

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

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

라이센스가 만료되면, 일부 기능이 잠금됩니다.

GitLab 에디션 확인

에디션을 확인하려면 GitLab에 로그인하고
Help ( ) > Help를 선택합니다. 페이지 상단에 GitLab 에디션과 버전이 나열됩니다.

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

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

문제 해결

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

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

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

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

  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가 포함된 경우, 인스턴스의 silent mode를 비활성화하세요.

문제를 확인할 수 없는 경우, GitLab 지원에 문의하세요 및 문제 설명에 GraphQL 응답을 제공하세요.

인스턴스를 활성화할 수 없는 연결 오류

인스턴스를 활성화할 때 GitLab 서버에 대한 연결을 방해하는 연결 문제에 직면할 수 있습니다.

이 문제는 다음과 같은 원인들로 인해 발생할 수 있습니다:

  • 방화벽 설정:

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

      curl --verbose "https://customers.gitlab.com/"
    • curl 명령이 오류를 반환하는 경우:
      • 방화벽 또는 프록시를 확인하세요. 도메인 https://customers.gitlab.com은 Cloudflare에 의해 전면에 있습니다. 방화벽 또는 프록시가 활성화 작동을 위해 Cloudflare의 IPv4 및 IPv6 범위로의 트래픽을 허용하는지 확인하세요.
      • gitlab.rb에서 서버를 가리키도록 프록시를 구성하세요.

      네트워크 관리자에게 기존 프록시나 방화벽을 변경하도록 요청하세요.

    • SSL 검사 장치가 사용되는 경우, 인스턴스의 /etc/gitlab/trusted-certs에 장치의 루트 CA 인증서를 추가한 후 gitlab-ctl reconfigure를 실행해야 합니다.
  • 고객 포털이 작동하지 않음:
    • 상태에서 고객 포털에 대한 활성 중단 여부를 확인하세요.
  • 오프라인 환경:

    • GitLab 서버와의 연결을 허용하도록 설정을 구성할 수 없는 경우, 영업 담당자에게 오프라인 라이센스를 요청하세요.

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