라이선스 숫자를 사용자별 기록과 대조한다
깃허브는 10월 15일 Code Quality 라이선스 사용 내역을 CSV로 내려받는 기능을 발표했다. 보고서는 라이선스를 소비하는 활성 커미터, 최근 90일 동안 해당 커미터의 커밋이 들어간 저장소, 단일 저장소나 조직에만 기여하는지 여부를 담는다. 제공 대상은 GitHub Team과 Enterprise Cloud다.
조직이나 기업의 청구 화면에 표시된 총수를 내부 인원·프로젝트 기록과 맞춰 볼 수 있는 변화다. 새 분석 모델이나 코드 탐지 규칙의 추가와는 다르다. 이미 Code Quality를 사용 중인 곳에서 어떤 활동이 라이선스에 연결되는지 구체화하는 관리 기능이다.
90일은 커밋 작성일보다 푸시 활동이 기준이다
공식 과금 문서는 Code Quality가 켜진 저장소에 최근 90일 안에 커미터의 커밋이 푸시되면 활성으로 본다고 설명한다. 커밋을 원래 언제 작성했는지는 이 판단의 기준이 아니다. 예전에 작성한 변경을 최근에 밀어 넣었다면 단순히 작성 날짜가 오래됐다는 이유로 비활성으로 볼 수 없다.
활성 커미터 한 명은 Code Quality 라이선스 하나를 사용하며 여러 저장소나 조직에 기여해도 조직·기업 전체 범위에서 중복을 제거한다. GitHub App 봇은 제외된다. 이 기준은 모든 자동화용 계정을 무조건 빼 준다는 뜻이 아니므로 사람 계정 형태로 운영하는 기계 계정까지 같은 예외로 취급해서는 안 된다.
한 저장소를 꺼도 라이선스가 남는 이유
이 보고서에서 중요한 항목은 특정 저장소나 조직에만 연결되는 고유 커미터다. 예를 들어 한 사람이 Code Quality가 켜진 두 저장소에 기여했다면, 한쪽을 꺼도 다른 쪽의 활동 때문에 라이선스가 계속 필요할 수 있다. 반면 해당 저장소에만 기여하는 커미터는 그 저장소의 기능을 끌 때 다음 기간의 조정 후보가 된다.
따라서 저장소별 인원 수를 단순히 더하거나 끈 저장소 수만큼 사용량이 줄 것으로 계산하면 안 된다. CSV를 프로젝트별 조직도와 연결하되, 중복 기여 관계와 기능이 켜진 범위를 함께 봐야 한다. 이 해석은 공식 중복 제거 및 고유 커미터 정의를 비용 검토에 적용한 것이다.
다운로드 위치와 접근 권한
보고서는 조직 또는 기업의 Billing and licensing에서 Licensing을 연 뒤 Code Quality 카드의 CSV 다운로드를 선택하면 된다. 공식 다운로드 안내는 클라우드 환경의 기업 소유자·조직 소유자·청구 관리자를 이용 주체로 명시한다. 일반 저장소 작업 권한과 청구 보고서 접근은 별개다.
다른 일부 라이선스 보고서가 계정 기본 이메일로 전달되는 것과 달리 Code Quality 보고서는 브라우저로 직접 내려받는다고 안내한다. 이 문서가 다른 제품의 서버용 다운로드와 API 경로도 함께 다룬다고 해서 이번 Code Quality CSV 기능의 제공 범위를 Enterprise Server나 별도 새 API까지 넓힐 근거는 없다.
라이선스 CSV가 전체 운영 비용은 아니다
Code Quality 비용은 커미터 라이선스 외에도 스캔 실행에 쓰이는 GitHub Actions 분과 AI 기능의 크레딧으로 나뉜다. 셀프호스티드 러너를 쓰는 경우 Actions 과금 조건은 다르다. AI 크레딧은 Code Quality 전용 별도 지급량이 아니라 다른 AI 제품과 공유하는 풀에서 소비한다. 라이선스 인원만 맞췄다고 전체 지출이 맞아떨어지는 구조는 아니다.
비용 관리 가이드는 저장소·조직별 전체 사용량을 보려면 별도의 청구 사용량 보고서를, Code Quality의 AI 소비 추이는 AI 사용 화면에서 Product로 묶어 보라고 안내한다. 라이선스 CSV는 누가 좌석을 소비하는지 설명하고, 다른 보고서는 스캔과 AI 사용이 얼마인지 설명한다. 각 자료의 단위를 맞춰 비교해야 한다.
현재 청구와 다음 기간의 조정을 나눈다
Code Quality를 저장소에서 끄면 해당 저장소의 스캔과 AI 사용은 즉시 멈춘다. 그러나 현재 청구 기간의 커미터 라이선스 요금이 줄어드는 것은 아니다. 그 저장소에만 연결된 커미터의 라이선스를 다음 기간에 확보할 수 있다는 것이 공식 안내다. 사용 중단과 현재 금액 환급을 같은 효과로 계산해서는 안 된다.
운영팀은 CSV에서 고유 커미터가 있는 저활용 저장소를 찾은 뒤, 분석을 중단해도 되는지 개발·보안 담당과 판단할 수 있다. 절감 후보는 사용 내역에서 찾되 실제 적용 범위는 코드 품질 관리 필요와 함께 결정해야 한다. 이번 기능의 가치는 비용을 자동으로 낮추는 데 있지 않고 조정의 근거를 사용자와 저장소 단위로 확인할 수 있게 한 데 있다.
출처
GitHub Changelog의 원출처와 본문에 표시한 참고자료를 바탕으로 한국어로 재구성했습니다. ‘ARCH.B 분석’은 자료를 읽고 덧붙인 편집 해석입니다.
Download GitHub Code Quality license usage as a CSV (새 창)
