GitLab Enterprise Edition (EE) 활성화

Tier: Premium, Ultimate Offering: Self-Managed

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

GitLab EE 활성화

GitLab Enterprise Edition 14.1 이상에서는 인스턴스를 활성화하기 위해 활성화 코드가 필요합니다.

전제 조건:

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

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

  1. 구독 확인 이메일 또는 고객 포털의 Manage Purchases 페이지에서 24자 알파벳-숫자 조합의 활성화 코드를 복사합니다.
  2. GitLab Self-Managed 인스턴스에 로그인합니다.
  3. 왼쪽 사이드바에서 맨 아래 Admin Area를 선택합니다.
  4. Subscription을 선택합니다.
  5. Activation code에 활성화 코드를 붙여넣기합니다.
  6. 서비스 약관을 읽고 동의합니다.
  7. Activate를 선택합니다.

구독이 활성화됩니다.

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

한 개의 활성화 코드 또는 라이선스 키를 동일한 사용자 또는 그들의 하위 집합이 있는 여러 Self-Managed 인스턴스에 사용할 수 있습니다. 따라서 GitLab의 라이선스 된 본 사용자 인스턴스와 동일한 사용자 디렉터리을 가진 기타 인스턴스가 있는 경우 본 활성화 코드가 적용됩니다. 이는 사용자가 서로 다른 그룹과 프로젝트에 구성되어 있더라도 해당합니다.

스케일된 아키텍처를 위한 라이선스 업로드

스케일된 아키텍처에서는 라이선스 파일을 하나의 애플리케이션 인스턴스에만 업로드합니다. 라이선스는 데이터베이스에 저장되어 모든 애플리케이션 인스턴스로 복제되므로 모든 인스턴스에 라이선스를 업로드할 필요가 없습니다.

GitLab Geo에 대한 라이선스 업로드

GitLab Geo를 사용할 때에는 라이선스를 기본 Geo 인스턴스에만 업로드하면 됩니다. 라이선스는 데이터베이스에 저장되어 모든 인스턴스로 복제됩니다.

오프라인 환경이라면 라이선스 파일이나 키로 GitLab EE를 활성화하십시오(license_file.md).

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

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

GitLab 에디션 확인

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

GitLab Community Edition를 실행 중이라면 설치를 GitLab EE로 업그레이드할 수 있습니다. 자세한 내용은 에디션 간 업그레이드를 참조하십시오. GitLab Community Edition (CE)에서 EE로 업그레이드하는 데 도움이 필요하거나 질문이 있다면 GitLab 지원팀에 문의하세요.

문제 해결

구독을 추가하는 중에 오류가 발생했습니다

구독을 활성화할 때 발생할 수 있습니다. 오류 유형에 대한 자세한 정보를 얻으려면 Chrome 개발자 도구를 사용할 수 있습니다.

  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 Response에 only get, head, options, and trace methods are allowed in silent mode이 포함되어 있다면 인스턴스에 Silence mode enabled가 활성화되어 있으므로 비활성화해야 합니다.
  • 문제를 파악할 수 없는 경우 GitLab 지원팀에 연락하고 문제 설명에 GraphQL 응답을 제공하십시오.

연결 오류로 인한 인스턴스 활성화 실패

이 오류는 인스턴스를 활성화하기 위해 활성화 코드를 사용하는 도중 인스턴스가 GitLab 서버에 연결하지 못하는 경우에 발생합니다.

다음과 같은 이유로 연결 문제가 발생할 수 있습니다:

  • 방화벽 설정:
    • GitLab 인스턴스가 https://customers.gitlab.com의 443포트에 대한 암호화된 연결을 설정할 수 있는지 확인합니다. 
    curl --verbose "https://customers.gitlab.com/"
    • curl 명령이 오류를 반환하는 경우:
      • 방화벽 또는 프록시를 확인하십시오. 도메인 https://customers.gitlab.com은 클라우드플레어에 의해 패싱되며, 활성화를 위해 방화벽 또는 프록시에서 클라우드플레어의 IPv4 및 IPv6 범위로의 트래픽을 허용해야 합니다.
      • gitlab.rb에서 프록시를 구성하여 서버를 가리키도록 합니다.

      기존의 프록시 또는 방화벽에 변경을 가하려면 네트워크 관리자에게 연락하십시오.

    • SSL 검사 장치를 사용하는 경우 해당 장치의 루트 CA 인증서를 인스턴스의 /etc/gitlab/trusted-certs에 추가한 다음 gitlab-ctl reconfigure를 실행해야 합니다.
  • 고객 포털이 작동하지 않음:
    • 상태에서 고객 포털에 대한 현재 장애를 확인하십시오.
  • 오프라인 환경:

    • GitLab 서버에 연결할 수 있도록 환경을 구성할 수 없는 경우, 오프라인 라이선스를 요청하려면 판매 담당자에게 문의하십시오.

      판매 담당자를 찾는 데 도움이 필요한 경우 GitLab 지원팀에 문의하십시오.