- Self-Managed형 구독 획득
- 사용자 총계 보기
- 사용자 및 구독 좌석 관리 팁
- 구독 데이터 동기화
- 구독 정보 보기
- 라이선스 사용량 내보내기
- 구독 갱신
- 구독 티어 업그레이드
- 구독의 연락처 추가 또는 변경
- 구독 만료
- 라이선스 파일 또는 키를 활성화
- 지원 연락처
- 리포지터리
- 문제 해결
GitLab Self-Managed형 구독
GitLab을 구독한 후에 Self-Managed형 구독의 세부 정보를 관리할 수 있습니다.
Self-Managed형 구독 획득
GitLab을 GitLab Self-Managed형 설치에 구독하려면:
- 고객 포털로 이동하여 GitLab Self-Managed형 요금제를 구매합니다.
- 구매 후에 활성화 코드가 고객 포털 계정과 연결된 이메일 주소로 전송됩니다. 이 코드를 GitLab 인스턴스에 추가해야 합니다.
구독 좌석
GitLab Self-Managed형 구독은 혼합 모델을 사용합니다. 구독 기간 동안 활성화된 사용자 수에 따라 구독 요금을 지불합니다. 오프라인이나 닫힌 네트워크에 있는 인스턴스의 경우, GitLab Self-Managed형 설치의 동시 사용자 수를 매 분기마다 확인합니다.
인스턴스가 분기별 사용 보고서를 생성할 수없는 경우 기존 정산 모델이 사용됩니다. 분기별 요금 청구는 분기별 사용 보고서 없이 불가능합니다.
사용자 총계 보기
인스턴스의 사용자 수를 확인하여 구독으로 지불한 사용자 수를 초과하는지 확인할 수 있습니다.
- 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
- 사용자를 선택합니다.
사용자 디렉터리이 표시됩니다.
과금 사용자
과금 사용자는 구독으로 구매한 구독 좌석 수에 포함됩니다.
사용자는 다음과 같은 경우 과금 사용자로 계산되지 않습니다:
- 비활성화되었거나 차단되었을 경우
- 승인 대기 중인 경우
- Self-Managed형 최종 구독이나 어떠한 GitLab.com 구독의 최소한의 액세스 권한만 가지고 있는 경우
- 최종 구독에서 게스트 또는 최소한의 액세스 권한을 가지고 있는 경우
- 최종 구독에서 프로젝트나 그룹 멤버십이 없는 경우
- 계정이 GitLab에서 생성한 서비스 계정인 경우:
- Ghost 사용자
- 다음과 같은 봇:
과금 사용자 수는 관리 영역에서 하루에 한 번 보고됩니다.
최대 사용자
최대 사용자 수는 현재 라이선스 기간 동안의 과금 사용자 수의 가장 높은 피크를 반영합니다.
초과 구독 사용자
초과 구독 사용자 수는 현재 구독 기간을 기준으로 허용된 수를 초과하는 사용자 수를 보여줍니다. 이 숫자는 현재 구독 기간을 반영합니다.
예를 들어:
- 구독이 100 명의 사용자를 허용하고
- 최대 사용자가 150 명인 경우,
이 값은 50입니다.
최대 사용자 값이 100 이하이면, 이 값은 0입니다.
체험 라이선스의 경우 초과 구독 사용자는 항상 0으로 표시됩니다.
GitLab 인스턴스에 라이선스로 허용된 사용자보다 더 많은 사용자를 추가하는 경우, 추가 사용자에 대한 결제는 갱신 시점에 지불해야 합니다.
갱신 프로세스 중에 이러한 사용자를 추가하지 않으면 라이선스 키가 작동하지 않습니다.
무료 게스트 사용자
최종 티어에서 게스트 역할이 할당된 사용자는 좌석을 소비하지 않습니다. 사용자는 인스턴스의 다른 곳에 어떠한 역할도 할당되지 않아야 합니다.
- 프로젝트가 비공개 또는 내부적인 경우, 게스트 역할을 가진 사용자는 일련의 권한을 가집니다.
- 프로젝트가 공개적인 경우, 게스트 역할을 가진 모든 사용자는 프로젝트에 액세스할 수 있습니다.
- 사용자의 가장 높은 할당된 역할은 동기화되어 일부 시간이 걸릴 수 있습니다.
사용자 및 구독 좌석 관리 팁
사용자 수를 구독 좌석 수와 비교하여 관리하는 것은 어려울 수 있습니다:
- LDAP 통합이 활성화된 경우 구성된 도메인 사용자 누구나 GitLab 계정에 가입할 수 있습니다. 이로 인해 갱신 시 예상치 못한 청구가 발생할 수 있습니다.
- 인스턴스에서 가입이 활성화된 경우 인스턴스에 액세스할 수 있는 누구나 계정에 등록할 수 있습니다.
GitLab에는 사용자 수를 관리하는 데 도움이 되는 몇 가지 기능이 있습니다:
- 새 가입자에 대한 관리자 승인 필요 옵션을 활성화합니다.
-
block_auto_created_users를 활성화하여 새로운 가입자에 대해 LDAP 또는 OmniAuth로 지정합니다. - 사용자 캡 옵션을 활성화합니다.
- 새 가입 비활성화를 활성화하고 대신 새 사용자를 매뉴얼으로 관리합니다.
- 사용자 통계 페이지에서 역할 별 사용자를 분류하세요.
구독 데이터 동기화
구독 데이터는 Self-Managed형 인스턴스와 GitLab 간에 자동으로 동기화될 수 있습니다. 구독 데이터 동기화를 활성화하려면 다음이 필요합니다:
- GitLab Enterprise Edition (EE), 14.1 버전 이상.
- 인터넷에 연결되어 있으며 오프라인 환경이 아닌 경우.
- 활성화된 인스턴스에 활성화 코드가 있어야 합니다.
인스턴스가 활성화되고 데이터가 동기화되면 다음 프로세스가 자동으로 실행됩니다:
- 분기별 구독 정산.
- 구독 갱신.
- 좌석 추가나 GitLab 티어 업그레이드와 같은 구독 업데이트.
약 03:00 UTC에 매일 동기화 작업이 구독 데이터를 고객 포털로 전송합니다. 따라서 업데이트 및 갱신은 즉시 적용되지 않을 수 있습니다.
이 데이터는 암호화 된 HTTPS 연결을 통해 customers.gitlab.com의 포트 443으로 안전하게 전송됩니다. 작업이 실패하면 약 17시간 동안 최대 12회 재시도합니다.
구독 데이터
매일 동기화 작업은 다음 정보를 고객 포털로 전송합니다:
- 날짜
- 타임스탬프
- 라이선스 키
- 회사 이름 (라이선스 키 내에서 암호화됨)
- 라이선스 보유자 이름 (라이선스 키 내에서 암호화됨)
- 라이선스 보유자 이메일 (라이선스 키 내에서 암호화됨)
- 역사적 최대 사용자 수
- 과금 사용자 수
- GitLab 버전
- 호스트명
- 인스턴스 ID
라이선스 동기화 요청의 예시:
{
"gitlab_version": "14.1.0-pre",
"timestamp": "2021-06-14T12:00:09Z",
"date": "2021-06-14",
"license_key": "eyJkYXRhIjo..(중략)",
"max_historical_user_count": 75,
"billable_users_count": 75,
"hostname": "gitlab.example.com",
"instance_id": "9367590b-82ad-48cb-9da7-938134c29088"
}
구독 세부 정보 매뉴얼 동기화
언제든지 구독 세부 정보를 매뉴얼으로 동기화할 수 있습니다.
- 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
- 구독을 선택합니다.
- 구독 세부 정보 섹션에서 구독 세부 정보 동기화를 선택합니다.
작업이 대기열에 추가됩니다. 작업이 완료되면 구독 세부 정보가 업데이트됩니다.
구독 정보 보기
관리자라면 구독 상태를 확인할 수 있습니다.
- 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
- 구독을 선택합니다.
구독 페이지에는 다음과 같은 세부 정보가 포함됩니다.
- 라이선스 사용자
- 플랜
- 업로드된 날짜, 시작된 날짜, 만료되는 날짜
또한 다음 정보가 표시됩니다.
| 필드 | 설명 |
|---|---|
| 라이선스 사용자 수 | 시스템에 로드된 현재 라이선스의 유저 수. 현재 구독 기간 동안 좌석을 추가하지 않는 이상 수가 변경되지 않습니다. |
| 과금 가능한 사용자 | 시스템에서 과금 가능한 사용자의 일일 카운트. 블록하거나 비활성화하거나 사용자를 추가함에 따라 카운트가 변경될 수 있습니다. |
| 최대 사용자 수 | 시스템에서 라이선스 기간 동안의 과금 가능한 사용자 수. |
| 구독 이상 사용자 | 현재 라이선스 기간에 대한 최대 사용자 수 - 구독 사용자로 계산됩니다. 이 수는 갱신 전에 지불해야 하는 비용으로 후행적으로 청구됩니다.
|
라이선스 사용량 내보내기
관리자라면 라이선스 사용량을 CSV 파일로 내보낼 수 있습니다.
- 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
- 구독을 선택합니다.
- 오른쪽 상단 모서리에서 라이선스 사용량 파일 내보내기를 선택합니다.
이 파일에는 GitLab이 분기 맞춤 작업이나 갱신을 매뉴얼으로 처리하는 데 사용하는 정보가 포함됩니다. 인스턴스가 방화벽으로 보호되어 있거나 오프라인 환경이라면 이 정보를 GitLab에 제공해야 합니다.
라이선스 사용량 CSV에는 다음과 같은 세부 정보가 포함됩니다.
- 라이선스 키
- 라이선스 사용자 이메일
- 라이선스 시작일
- 라이선스 만료일
- 회사
- 생성된 날짜 (파일 내보내기가 된 시각)
- 기간 내 매일에 대한 사용자 수의 기록:
- 기록된 날짜
- 과금 가능한 사용자 수
구독 갱신
구독 만료 15일 전부터 구독을 갱신할 수 있습니다. 구독을 갱신하려면 다음을 수행하세요.
갱신을 위한 계정 검토 준비
고객 포털은 구독을 갱신하고 수정하는 도구입니다. 갱신을 계속하기 전에 로그인하여 지불 방법 섹션 아래의 신용카드와 회사 정보 섹션의 송장 연락처 세부 정보를 확인하거나 업데이트하세요.
정기적으로 사용자 계정을 검토하는 것이 중요합니다.
- 구식 사용자 계정은 과금 가능한 사용자로 간주될 수 있습니다. 너무 많은 사용자로 갱신하면 예상보다 더 많은 비용을 지불할 수 있습니다.
- 구식 사용자 계정은 보안 위협이 될 수 있습니다. 정기적인 검토는 이러한 위험을 줄이는 데 도움이 됩니다.
구독 이상 사용자
GitLab 구독은 특정 좌석 수에 대해 유효합니다. 구독 사용자보다 현재 구독 기간 동안의 최대 사용자 수가 큰 구독 이상 사용자 수입니다. 이 true up 프로세스라고도 불립니다.
구독 이상 사용자 수를 보려면 관리 영역으로 이동하세요.
구독 이상 사용자 예제
10명의 사용자에 대한 구독을 구매합니다.
| 이벤트 | 과금 가능한 사용자 | 최대 사용자 |
|---|---|---|
| 10명의 사용자가 10개 좌석을 모두 차지합니다. | 10 | 10 |
| 두 명의 새로운 사용자가 참여합니다. | 12 | 12 |
| 세 명의 사용자가 떠나고 계정이 차단됩니다. | 9 | 12 |
| 네 명의 새로운 사용자가 참여합니다. | 13 | 13 |
구독 이상 사용자 = 13 - 10 (최대 사용자 - 라이선스 사용자)
구독에 좌석 추가
구독 기간 중 언제든지 구독에 좌석을 추가하여 라이선스 사용자 수를 늘릴 수 있습니다. 구독 기간 중에 추가된 좌석의 비용은 구매일부터 구독 기간의 끝까지 비례해서 청구됩니다.
구독에 좌석을 추가하려면:
- 고객 포털에 로그인합니다.
- 구매 관리 페이지로 이동합니다.
- 해당 구독 카드에서 좌석 추가를 선택합니다.
- 추가 사용자 수를 입력합니다.
- 구매 요약 섹션을 검토합니다. 시스템에서는 시스템의 모든 사용자에 대한 총 가격과 이미 지불한 금액에 대한 크레딧을 나열합니다. 순 변동분만 청구됩니다.
- 지불 정보를 입력합니다.
- 좌석 구매를 선택합니다.
지불 영수증은 이메일로 발송되며, 고객 포털의 송장 보기에서도 확인할 수 있습니다.
만약 귀하의 구독이 활성화 코드로 활성화되었다면, 추가 좌석이 즉시 인스턴스에 반영됩니다. 라이선스 파일을 사용하는 경우에는 업데이트된 파일을 받게 됩니다. 좌석을 추가하려면, 라이선스 파일을 인스턴스에 추가하십시오.
구독 매뉴얼 갱신
구독 만료 30일 전부터 GitLab 사용자 인터페이스에서 관리자에게 만료 날짜가 표시되는 배너가 표시됩니다.
갱신 과정에서 다음 단계를 따라야 합니다.
- 갱신일 이전에 비활성화된 사용자를 차단하여 유휴 상태의 사용자를 정리합니다.
- 다가오는 구독에 사용자 증가가 필요한지 확인합니다.
-
고객 포털에 로그인하고 기존 구독 아래에서 갱신을 선택합니다. 갱신 버튼은 구독 만료 15일 전에만 표시됩니다. 구독 만료일 이전 15일보다 더 많은 날이 남았다면 구독 작업 ()을 선택한 후 구독 갱신을 선택하여 갱신할 수 있는 날짜를 확인하세요.
- 첫 번째 상자에 다가오는 연도에 필요한 총 사용자 라이선스 수를 입력합니다. 이 숫자는 갱신시점의 시스템의 과금 가능한 사용자 수와 동일하거나 초과해야 합니다.
- 이전 구독 기간 중 발생한 구독 이상 사용자 수를 두 번째 상자에 입력합니다.
- 갱신 세부 정보를 검토하고 지불 프로세스를 완료합니다.
- 갱신 기간의 활성화 코드는 해당 구독 카드에서 구매 관리 페이지에서 이용할 수 있습니다. 활성화 코드 복사를 선택하여 복사하세요.
- 인스턴스에 활성화 코드를 추가하세요.
갱신을 위해 송장이 생성되어 경영되며 이를 확인하거나 다운로드할 수 있습니다. 이 과정 중에 어려움이 있다면, 지원팀에 문의하십시오.
자동 구독 갱신
구독이 자동 갱신으로 설정되면 만료일(UTC 자정)에 자동으로 갱신되어 서비스 중단이 없습니다. Customers Portal을 통해 구매한 구독은 기본적으로 자동 갱신됩니다.
갱신 시점에서 사용자 라이선스 수는 현재 구독 수량보다 높다면 사용자 수에 맞게 조정됩니다. 자동 갱신하기 전에 갱신을 위해 최소한 갱신일로부터 2일 전에 갱신을 준비하여 변경 사항이 제때에 GitLab에 동기화되도록 해야 합니다. 구독을 자동 갱신하려면 구독 데이터 동기화를 활성화해야 합니다.
구독 갱신 청구서를 Customers Portal의 청구서 보기 페이지에서 볼 수 있으며 다운로드할 수 있습니다. 저장된 신용카드가 있는 경우, 해당 카드가 청구액으로 청구됩니다. 결제 처리 또는 자동 갱신이 다른 이유로 실패하는 경우 14일 내에 구독을 갱신해야 하며, 그 후 GitLab 티어가 다운그레이드됩니다.
이메일 알림
구독이 자동으로 갱신되기 15일 전에 갱신에 대한 정보가 포함된 이메일이 전송됩니다.
- 신용카드가 만료된 경우, 이메일에서 해당 업데이트 방법을 안내합니다.
- 미납 초과 또는 구독이 기타 이유로 자동 갱신할 수 없는 경우, 이메일에서 판매팀이나 Customers Portal에서 갱신하도록 지시합니다.
- 문제가 없는 경우, 이메일에 갱신되는 제품의 이름과 수량이 명시됩니다. 또한 사용량이 갱신 전에 증가 또는 감소하는 경우 이 금액이 변경될 수 있습니다.
자동 구독 갱신 활성화 또는 비활성화
이전 기간과 동일한 티어로 자동 구독 갱신을 보거나 변경하려면 Customers Portal에 로그인한 후 다음을 수행하세요.
- 구독 카드에
DATE 만료가 표시되면 구독이 자동으로 갱신되지 않습니다. 자동 갱신을 활성화하려면 구독 작업 ()에서 자동 갱신 켜기를 선택하세요. - 구독 카드에
DATE에 자동 갱신이 표시되면 구독이 구독 기간의 끝에서 자동으로 갱신됩니다. 자동 갱신을 취소하려면 구독 작업 ()에서 구독 취소를 선택하세요.
갱신 프로세스 중에 어려움이 있는 경우 지원팀에 문의하세요.
좌석을 줄여서 갱신
갱신할 좌석 수가 갱신 시점에서 청구 가능 사용자 수와 동일하거나 더 큰 경우, 구독을 좌석 수를 줄이면서 갱신할 수 있는 여러 옵션이 있습니다.
- 더 높은 좌석 수로 갱신되지 않도록 자동 갱신을 비활성화하세요.
- 구독 갱신일로부터 15일 이내에 매뉴얼으로 갱신하여 원하는 좌석 수를 지정하세요.
- 판매팀과 협력하여 구독을 갱신하세요.
구독 티어 업그레이드
GitLab 티어를 업그레이드하려면 다음을 수행하세요.
- Customers Portal에 로그인합니다.
- 관련 구독 카드에서 업그레이드를 선택합니다.
- 원하는 업그레이드를 선택합니다.
- 활성화되어 있는 결제 양식을 확인하거나 새 결제 양식을 추가합니다.
- 개인정보 보호 정책과 서비스 약관에 동의합니다 확인란을 선택합니다.
- 구매를 선택합니다.
다음이 이메일로 발송됩니다.
- 결제 영수증. 이 정보는 청구서 보기에서도 확인할 수 있습니다.
- 라이선스용 새 활성화 코드.
활성화 코드를 추가하여 새 라이선스가 활성화되면 새 티어가 적용됩니다.
구독의 연락처 추가 또는 변경
연락처는 구독을 갱신하거나 취소하거나 다른 네임스페이스로 구독을 양도할 수 있습니다.
다른 사람에게 Customers Portal 계정 소유권을 이전하려면 프로필 소유자 정보 변경을 참조하세요.
구독을 위한 보조 연락처를 추가하려면:
- 추가하려는 사용자를 위한 Customers Portal에 계정이 있는지 확인합니다.
- 요청에 관련 자료를 포함하여 지원팀과 티켓을 생성하세요.
구독 만료
라이선스가 만료되면 GitLab은 Git 푸시 및 이슈 생성과 같은 기능을 잠금 처리합니다. 그런 다음 인스턴스가 읽기 전용이 되고 모든 관리자에게 만료 메시지가 표시됩니다.
GitLab Self-Managed 인스턴스의 경우 이러한 상황이 발생하기 전에 14일의 유예 기간이 있습니다.
- 기능을 다시 활성화하려면 새 라이선스를 활성화합니다.
- 무료 기능으로 다시 돌아가려면 만료된 라이선스를 삭제합니다.
라이선스 파일 또는 키를 활성화
라이선스 파일 또는 키가 있는 경우 관리 영역에서 활성화할 수 있습니다.
지원 연락처
또한, GitLab 프로젝트의 프로젝트 트래커에서 알려진 문제 및 기존 기능 요청을 검색하는 것을 모든 사용자에게 장려합니다.
이러한 문제는 특정 제품 계획에 대한 업데이트 및 관련 GitLab 팀 구성원과 직접 의사 소통하는 가장 좋은 방법입니다.
리포지터리
Self-Managed 인스턴스의 저장 공간 및 전송량에는 애플리케이션 제한이 없습니다. 관리자는 기본 인프라 비용을 부담하고 리포지터리 크기 제한을 설정할 수 있습니다.
문제 해결
구독 데이터 동기화 실패
동기화 작업이 작동하지 않는 경우, GitLab 인스턴스에서 172.64.146.11:443 및 104.18.41.245:443 IP 주소로의 네트워크 트래픽을 허용하는지 확인하세요.
신용카드 거절
GitLab 구독을 구매할 때 신용카드가 거부된 경우, 가능한 이유는 다음과 같습니다.
- 제공된 신용카드 세부 정보가 올바르지 않음.
- 신용카드 계정에 충분한 자금이 없음.
- 가상 신용카드를 사용하고 자금이 부족하거나 만료됨.
- 거래가 신용 한도를 초과함.
- 거래가 신용 카드의 최대 트랜잭션 금액을 초과함.
이러한 이유가 해당되지 않는지 금융 기관과 확인하세요. 해당 사항이 없으면 GitLab 지원팀에 문의하세요.
매일과 과거의 청구 가능한 사용자 확인
관리자는 GitLab 인스턴스의 매일과 과거의 청구 가능한 사용자 디렉터리을 확인할 수 있습니다.
- Rails 콘솔 세션 시작.
-
인스턴스의 사용자 수를 계산하세요:
User.billable.count -
지난 1년 동안의 인스턴스에서의 최대 사용자 수를 확인하세요:
::HistoricalData.max_historical_user_count(from: 1.year.ago.beginning_of_day, to: Time.current.end_of_day)
일일과 과거 과금 사용자 업데이트
관리자는 GitLab 인스턴스에서 일일 및 과거 과금 사용자를 매뉴얼으로 업데이트할 수 있습니다.
- Rails 콘솔 세션을 시작합니다.
-
일일 과금 사용자를 강제로 업데이트합니다:
identifier = Analytics::UsageTrends::Measurement.identifiers[:billable_users] ::Analytics::UsageTrends::CounterJobWorker.new.perform(identifier, User.minimum(:id), User.maximum(:id), Time.zone.now) -
과거 최대 과금 사용자를 강제로 업데이트합니다:
::HistoricalDataWorker.new.perform
도움말