GitLab Enterprise Edition (EE) 활성화하기

Tier: Premium, Ultimate Offering: Self-managed

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

GitLab EE 활성화

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

필수 사항:

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

활성화 코드를 사용하여 인스턴스를 활성화하려면:

  1. 활성화 코드(24자 알파벳 및 숫자 조합)를 다음 중 하나에서 복사하세요:
    • 구독 확인 이메일.
    • 구매 관리 페이지인 고객 포털.
  2. GitLab Self-managed 인스턴스에 로그인하세요.
  3. 왼쪽 사이드바에서 하단에서 관리자 영역을 선택하세요.
  4. 구독을 선택하세요.
  5. 활성화 코드에 활성화 코드를 붙여넣으세요.
  6. 서비스 약관을 읽고 승인하세요.
  7. 활성화를 선택하세요.

구독이 활성화됩니다.

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

하나의 활성화 코드 또는 라이선스 키를 동일한 사용자 또는 그들의 하위 집합이 있는 여러 Self-managed 인스턴스에 사용할 수 있습니다. 즉, GitLab의 라이선스를 보유한 프로덕션 인스턴스와 동일한 사용자 디렉터리으로 구성된 다른 인스턴스가 있다면, 사용자가 다른 그룹 및 프로젝트에 구성되어 있더라도 프로덕션 활성화 코드가 적용됩니다.

스케일 아키텍처에 대한 라이선스 업로드

스케일 아키텍처에서는 라이선스 파일을 한 응용 프로그램 인스턴스에만 업로드하세요. 라이선스는 데이터베이스에 저장되어 모든 응용 프로그램 인스턴스로 복제되므로 모든 인스턴스에 라이선스를 업로드할 필요가 없습니다.

GitLab Geo용 라이선스 업로드

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

오프라인 환경을 사용하는 경우, 라이선스 파일 또는 키로 GitLab EE를 활성화하세요.

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

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

GitLab 에디션 확인

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

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

문제 해결

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

구독을 추가하는 중에이 오류가 발생할 수 있습니다. 오류 유형에 대한 자세한 정보를 얻으려면 Chrome 개발자 도구를 사용할 수 있습니다.

  1. 브라우저에서 오른쪽 버튼을 클릭하고 검사를 선택하여 브라우저 개발자 도구를 엽니다.
  2. 브라우저 개발자 도구에서 네트워크 탭을 선택합니다.
  3. GitLab에서 활성화 코드를 다시 시도합니다.
  4. 브라우저 개발자 도구에서 네트워크 탭에서 graphql 항목을 선택합니다.
  5. 응답 탭을 선택합니다.

다음과 유사한 오류가 있어야 문제를 확인할 수 있습니다. 

[{"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이 포함되어 있으면 인스턴스에 Silence mode가 활성화되어 있으며 비활성화해야 합니다.
  • 문제를 파악할 수 없는 경우, GitLab 지원팀에 문의하고 문제 설명에 GraphQL 응답을 제공하세요.

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

이 오류는 인스턴스를 활성화하려고 할 때 활성화 코드를 사용하지만 인스턴스가 GitLab 서버에 연결할 수 없을 때 발생합니다.

다음과 같은 이유로 연결에 문제가 있을 수 있습니다:

  • 방화벽 설정:
    • https://customers.gitlab.com에서 포트 443으로 암호화된 연결을 설정할 수 있는지 확인하세요. 
    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를 실행해야 합니다.
  • Customers Portal이 작동하지 않음:
    • 상태에서 고객 포털에 대한 활성 장애를 확인하세요.
  • 오프라인 환경:

    • GitLab 서버에 연결하도록 설정할 수 없는 경우, 오프라인 라이선스를 요청하려면 영업 담당자에게 문의하세요.

      영업 담당자에게 연락하여 판매 대표를 찾는 데 도움을 요청하려면 GitLab 지원팀에 연락하세요.